---
title: "ノーコードワークフローハンドオフ"
description: "Twexapi MCP エージェント結果を n8n、Zapier、Make、Pipedream へ移す。"
---

多くのノーコードプラットフォームは MCP セッション自体を実行する必要はありません。信頼できるパターンは、MCP 対応エージェントでデータを収集し、構造化 JSON をワークフローにハンドオフすることです。

## 前提条件

- Twexapi API キー
- `https://api.twexapi.io/mcp` に接続した MCP 対応エージェントまたはフレームワーク
- n8n、Zapier、Make、Pipedream、または社内ワークフローランナーからの webhook URL
- Sheets、Airtable、Notion、Slack、CRM、データベースなどの宛先

## 推奨フロー

1. **MCP 対応エージェントで収集**

    Claude Code、Cursor、Codex CLI、LangChain、Pydantic AI などを `https://api.twexapi.io/mcp` に接続。

2. **厳密な JSON を返す**

    ID、カーソル、ルート名、行を含む安定スキーマをエージェントに要求。

3. **ノーコードツールへ送信**

    JSON を n8n、Zapier、Make、Pipedream、または社内ランナーの webhook に POST。

4. **必要なら REST で継続**

    スケジュールや大量ジョブは `Authorization: Bearer YOUR_API_KEY` で Twexapi REST を直接呼び出し。

## コピペ用エージェントプロンプト

```txt
Use Twexapi MCP to search recent X/Twitter posts about "AI agents".
Call explore first, then twexapi_request.
Return only valid JSON with:
{
  "route_used": "...",
  "query": "AI agents",
  "has_more": true,
  "next_cursor": "...",
  "tweets": [
    {
      "tweet_id": "...",
      "author_username": "...",
      "created_at": "...",
      "text": "...",
      "like_count": 0,
      "reply_count": 0,
      "retweet_count": 0
    }
  ]
}
Do not call write endpoints.
```

## ワークフローマッピング

| JSON field | Common destination |
| --- | --- |
| `tweet_id` | DB 主キー、重複排除キー、CRM メモ参照 |
| `author_username` | CRM アカウントフィールド、Slack メッセージラベル |
| `created_at` | ソートキー、レポートタイムスタンプ |
| `next_cursor` | 次回スケジュール実行用ワークフロー状態 |
| `route_used` | 監査ログ、デバッグフィールド |

## 結果ハンドオフ

ワークフローペイロードは小さく安定させましょう。別途アーカイブしない限り、生レスポンス全体を Slack、CRM、スプレッドシート行に渡さないでください。

| Row type | Required fields |
| --- | --- |
| Tweet search | `tweet_id`, `text`, `author_username`, `created_at`, `public_url`, `route_used` |
| Profile lookup | `user_id`, `username`, `name`, `description`, `followers_count`, `verified` |
| Trend rows | `name`, `rank`, `query`, requested `country`, requested `topic` |
| Pagination | `has_more`, `next_cursor`, original query or source ID |
| Write plan | `action`, `endpoint`, `preview`, `requires_human_confirmation` |

## レシピ: エージェントリサーチ → webhook

1. AI エージェントを Twexapi MCP に接続。
2. 上記プロンプトで厳密 JSON を要求。
3. JSON をワークフロー webhook に POST。
4. ワークフローツールのイテレータ/ループで `tweets` を処理。
5. `tweet_id` で upsert。

## レシピ: スケジュール継続

日次ジョブでは初回をエージェント支援、以降を決定的に:

1. `route_used`、リクエストパラメータ、`next_cursor` を保存。
2. スケジュール呼び出しは `Authorization: Bearer YOUR_API_KEY` で Twexapi REST。
3. `has_more` が false または行上限到達で停止。
4. エンドポイントやクエリ変更が必要なときだけエージェントに例外を戻す。

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

- webhook が Markdown ではなく有効 JSON を受信すること。
- `tweet_id` または `user_id` で重複排除すること。
- `next_cursor` がチャット履歴外に永続化されること。
- 書き込みは人間承認までプランとして表現されること。
- API キー、cookie、auth token がユーザー可視宛先に送られないこと。