クライアントを接続する
まずキーを環境変数QUERYING_API_KEY に設定してください。キーは APIキー で取得できます。
- Claude Code
- Codex
- mcp.json
401 を返します。無効なキーは、最初のツール呼び出しでツールエラーとして報告されます。
ツール
タスクを送信するツールは、同じAPI呼び出しと同じ料金がかかります。読み取り専用のツールは無料です。タスクとリサーチ
run_prompt と submit_prompt は taskType、prompt と、任意の country、idempotencyKey、include、page(1から10、GOOGLE_SERP と NAVER_SERP 用)を受け取ります。エンジンと料金はエンジン、リサーチの入力は Prompt Research を参照してください。
COMMERCE_SERP では prompt の代わりに site と query を送り、limit(1から40)は任意です。Commerce Search を参照してください。read_product は url と、任意の country、idempotencyKey を受け取ります。Commerce Product を参照してください。
run_product_lookup は product、country と、任意の competitors、prompts、engines、idempotencyKey を受け取ります。入力は Product Lookup を参照してください。既定の応答は要約です。商品ごとに表示したエンジン、価格帯、販売店と引用サイトの上位10件、エンジン別の比較行を、ショッピングプロンプトごとにエンジン別に表示または言及された商品を含みます。全体の応答の約10分の1です。すべてのリスティング、引用ページ、タスクidが必要なら detail: "full" を渡してください。
GEOモニター
各モニターツールはあなたのキーでAPIを1回呼び出すため、所有権、キーの範囲、プランの上限はRESTと同じく適用されます。GEOモニタリングを参照してください。タイムアウト
run_prompt、scrape_page、read_product、research_prompts はタスクが終了するまでポーリングします。待機時間は timeoutSeconds(既定値180、最大900)です。タスクがまだ実行中なら、ツールは taskId を含む TASK_TIMEOUT エラーを返します。タスクは実行を続けるため、そのidで get_task を呼び出して結果を受け取ってください。
run_product_lookup も同じようにポーリングします。240秒のクライアントタイムアウト内に終わるよう既定で210秒待ち、ほとんどのルックアップは2〜3分で終わります。まだ実行中なら、ツールは lookupId を含む LOOKUP_TIMEOUT エラーを返します。そのidで get_product_lookup を呼び出してください。
クライアントのツールタイムアウトは timeoutSeconds より長く設定してください。Codex の例では、既定の180秒に対して tool_timeout_sec = 240 を使っています。クライアントが短いツール呼び出ししか許さない場合は、submit_prompt の後に get_task を使ってください。