X (Twitter)

X API を使ってポスト投稿、ユーザープロフィール取得、ツイート検索を行う

​

概要

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

​

主な機能

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

​

認証

X API を使用するには、X Developer Platform にて開発者アカウントを作成し、API キーを発行する必要があります。リクエストを認証するために、以下のキーが必要です：

• consumer_key
• consumer_secret
• access_token
• access_token_secret

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

​

ツール

​

X_POST

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

入力:

パラメータ	型	必須	説明
tweet_text	string	はい	ポスト内容（最大280文字）
image_base64	string	いいえ	Base64エンコードされた画像
image_extension	string	いいえ	画像ファイル拡張子（jpg、pngなど）

出力:

フィールド	型	説明
tweet_id	string	投稿されたツイートのID
url	string	ポストのURL
created_at	string	ツイート作成タイムスタンプ

​

X_GET_USER_PROFILE

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

入力:

• username (文字列): 検索するユーザー名（@マーク不要）

出力:

フォロワー数、プロフィール、認証ステータスなどのユーザープロフィール情報。

​

X_SEARCH_TWEETS

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

入力:

パラメータ	型	必須	説明
query	string	はい	検索クエリ
max_results	number	いいえ	最大結果数
result_type	string	いいえ	結果タイプ: recent、popular、mixed

出力:

検索条件に一致するツイートの配列。

​

X_GET_TWEETS

ID で特定のツイートを取得します。

入力:

• tweet_ids (配列, 必須): 取得するツイートIDの配列

出力:

詳細情報を含むツイートオブジェクトの配列。

​

使用例

​

例：ポストを投稿する

- 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 からこんにちは！🚀"
    - name: image_base64
      value: ""
    - name: image_extension
      value: jpg

​

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

- id: get_profile
  tool: X_GET_USER_PROFILE
  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: username
      value: "jinbaflow_JP"

​

例：ツイートを検索する

- id: search_tweets
  tool: X_SEARCH_TWEETS
  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: query
      value: "ワークフロー自動化"
    - name: max_results
      value: 20
    - name: result_type
      value: "popular"

​

用途

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