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

ノーコードワークフローハンドオフ

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

  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 がユーザー可視宛先に送られないこと。

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