Google Search Console MCP

Google Search Console MCP

Google Search Console 用の読み取り専用 MCP サーバーです。読み取り操作を網羅する 5 つのツールを備えています。プロパティ、Search Analytics（フィルター、25,000 行の上限を超える自動ページネーション、時間単位のデータ）、サイトマップ、URL 検査、スロットリング付きの一括検査に対応します。すべての SEO クライアント向けに、このサーバーを本番環境で運用しています。

インストール

Claude Code：

claude mcp add gsc -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json -- uvx scalably-gsc-mcp

Codex：

codex mcp add gsc --env GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json -- uvx scalably-gsc-mcp

Claude Desktop：最新の GitHub リリースから gsc-mcp.mcpb をダウンロードして開きます。

セットアップ

1. Google Cloud でプロジェクトを作成または選択し、そのプロジェクトで Google Search Console API を有効にします（「API とサービス」、「ライブラリ」）。
2. そのプロジェクトでサービスアカウントを作成し、JSON キーをダウンロードします。
3. クエリ対象の各 Search Console プロパティで、サービスアカウントのメールアドレスをユーザーとして追加します（「設定」、「ユーザーと権限」）。読み取りには、完全な権限と制限付き権限のどちらも使用できます。

OAuth 同意画面は不要です。サーバーは webmasters.readonly スコープを使用して、サービスアカウントとして認証します。

ツール（5）

ツール	機能
gsc_list_sites	サービスアカウントが読み取り可能な Search Console プロパティを一覧表示します
gsc_query_search_analytics	フィルター、自動ページネーション、時間単位のデータを使用して Search Analytics をクエリします
gsc_list_sitemaps	プロパティのサイトマップを一覧表示するか、1 つのサイトマップを読み取ります
gsc_inspect_url	1 つの URL のインデックス登録状況を検査します
gsc_batch_inspect_urls	クライアント側のスロットリングで複数の URL を検査します

設定

変数	必須	用途
GOOGLE_APPLICATION_CREDENTIALS	はい	Search Console の読み取り専用スコープが設定された Google サービスアカウントの JSON ファイルへのパス。各プロパティをサービスアカウントのメールアドレスと共有してください
GSC_LOG_LEVEL	いいえ	INFO（デフォルト）または DEBUG
GSC_RETRY_BASE_SECONDS	いいえ	一時的な API エラーに対するリトライのバックオフで使用する基本待機時間（秒）（デフォルトは 1）
GSC_WEBMASTERS_BASE, GSC_SEARCHCONSOLE_BASE	いいえ	2 つの Google API ベース URL を上書きします（テストスイートでローカルの偽 API を指定するために使用します。通常の使用では未設定のままにしてください）
GSC_TEST_ACCESS_TOKEN	いいえ	テストスイート専用：サービスアカウントを使わずに認証する、文字列形式のベアラートークンです。通常の使用では絶対に設定しないでください

応答の形式

すべてのツールは、status（succeeded、partial、no_op）、operation、summary、target、result、proof、warnings、recovery を含む JSON を返します。失敗は、テキストが <code>: <message> <hint> 形式のツールエラーとして表されます。proof.nextStartRow を含む partial ステータスの場合は、その行から続行してください。

制限

Search Analytics の 1 回の呼び出しにつき 25,000 行までです（サーバーは max_rows まで自動でページネーションします）。URL 検査の上限は、Google によりプロパティごとに 1 分あたり 600 件、1 日あたり 2,000 件と定められています。サーバーはクライアント側で一括検査のリクエスト速度を調整し（デフォルトは 1 秒あたり 8 リクエスト）、一括処理が 1 日の上限を超える場合に警告します。呼び出しをまたいだ 1 日あたりの使用量は追跡しないため、各自で件数を管理してください。

検証

各リリースでは、パッケージのバージョン、.mcpb の sha256、派生元となった本番環境のコミットを CHANGELOG.md に記載しています。CI では、プッシュのたびにテストと、ビルドした wheel のクリーンインストールを実行します。

プライバシーポリシー

このサーバーは、各自の認証情報を使用して、各自のマシン上でローカルに実行されます。個人データを収集せず、テレメトリーを含まず、永続的なデータを保存せず、ラップ対象のベンダー API とのみ通信します。Scalably を含む第三者がデータを受け取ることはありません。お問い合わせ先：[email protected]。正式版：https://scalably.io/connector-privacy.html

ライセンス

MIT。著作権は Scalably に帰属します。