ノーコードワークフローハンドオフ
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、データベースなどの宛先
推奨フロー
MCP 対応エージェントで収集
Claude Code、Cursor、Codex CLI、LangChain、Pydantic AI などを https://api.twexapi.io/mcp に接続。
厳密な JSON を返す
ID、カーソル、ルート名、行を含む安定スキーマをエージェントに要求。
ノーコードツールへ送信
JSON を n8n、Zapier、Make、Pipedream、または社内ランナーの webhook に POST。
必要なら REST で継続
スケジュールや大量ジョブは Authorization: Bearer YOUR_API_KEY で Twexapi REST を直接呼び出し。
コピペ用エージェントプロンプト
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
- AI エージェントを Twexapi MCP に接続。
- 上記プロンプトで厳密 JSON を要求。
- JSON をワークフロー webhook に POST。
- ワークフローツールのイテレータ/ループで
tweetsを処理。 tweet_idで upsert。
レシピ: スケジュール継続
日次ジョブでは初回をエージェント支援、以降を決定的に:
route_used、リクエストパラメータ、next_cursorを保存。- スケジュール呼び出しは
Authorization: Bearer YOUR_API_KEYで Twexapi REST。 has_moreが false または行上限到達で停止。- エンドポイントやクエリ変更が必要なときだけエージェントに例外を戻す。
テストチェックリスト
- webhook が Markdown ではなく有効 JSON を受信すること。
tweet_idまたはuser_idで重複排除すること。next_cursorがチャット履歴外に永続化されること。- 書き込みは人間承認までプランとして表現されること。
- API キー、cookie、auth token がユーザー可視宛先に送られないこと。