zyte-api-automation

Rube MCP経由のZyte API自動化

ComposioのZyte APIツールキットをRube MCP経由で使用して、Zyte APIの操作を自動化します。

ツールキットドキュメント: composio.dev/toolkits/zyte_api

前提条件

• Rube MCPが接続されていること（RUBE_SEARCH_TOOLS が利用可能）
• RUBE_MANAGE_CONNECTIONS を使用し、ツールキット zyte_api でアクティブなZyte API接続が設定されていること
• 常に最初に RUBE_SEARCH_TOOLS を呼び出して最新のツールスキーマを取得すること

セットアップ

Rube MCPの入手: クライアント設定で https://rube.app/mcp をMCPサーバーとして追加します。APIキーは不要で、エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCPが利用可能であることを確認します
2. ツールキット zyte_api を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続がACTIVEでない場合は、返された認証リンクに従ってセットアップを完了します
4. ワークフローを実行する前に、接続ステータスがACTIVEであることを確認します

ツールの発見

ワークフローを実行する前に、常に利用可能なツールを発見します。

RUBE_SEARCH_TOOLS
queries: [{use_case: "Zyte API operations", known_fields: ""}]
session: {generate_id: true}

これにより、利用可能なツールスラッグ、入力スキーマ、推奨実行計画、既知の落とし穴が返されます。

コアワークフローパターン

ステップ1: 利用可能なツールを発見

RUBE_SEARCH_TOOLS
queries: [{use_case: "your specific Zyte API task"}]
session: {id: "existing_session_id"}

ステップ2: 接続を確認

RUBE_MANAGE_CONNECTIONS
toolkits: ["zyte_api"]
session_id: "your_session_id"

ステップ3: ツールを実行

RUBE_MULTI_EXECUTE_TOOL
tools: [{
  tool_slug: "TOOL_SLUG_FROM_SEARCH",
  arguments: {/* 検索結果からスキーマに準拠した引数 */}
}]
memory: {}
session_id: "your_session_id"

既知の落とし穴

• 常に最初に検索: ツールスキーマは変更されます。RUBE_SEARCH_TOOLS を呼び出さずにツールスラッグや引数をハードコードしないでください。
• 接続を確認: ツールを実行する前に、RUBE_MANAGE_CONNECTIONS がACTIVEステータスを示していることを確認してください。
• スキーマ準拠: 検索結果から得られた正確なフィールド名と型を使用してください。
• メモリパラメータ: RUBE_MULTI_EXECUTE_TOOL の呼び出しには、空でも良いので常に memory を含めてください（例：{}）。
• セッションの再利用: 1つのワークフロー内ではセッションIDを再利用してください。新しいワークフローには新しいIDを生成します。
• ページネーション: レスポンスにページネーショントークンがないか確認し、すべてのデータを取得するまで継続して取得してください。

クイックリファレンス

操作	アプローチ
ツールの検索	Zyte API固有のユースケースを指定して RUBE_SEARCH_TOOLS
接続	ツールキット zyte_api を指定して RUBE_MANAGE_CONNECTIONS
実行	発見したツールスラッグを使用して RUBE_MULTI_EXECUTE_TOOL
一括操作	run_composio_tool() を使用して RUBE_REMOTE_WORKBENCH
完全スキーマ	schemaRef を持つツールに対して RUBE_GET_TOOL_SCHEMAS

---

Powered by Composio