コンテンツにスキップ
Twexapi
日本語
Esc
移動開く⌘Jプレビュー
このページの内容

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 ステップを使用します。

ツイート検索ページ

クエリを保存。各ツイート idtweet_id にマップし、text、著者ユーザー名、created_at もマップ。has_next_pagenext_cursor を保持。

ユーザープロフィールデータ

ソース iduser_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 ステップ:

  1. Catch Hook が JSON ペイロードを受信。
  2. tweets をループまたは line-item 処理。
  3. 空行をフィルター。
  4. 著者、本文、URL 付き Slack メッセージを送信。

レシピ 2: スケジュールツイート検索から Google Sheets

  1. Zap を日次または時間ごとにスケジュール。
  2. HTTP Request が POST /twitter/advanced_search/page を呼び出し。
  3. 返されたツイートをループ。
  4. tweet_id, 著者, 本文, created_at, 構築 URL を Sheets に追加。
  5. 後続 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 を保存。
  • 最終本文が人間に承認されるまで書き込みアクションはドラフトのまま保持。

次のステップ

このページは役に立ちましたか?