メインコンテンツへスキップ

​
概要

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 (文字列, 必須): ポスト内容（最大280文字）
  • image_base64 (文字列, オプション): Base64エンコードされた画像
  • image_extension (文字列, オプション): 画像ファイル拡張子（jpg、pngなど）
出力:
  • tweet_id: 投稿されたツイートのID
  • url: ポストのURL
  • created_at: ツイート作成タイムスタンプ

​
X_GET_USER_PROFILE

X からユーザープロフィール情報を取得します。 入力:
  • username (文字列): 検索するユーザー名（@マーク不要）
出力:
  • フォロワー数、プロフィール、認証ステータスなどのユーザープロフィール情報

​
X_SEARCH_TWEETS

特定のクエリを使ってツイートを検索します。 入力:
  • query (文字列, 必須): 検索クエリ
  • max_results (数値, オプション): 最大結果数
  • result_type (文字列, オプション): 結果タイプ（“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"

​
用途

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