Zapier
TwexAPI 経由で Zapier Twitter 自動化を構築し、ツイート検索、ユーザー参照、トレンドツイート、プラットフォーム webhook、カーソル安全なハンドオフを実現する。
TwexAPI で Zapier Twitter 自動化を構築します。ツイート検索、ユーザー参照、トレンドツイート読み取り、行を Slack、Sheets、Airtable、HubSpot、メールにルーティングできます。TwexAPI は1つの API キーと REST ベース URL https://api.twexapi.io を使用します。
Zapier 連携パターンを選択
Community node + MCP agent
発見用に MCP 対応エージェントを使用し、厳密な JSON を Zapier Catch Hook に POST。
HTTP リクエストアクション
Webhooks by Zapier またはプライベート連携から TwexAPI REST を直接呼び出し。
n8n スタイルのコミュニティノード
チームがすでに n8n を運用している場合は専用 n8n コミュニティノード を推奨。
Zapier ネイティブ X アプリは廃止されました。TwexAPI は Catch Hook、HTTP Request、またはプライベート Zapier アプリ経由で引き続き利用可能です。
前提条件
- TwexAPI API キー
- Webhooks by Zapier 付き Zapier アカウント
- オプション: Slack、Google Sheets、Airtable、HubSpot、Gmail 送信先
- オプション:
https://api.twexapi.io/mcpに接続された MCP 対応エージェント
API キー認証
TwexAPI REST 呼び出し用の再利用可能認証情報を作成します。
認証と認可
HTTP Request で Header Auth またはカスタムヘッダーを選択。
ヘッダー名
ヘッダー名を Authorization に設定。
ヘッダー値
認証情報値として Bearer YOUR_API_KEY を貼り付け。
Zapier 外の MCP 対応 AI Agent ステップでは、x-api-key: YOUR_API_KEY ヘッダーで https://api.twexapi.io/mcp を設定してください。
連携構成
Catch Hook を作成
Webhooks by Zapier を使用し、エージェントハンドオフまたは外部 POST 用に Catch Hook を選択。
TwexAPI レコードを収集
MCP、HTTP Request、または外部ワーカーで厳密な JSON を生成。
安定フィールドをマッピング
tweet_id を重複排除キーとして使用。本文、著者、URL、カーソルフィールドをマップ。
ターゲット先へルーティング
行を Slack、Sheets、Airtable、HubSpot、メールに送信。
スターターアクション
一般的な読み取りには HTTP Request またはプライベート Zapier アプリを使用します。
ツイートを検索
searchTerms, sortBy, nextCursor 付き POST /twitter/advanced_search/page。
ユーザープロフィールを取得
GET /twitter/{screen_name}/about
ユーザーを検索
GET /twitter/search-user/{keyword}/{target_count}
トレンドを取得
国、トピック、コンテンツフィルター付き GET /twitter/global-trending/tweets。
フォロワーを取得
ユーザー名とカーソルページネーション付き POST /v3/twitter/users/followers。
ツイートを作成
人間の承認と cookie 設定後 POST /twitter/tweets/create。
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": ""
}
}
結果ハンドオフ
次の Zap ステップが安定ハンドオフフィールドのみ必要な場合、Formatter または Code ステップを使用します。
ツイート検索ページ
クエリを保存。各ツイート id を tweet_id にマップし、text、著者ユーザー名、created_at もマップ。has_next_page と next_cursor を保持。
ユーザープロフィールデータ
ソース id を user_id として保存。username, name, フォロワー数、ルックアップ入力も保存。
トレンドデータ
国、トピック、コンテンツタグ、ワークフロー実行メタデータ付きツイート行を保存。
ツイート投稿・返信
Zapier から投稿前に CLI --dry-run でプレビュー。書き込みアクションには cookie または auth_token が必要。
レシピ 1: MCP エージェントリサーチから Slack
推奨 MCP エージェントプロンプト:
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.
Each tweet must include tweet_id, author_username, text, created_at, and public_url.
Do not call write endpoints.
Zap ステップ:
- Catch Hook が JSON ペイロードを受信。
tweetsをループまたは line-item 処理。- 空行をフィルター。
- 著者、本文、URL 付き Slack メッセージを送信。
レシピ 2: スケジュールツイート検索から Google Sheets
- Zap を日次または時間ごとにスケジュール。
- HTTP Request が
POST /twitter/advanced_search/pageを呼び出し。 - 返されたツイートをループ。
tweet_id, 著者, 本文,created_at, 構築 URL を Sheets に追加。- 後続 Zap がページネーションを継続する場合、Storage by Zapier に
next_cursorを保存。
レシピ 3: トレンドツイートアラート
{
"method": "GET",
"url": "https://api.twexapi.io/twitter/global-trending/tweets",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
},
"query": {
"country": "United States",
"topic": "Sports",
"content": "NFL",
"count": 20
}
}
エンゲージメントでフィルター後、要約テキストを Slack またはメールにルーティング。
エラー処理
| Status | Zap behavior |
|---|---|
400 |
停止し、リクエストマッピングを修正。 |
401 |
Zap を失敗させ、運用に API キー差し替えをアラート。 |
403 |
アカウントアクセスまたはクレジット修正まで一時停止。 |
429 |
遅延し、Zapier 組み込みリプレイでリトライ。 |
5xx |
慎重にリトライ。カーソルを保持。 |
プライベート連携ブループリント
TwexAPI をプライベート Zapier 連携としてパッケージ化する場合、小さく信頼性の高いサーフェスから開始:
| リソース | アクション |
|---|---|
| Tweets | ツイート検索、ツイート詳細取得、承認後ツイート作成 |
| Users | ユーザー取得、ユーザー検索 |
| Trends | グローバルトレンドツイート取得 |
| Followers | フォロワー v3 ページ取得 |
パッケージ化アクションには REST、エージェント駆動発見ワークフローには MCP を使用してください。
テストチェックリスト
- 実際の TwexAPI ハンドオフペイロードで Catch Hook をテスト。
- すべての REST リクエストに
Authorization: Bearer YOUR_API_KEYが含まれることを確認。 - 送信先アプリ書き込み前に
tweet_idを重複排除キーとして使用。 - フォローアップ Zap 用に Storage by Zapier に
next_cursorを保存。 - 最終本文が人間に承認されるまで書き込みアクションはドラフトのまま保持。
次のステップ
- チームが TwexAPI コミュニティノードを好む場合は n8n
- ビジュアルシナリオルーティングには Make
- Agent MCP Handoff
- Advanced Twitter Search