---
title: "Zapier"
description: "TwexAPI 経由で Zapier Twitter 自動化を構築し、ツイート検索、ユーザー参照、トレンドツイート、プラットフォーム webhook、カーソル安全なハンドオフを実現する。"
---

TwexAPI で Zapier Twitter 自動化を構築します。ツイート検索、ユーザー参照、トレンドツイート読み取り、行を Slack、Sheets、Airtable、HubSpot、メールにルーティングできます。TwexAPI は1つの API キーと REST ベース URL `https://api.twexapi.io` を使用します。

## Zapier 連携パターンを選択

<CardGroup cols={2}>
  <Card title="Community node + MCP agent" icon="bot">
    発見用に MCP 対応エージェントを使用し、厳密な JSON を Zapier Catch Hook に POST。
  </Card>

  <Card title="HTTP リクエストアクション" icon="link">
    Webhooks by Zapier またはプライベート連携から TwexAPI REST を直接呼び出し。
  </Card>

  <Card title="n8n スタイルのコミュニティノード" icon="plug">
    チームがすでに n8n を運用している場合は専用 [n8n コミュニティノード](/guides/n8n) を推奨。
  </Card>
</CardGroup>

Zapier ネイティブ X アプリは廃止されました。TwexAPI は Catch Hook、HTTP Request、またはプライベート Zapier アプリ経由で引き続き利用可能です。

## 前提条件

* [TwexAPI API キー](https://twexapi.io/dashboard)
* Webhooks by Zapier 付き Zapier アカウント
* オプション: Slack、Google Sheets、Airtable、HubSpot、Gmail 送信先
* オプション: `https://api.twexapi.io/mcp` に接続された MCP 対応エージェント

## API キー認証

TwexAPI REST 呼び出し用の再利用可能認証情報を作成します。

<CardGroup cols={3}>
  <Card title="認証と認可" icon="key-round">
    HTTP Request で Header Auth またはカスタムヘッダーを選択。
  </Card>

  <Card title="ヘッダー名" icon="braces">
    ヘッダー名を `Authorization` に設定。
  </Card>

  <Card title="ヘッダー値" icon="shield-check">
    認証情報値として `Bearer YOUR_API_KEY` を貼り付け。
  </Card>
</CardGroup>

Zapier 外の MCP 対応 AI Agent ステップでは、`x-api-key: YOUR_API_KEY` ヘッダーで `https://api.twexapi.io/mcp` を設定してください。

## 連携構成

1. **Catch Hook を作成**

    Webhooks by Zapier を使用し、エージェントハンドオフまたは外部 POST 用に Catch Hook を選択。

2. **TwexAPI レコードを収集**

    MCP、HTTP Request、または外部ワーカーで厳密な JSON を生成。

3. **安定フィールドをマッピング**

    `tweet_id` を重複排除キーとして使用。本文、著者、URL、カーソルフィールドをマップ。

4. **ターゲット先へルーティング**

    行を Slack、Sheets、Airtable、HubSpot、メールに送信。

## スターターアクション

一般的な読み取りには HTTP Request またはプライベート Zapier アプリを使用します。

<CardGroup cols={2}>
  <Card title="ツイートを検索" icon="search">
    `searchTerms`, `sortBy`, `nextCursor` 付き `POST /twitter/advanced_search/page`。
  </Card>

  <Card title="ユーザープロフィールを取得" icon="user-round">
    `GET /twitter/{screen_name}/about`
  </Card>

  <Card title="ユーザーを検索" icon="users">
    `GET /twitter/search-user/{keyword}/{target_count}`
  </Card>

  <Card title="トレンドを取得" icon="trending-up">
    国、トピック、コンテンツフィルター付き `GET /twitter/global-trending/tweets`。
  </Card>

  <Card title="フォロワーを取得" icon="users">
    ユーザー名とカーソルページネーション付き `POST /v3/twitter/users/followers`。
  </Card>

  <Card title="ツイートを作成" icon="send">
    人間の承認と cookie 設定後 `POST /twitter/tweets/create`。
  </Card>
</CardGroup>

### HTTP Request 例: ツイート検索

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

<CardGroup cols={2}>
  <Card title="ツイート検索ページ" icon="search">
    クエリを保存。各ツイート `id` を `tweet_id` にマップし、`text`、著者ユーザー名、`created_at` もマップ。`has_next_page` と `next_cursor` を保持。
  </Card>

  <Card title="ユーザープロフィールデータ" icon="users">
    ソース `id` を `user_id` として保存。`username`, `name`, フォロワー数、ルックアップ入力も保存。
  </Card>

  <Card title="トレンドデータ" icon="trending-up">
    国、トピック、コンテンツタグ、ワークフロー実行メタデータ付きツイート行を保存。
  </Card>

  <Card title="ツイート投稿・返信" icon="send">
    Zapier から投稿前に [CLI](/sdks/cli) `--dry-run` でプレビュー。書き込みアクションには cookie または `auth_token` が必要。
  </Card>
</CardGroup>

## レシピ 1: MCP エージェントリサーチから Slack

推奨 MCP エージェントプロンプト:

```text
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: トレンドツイートアラート

```json
{
  "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](/guides/n8n)
* ビジュアルシナリオルーティングには [Make](/guides/make)
* [Agent MCP Handoff](/mcp/agent-handoff)
* [Advanced Twitter Search](/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post)