X (Twitter) - jinba

概要

X（Twitter）ツールを使用すると、X プラットフォームの API を介してポストの投稿、ユーザープロフィールの取得、ツイートの検索、特定のツイート情報の取得など、包括的なソーシャルメディア統合機能を提供します。

主な機能

X_POST: 自分の X アカウントにポストを投稿
X_GET_USER_PROFILE: ユーザープロフィール情報を取得
X_SEARCH_TWEETS: クエリを使ってツイートを検索
X_GET_TWEETS: ID や条件で特定のツイートを取得

認証

X API を使用するには、X Developer Platform にて開発者アカウントを作成し、API キーを発行する必要があります。

X_POST は OAuth 1.0a のユーザーコンテキスト認証情報（config）を使用します：consumer_key、consumer_secret、access_token、access_token_secret
X_GET_USER_PROFILE、X_SEARCH_TWEETS、X_GET_TWEETS はアプリ専用 OAuth 2.0 の Bearer トークン（config）を使用します：bearer_token

注意：API キーは機密情報として扱い、公開リポジトリにコミットしないでください。

ツール

X_POST

X アカウントにポストを投稿します。入力:

パラメータ	型	必須	説明
`tweet_text`	string	はい	ポストするテキスト

出力:

フィールド	型	説明
`tweet.id`	string	投稿されたポストのID
`tweet.text`	string	投稿されたポストのテキスト

X_GET_USER_PROFILE

X からユーザープロフィール情報を取得します。入力:

username（string、必須）: 検索するユーザー名（@マーク不要）

出力: id、username、name に加え、取得可能な場合は description、location、url、verified、followers_count、following_count、tweet_count、created_at、profile_image_url を含む user オブジェクト。

X_SEARCH_TWEETS

特定のクエリを使ってツイートを検索します。入力:

パラメータ	型	必須	説明
`query`	string	はい	検索クエリ
`count`	number	いいえ	取得するツイート数（1〜100、デフォルト: 10）
`result_type`	string	いいえ	結果タイプ: `recent`、`popular`、`mixed`（デフォルト: `recent`）
`include_entities`	boolean	いいえ	ハッシュタグ・メンション・URL などのエンティティを含める（デフォルト: `false`）

出力: tweets 配列。各ツイートは id、text、created_at、author に加え、任意で public_metrics（retweet_count、like_count、reply_count）と entities（hashtags、mentions、urls）を含みます。

X_GET_TWEETS

指定したユーザーのタイムラインから最近のツイートを取得します。入力:

パラメータ	型	必須	説明
`username`	string	はい	ユーザー名（@マーク不要）
`count`	number	いいえ	取得するツイート数（1〜100、デフォルト: 10）
`include_replies`	boolean	いいえ	返信を結果に含める（デフォルト: `false`）
`include_retweets`	boolean	いいえ	リポストを結果に含める（デフォルト: `false`）

出力: tweets 配列。各ツイートは id、text、created_at、author（username、name）に加え、任意で public_metrics（retweet_count、like_count、reply_count）を含みます。

使用例

例：ポストを投稿する

- id: post_tweet
  tool: X_POST
  config:
    - name: consumer_key
      value: "{{secrets.TWITTER_CONSUMER_KEY}}"
    - name: consumer_secret
      value: "{{secrets.TWITTER_CONSUMER_SECRET}}"
    - name: access_token
      value: "{{secrets.TWITTER_ACCESS_TOKEN}}"
    - name: access_token_secret
      value: "{{secrets.TWITTER_ACCESS_TOKEN_SECRET}}"
  input:
    - name: tweet_text
      value: "Jinba Flow からこんにちは！🚀"

例：ユーザープロフィールを取得する

- id: get_profile
  tool: X_GET_USER_PROFILE
  config:
    - name: bearer_token
      value: "{{secrets.TWITTER_BEARER_TOKEN}}"
  input:
    - name: username
      value: "jinbaflow_JP"

例：ツイートを検索する

- id: search_tweets
  tool: X_SEARCH_TWEETS
  config:
    - name: bearer_token
      value: "{{secrets.TWITTER_BEARER_TOKEN}}"
  input:
    - name: query
      value: "ワークフロー自動化"
    - name: count
      value: 20

例：ユーザーのツイートを取得する

- id: get_tweets
  tool: X_GET_TWEETS
  config:
    - name: bearer_token
      value: "{{secrets.TWITTER_BEARER_TOKEN}}"
  input:
    - name: username
      value: "jinbaflow_JP"
    - name: count
      value: 10
    - name: include_retweets
      value: false

用途

ソーシャルメディアの自動化とスケジューリング
ソーシャルリスニングとブランド監視
顧客エンゲージメントとサポート
コンテンツ拡散とマーケティング
リアルタイムトレンド分析
コミュニティ管理

​概要

​主な機能

​認証

​ツール

​X_POST

​X_GET_USER_PROFILE

​X_SEARCH_TWEETS

​X_GET_TWEETS

​使用例

​例：ポストを投稿する

​例：ユーザープロフィールを取得する

​例：ツイートを検索する

​例：ユーザーのツイートを取得する

​用途

概要