---
title: "n8n"
description: "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 連携を選択

<CardGroup cols={2}>
  <Card title="TwexAPI コミュニティノード" icon="plug">
    `@twexapi-dev/n8n-nodes-x-api-scraper` をインストールし、ツイート検索、ユーザー検索、プロフィール参照、トレンドツイート、残高確認を利用。
  </Card>

  <Card title="HTTP Request + MCP" icon="workflow">
    ドキュメント化された REST ルートには HTTP Request を使用。AI エージェントが先にエンドポイントを発見する場合は MCP Client Tool を使用。
  </Card>
</CardGroup>

## 前提条件

* [TwexAPI API キー](https://twexapi.io/dashboard)
* n8n Cloud またはセルフホスト n8n
* 以下レシピ用のオプション: Slack と Google Sheets 認証情報

## コミュニティノードのインストール

**Settings → Community Nodes** から `@twexapi-dev/n8n-nodes-x-api-scraper` をインストールします。

```bash
npm install @twexapi-dev/n8n-nodes-x-api-scraper
```

ソース: [twexapi-dev/n8n-nodes-x-api-scraper](https://github.com/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](/api-reference/overview) を使用してください。TwexAPI はネイティブアカウントモニターまたはイベント webhook を公開していません。定期ジョブにはスケジュール REST 呼び出しまたはノーコードプラットフォーム webhook を使用してください。

## API キー認証情報

TwexAPI 用の再利用可能 n8n 認証情報を作成します。

<CardGroup cols={3}>
  <Card title="認証と認可" icon="key-round">
    TwexAPI API 認証情報または HTTP Request 認証情報で Header Auth を選択。
  </Card>

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

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

`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 行、リトライキューから生レスポンスを除外してください。

<CardGroup cols={2}>
  <Card title="ツイート検索ページ" icon="search">
    リクエストクエリを保存。各ツイート `id`, `text`, 著者ユーザー名, `created_at` を `tweet_id`, `text`, `author_username`, `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">
    書き込みアクションには保存済み cookie または `auth_token` が必要。n8n から投稿前に [CLI](/sdks/cli) `--dry-run` でプレビュー。
  </Card>
</CardGroup>

## レシピ 1: MCP による AI エージェント X リサーチ

TwexAPI と AI エージェントを連携するレシピです。エージェントはライブツイート検索、トレンド要約、プロフィール確認、フォロワー活動比較が可能です。

1. **AI エージェントノードを追加**

    好みのチャットモデルで AI Agent ワークフローを作成。

2. **MCP クライアントツールを追加**

    Server Transport を `HTTP Streamable` に設定。MCP Endpoint URL を `https://api.twexapi.io/mcp` に設定。Authentication を Header Auth（名前 `x-api-key`、TwexAPI API キー）に設定。

3. **エージェントにプロンプトを設定**

    エージェントに先に `explore`、次に `twexapi_request` を呼び出し、JSON のみを返すよう指示。

推奨エージェントシステムプロンプト:

```text
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.
```

ユーザープロンプト例:

```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.
```

MCP サーバーは発見用に `explore`、認証済み呼び出し用に `twexapi_request` を公開します。

## レシピ 2: ツイート検索から Slack

TwexAPI コミュニティノードまたは HTTP Request でツイートを検索し、Slack チャンネルにアラートします。

### ワークフロー構成

<CardGroup cols={2}>
  <Card title="スケジュールまたは手動トリガー" icon="calendar-clock">
    スケジュールまたはテスト中は手動実行。
  </Card>

  <Card title="ツイートを検索" icon="search">
    TwexAPI ノードまたは HTTP Request で `POST /twitter/advanced_search/page` を呼び出し。
  </Card>

  <Card title="行を分割" icon="split">
    返されたツイートで Split Out。
  </Card>

  <Card title="アラートを送信" icon="message-square">
    整形テキストを Slack に送信。
  </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": ""
  }
}
```

### Slack メッセージ

Slack の前に Set ノードを使用:

```text
@{{$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

チームがスプレッドシートでツイート検索結果を必要とする場合に使用します。

### ワークフロー構成

<CardGroup cols={2}>
  <Card title="スケジュールトリガー" icon="calendar-clock">
    日次または時間ごとにエクスポート。テスト中は手動実行。
  </Card>

  <Card title="ツイートを検索" icon="search">
    TwexAPI ノードまたは HTTP Request でツイート検索し `next_cursor` を保存。
  </Card>

  <Card title="行を分割" icon="split">
    返されたツイートで Split Out。
  </Card>

  <Card title="行を追加" icon="file-spreadsheet">
    以下のマップ結果フィールドで Google Sheets Append Row を使用。
  </Card>
</CardGroup>

Google Sheets にマップするフィールド:

<CardGroup cols={2}>
  <Card title="ツイート ID" icon="hash">
    `id` または `tweet_id` にマップ。
  </Card>

  <Card title="投稿者" icon="at-sign">
    著者ユーザー名またはスクリーン名にマップ。
  </Card>

  <Card title="テキスト本文" icon="type">
    `text` または `full_text` にマップ。
  </Card>

  <Card title="作成日時" icon="calendar">
    `created_at` または `createdAt` にマップ。
  </Card>

  <Card title="URL" icon="link">
    `https://x.com/i/web/status/{id}` から構築。
  </Card>
</CardGroup>

大規模ジョブでは `has_next_page` または `has_more` が true の間ループし、`next_cursor` を検索ボディに渡し続けます。

## 便利な REST アクション

<CardGroup cols={2}>
  <Card title="ツイートを検索" icon="search">
    `POST /twitter/advanced_search/page` で X クエリ検索を実行。
  </Card>

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

  <Card title="フォロワーを取得" icon="users">
    `POST /v3/twitter/users/followers` でフォロワーリストを読み取り。
  </Card>

  <Card title="トレンドを取得" icon="trending-up">
    `GET /twitter/global-trending/tweets` でグローバルトレンドツイートを読み取り。
  </Card>

  <Card title="ツイートを作成" icon="send">
    `POST /twitter/tweets/create` でテキストまたはメディア投稿を公開。
  </Card>

  <Card title="DM 送信" icon="message-circle">
    `POST /v3/twitter/send-dm` で DM を送信。
  </Card>
</CardGroup>

## テストチェックリスト

* 各 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](/sdks/cli) でペイロードをプレビュー。

### n8n Twitter エージェントを構築できますか？

はい。n8n Twitter エージェントは `https://api.twexapi.io/mcp` の MCP 経由でツイート、プロフィール、トレンドを検索可能。

### セルフホスト n8n で TwexAPI を使用できますか？

はい。`https://api.twexapi.io` への outbound HTTPS を許可。

## 次のステップ

* 厳密な JSON ハンドオフパターンは [Agent MCP Handoff](/mcp/agent-handoff) を参照。
* 書き込みアクションの dry-run プレビューは [CLI](/sdks/cli) を参照。
* AI Agent ワークフロー構築時は [MCP Tools](/mcp/tools) を使用。