Search Consoleを任意のMCPクライアントに接続する

エンドポイント

サーバーはアプリドメインの/mcpにあり、プロトコルバージョン2025-06-18のStreamable HTTPで通信します。クライアントはJSON-RPCをPOSTし、initializeリクエストを送信してからtools/listを呼び出します。インストールは不要で、ローカルプロキシを経由することもありません。

• Authorization: Bearer に、apk_live_ に続けて32桁の16進文字を付けたキーを指定します
• キーは作成時に一度だけ表示され、保存時はSHA-256ハッシュとしてのみ保持されます
• 呼び出しのたびに、キーの最終使用日時とリクエストカウンターが更新されます

ツール

機能別にグループ化し、モデルが適切なツールを選べるよう名前を明確にしています。読み取り専用キーでは、書き込みやリサーチクレジットを消費するツールには届きません。

• 検出:list_properties、search_analytics
• パフォーマンス:top_queries、top_pages、top_countries、compare_periods
• 診断:content_decay、cannibalization、ctr_benchmark、page_poaching、rank_changes、new_lost_rankings
• インデックス:url_inspection、sitemaps
• タイムライン:annotations、および書き込みキーで使えるcreate_annotation
• アナリティクス:ga4_overview、ga4_breakdown、ga4_key_events
• リサーチ：キーワード、SERP、被リンク、順位トラッキング、サイト監査（リサーチクレジットを消費）
• コンテンツエンジン：content_list_tasks、content_claim、content_get_brief、content_submit、content_publish、カバー用ツール。キューから執筆できます

日付は省略可能

どのツールでも期間を指定しなければ、Search Consoleのレポート遅延を考慮したうえで直近28日間の確定済みデータが使用され、比較期間はデフォルトで同じ長さの直前の期間になります。クライアント側が今日の日付を把握していなくても、意味のある質問ができます。

スコープとレート制限

キーは読み取り専用または読み書き可能のいずれかです。読み取り専用キーは書き込みツールに一切アクセスできず、読み書き可能キーによる変更操作はすべて監査ログに記録されます。

• キーごとに1分あたり60リクエスト、アカウントごとに1時間あたり1,000リクエスト
• 上限を超えるとHTTP 429が返され、Retry-Afterに秒数が示されます
• アカウントの他の部分に影響を与えずに、キーを個別に失効できます

お好みならRESTも

Search ConsoleとGA4のツールは、/v1配下のGETおよびPOSTルートとしても公開されており、/v1/openapi.jsonに生成されたOpenAPI 3.1ドキュメントがあります。これは関数呼び出し用の仕様としても使えます。キー、スコープ、制限は同じです。