n8n
TwexAPI 経由で n8n Twitter ワークフローを構築し、ツイート検索、ユーザー参照、トレンドツイート、AI エージェント、カーソル安全なハンドオフを実現する。
TwexAPI で n8n Twitter ワークフローを構築します。ツイート検索、ユーザー参照、トレンドツイート読み取り、AI エージェント実行が可能です。この連携は TwexAPI コミュニティノード、HTTP Request、Webhook、MCP Client Tool ノードを使用します。
TwexAPI は1つの API キーと REST ベース URL https://api.twexapi.io を使用します。
n8n Twitter 連携を選択
TwexAPI コミュニティノード
@twexapi-dev/n8n-nodes-x-api-scraper をインストールし、ツイート検索、ユーザー検索、プロフィール参照、トレンドツイート、残高確認を利用。
HTTP Request + MCP
ドキュメント化された REST ルートには HTTP Request を使用。AI エージェントが先にエンドポイントを発見する場合は MCP Client Tool を使用。
前提条件
- TwexAPI API キー
- n8n Cloud またはセルフホスト n8n
- 以下レシピ用のオプション: Slack と Google Sheets 認証情報
コミュニティノードのインストール
Settings → Community Nodes から @twexapi-dev/n8n-nodes-x-api-scraper をインストールします。
npm install @twexapi-dev/n8n-nodes-x-api-scraper
ソース: twexapi-dev/n8n-nodes-x-api-scraper
サポートされる操作
| Task | n8n operation | TwexAPI route |
|---|---|---|
| ツイート検索 | Tweet: search | POST /twitter/advanced_search/page |
| ユーザー検索 | User: search | GET /twitter/search-user/{keyword}/{target_count} |
| プロフィール参照 | User: get | GET /twitter/{screen_name}/about |
| トレンドツイート読み取り | Trend: get | GET /twitter/global-trending/tweets |
| 残高確認 | Account: get balance | GET /balance |
フォロワーページネーション、リスト、コミュニティ、承認済み投稿には REST API を使用してください。TwexAPI はネイティブアカウントモニターまたはイベント webhook を公開していません。定期ジョブにはスケジュール REST 呼び出しまたはノーコードプラットフォーム webhook を使用してください。
API キー認証情報
TwexAPI 用の再利用可能 n8n 認証情報を作成します。
認証と認可
TwexAPI API 認証情報または HTTP Request 認証情報で Header Auth を選択。
ヘッダー名
ヘッダー名を Authorization に設定。
ヘッダー値
認証情報値として Bearer YOUR_API_KEY を貼り付け。
https://api.twexapi.io を呼び出すすべての HTTP Request ノードでその認証情報を使用してください。
MCP 対応 AI Agent ノードでは、MCP Client Tool を https://api.twexapi.io/mcp とヘッダー x-api-key: YOUR_API_KEY で設定してください。
結果ハンドオフ
次のノードが安定ハンドオフフィールドのみ必要な場合、各 HTTP Request または TwexAPI ノードの後に Edit Fields ノードを使用してください。Slack メッセージ、Sheets 行、リトライキューから生レスポンスを除外してください。
ツイート検索ページ
リクエストクエリを保存。各ツイート id, text, 著者ユーザー名, created_at を tweet_id, text, author_username, created_at にマップ。ページループ用に has_next_page と next_cursor を保持。
ユーザープロフィールデータ
ソース id を user_id として保存。username, name, フォロワー数、ルックアップまたは検索入力も保存。
トレンドデータ
各トレンド名、トピック、コンテンツタグ、国を保存。要求リージョンをワークフロー実行と一緒に保持。
ツイート投稿・返信
書き込みアクションには保存済み cookie または auth_token が必要。n8n から投稿前に CLI --dry-run でプレビュー。
レシピ 1: MCP による AI エージェント X リサーチ
TwexAPI と AI エージェントを連携するレシピです。エージェントはライブツイート検索、トレンド要約、プロフィール確認、フォロワー活動比較が可能です。
AI エージェントノードを追加
好みのチャットモデルで AI Agent ワークフローを作成。
MCP クライアントツールを追加
Server Transport を HTTP Streamable に設定。MCP Endpoint URL を https://api.twexapi.io/mcp に設定。Authentication を Header Auth(名前 x-api-key、TwexAPI API キー)に設定。
エージェントにプロンプトを設定
エージェントに先に explore、次に twexapi_request を呼び出し、JSON のみを返すよう指示。
推奨エージェントシステムプロンプト:
Use TwexAPI for every X research request. Call explore before twexapi_request. Search tweets, inspect accounts, and cite the returned post URLs. Prefer small, targeted searches before broad exports.
ユーザープロンプト例:
Find recent posts about AI agents in fintech, group them by theme, and list 5 accounts worth monitoring.
Return only JSON with route_used, tweets, has_more, and next_cursor.
MCP サーバーは発見用に explore、認証済み呼び出し用に twexapi_request を公開します。
レシピ 2: ツイート検索から Slack
TwexAPI コミュニティノードまたは HTTP Request でツイートを検索し、Slack チャンネルにアラートします。
ワークフロー構成
スケジュールまたは手動トリガー
スケジュールまたはテスト中は手動実行。
ツイートを検索
TwexAPI ノードまたは HTTP Request で POST /twitter/advanced_search/page を呼び出し。
行を分割
返されたツイートで Split Out。
アラートを送信
整形テキストを Slack に送信。
HTTP Request 例
{
"method": "POST",
"url": "https://api.twexapi.io/twitter/advanced_search/page",
"headers": {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
"body": {
"searchTerms": ["AI agents lang:en"],
"sortBy": "Latest",
"nextCursor": ""
}
}
Slack メッセージ
Slack の前に Set ノードを使用:
@{{$json.author_username || $json.user?.screen_name}}
{{$json.text || $json.full_text}}
https://x.com/i/web/status/{{$json.tweet_id || $json.id}}
レシピ 3: 検索結果から Google Sheets
チームがスプレッドシートでツイート検索結果を必要とする場合に使用します。
ワークフロー構成
スケジュールトリガー
日次または時間ごとにエクスポート。テスト中は手動実行。
ツイートを検索
TwexAPI ノードまたは HTTP Request でツイート検索し next_cursor を保存。
行を分割
返されたツイートで Split Out。
行を追加
以下のマップ結果フィールドで Google Sheets Append Row を使用。
Google Sheets にマップするフィールド:
ツイート ID
id または tweet_id にマップ。
投稿者
著者ユーザー名またはスクリーン名にマップ。
テキスト本文
text または full_text にマップ。
作成日時
created_at または createdAt にマップ。
URL
https://x.com/i/web/status/{id} から構築。
大規模ジョブでは has_next_page または has_more が true の間ループし、next_cursor を検索ボディに渡し続けます。
便利な REST アクション
ツイートを検索
POST /twitter/advanced_search/page で X クエリ検索を実行。
ユーザープロフィールを取得
GET /twitter/{screen_name}/about で X プロフィールを取得。
フォロワーを取得
POST /v3/twitter/users/followers でフォロワーリストを読み取り。
トレンドを取得
GET /twitter/global-trending/tweets でグローバルトレンドツイートを読み取り。
ツイートを作成
POST /twitter/tweets/create でテキストまたはメディア投稿を公開。
DM 送信
POST /v3/twitter/send-dm で DM を送信。
テストチェックリスト
- 各 HTTP Request または TwexAPI ノードで n8n Test Step アクションを使用。
- すべての REST リクエストに
Authorization: Bearer YOUR_API_KEYが含まれることを確認。 - すべての MCP Client Tool リクエストに
x-api-keyが含まれることを確認。 - ページネーションジョブでは各ページ後に
next_cursorを保存。 429時はリトライ前に待機し、カーソルを保持。
n8n Twitter 自動化に関する質問
TwexAPI 経由で n8n を Twitter に接続するには?
TwexAPI コミュニティノードをインストールするか、Authorization: Bearer YOUR_API_KEY の Header Auth を作成。すべての TwexAPI リクエストで選択。
n8n Twitter 検索はどのように動作しますか?
コミュニティノードまたは HTTP Request 経由で POST /twitter/advanced_search/page を呼び出し。各ページのクエリとカーソルを保存。
n8n から Twitter に投稿できますか?
はい。POST /twitter/tweets/create 経由。書き込みアクションには cookie または auth_token が必要。まず CLI でペイロードをプレビュー。
n8n Twitter エージェントを構築できますか?
はい。n8n Twitter エージェントは https://api.twexapi.io/mcp の MCP 経由でツイート、プロフィール、トレンドを検索可能。
セルフホスト n8n で TwexAPI を使用できますか?
はい。https://api.twexapi.io への outbound HTTPS を許可。
次のステップ
- 厳密な JSON ハンドオフパターンは Agent MCP Handoff を参照。
- 書き込みアクションの dry-run プレビューは CLI を参照。
- AI Agent ワークフロー構築時は MCP Tools を使用。