Google Search Console

Google Search Console MCP Server — gsc-mcp-full

Google Search Console 向けの完全な MCP サーバーです。 Claude、Cursor、Windsurf、VS Code、Codex など、あらゆる MCP クライアントに、検索パフォーマンス、インデックス登録、サイトマップについて自然な言葉で質問できます。スプレッドシートではなく、分析結果が得られます。

37 個のツール · Search Console API の全エンドポイント · 24 時間表示と時間単位のデータ · 16 か月を超える履歴 · あらゆる言語で正確な数値

クイックスタート · ツール · 言語 · FAQ · ドキュメント全文 · プロジェクトページ

対応環境： Claude Desktop · Claude Code · Cursor · Windsurf · VS Code（Copilot エージェントモード）· OpenAI Codex CLI · stdio または HTTP 経由のあらゆる MCP クライアント。

ツール

8つのグループに37個のツールがあります。自分で呼び出す必要はありません。自然な言葉で依頼すれば、AI が適切なツールを選びます。

🌍 表記の違いを統合 · 🗄️ ローカルの履歴で実行可能（任意の日付範囲）· ✍️ 書き込みアクセスが必要（GSC_ALLOW_WRITE=1）

📊 検索パフォーマンス

🎯 SEO の機会

🌍 多言語インテリジェンス

🗄️ 無制限の履歴

🔍 インデックス登録と URL の検査

🗺️ サイトマップ

🏠 プロパティ

🛠️ ユーティリティ

各ツールのすべてのパラメーターについては、ツールリファレンスを参照してください。

クイックスタート

3 ステップ、所要時間は約 10 分、費用はかかりません。Search Console にアクセスできる Google アカウントが必要です。

1. Google 認証情報を作成する

Search Console を読み取るアプリはすべて Google に識別される必要があるため、無料の「OAuth クライアント」を一度作成します。

1. Google Cloud Console を開き、プロジェクトを作成します（名前は自由です）。
2. プロジェクトで Google Search Console API を有効にします。
3. 認証情報 を開き、認証情報を作成 → OAuth クライアント ID を選択します。確認画面の入力を求められた場合は、まず設定します。種類は 外部、アプリ名は自由に入力し、自分のメールアドレスを指定します。
4. デスクトップアプリ を選択して作成し、JSON をダウンロードします。ファイルは ~/gsc/client_secret.json のように、永続的に保存できる場所に保管します。
5. 確認画面のページで アプリを公開 をクリックします。これを行わないと、Google から 7 日ごとにサインアウトされます。個人利用であれば審査は不要です。

2. AI クライアントを接続する

uv がまだインストールされていない場合は、インストールします（ページに記載されたコマンドを 1 つ実行します）。uv がサーバーをダウンロードして実行するため、ほかにインストールするものはありません。

次に、自分のファイルへのパスを指定して、以下をクライアントの MCP 設定に追加します。

{
  "mcpServers": {
    "search-console": {
      "command": "uvx",
      "args": ["gsc-mcp-full"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/Users/you/gsc/client_secret.json"
      }
    }
  }
}

claude mcp add search-console -e GSC_CREDENTIALS_PATH=/Users/you/gsc/client_secret.json -- uvx gsc-mcp-full

[mcp_servers.search-console]
command = "uvx"
args = ["gsc-mcp-full"]

[mcp_servers.search-console.env]
GSC_CREDENTIALS_PATH = "/Users/you/gsc/client_secret.json"

3. サインインして質問する

ターミナルから一度サインインします。ブラウザーが開くので、Search Console のプロパティにアクセスできる Google アカウントを選択してください。

export GSC_CREDENTIALS_PATH=~/gsc/client_secret.json
uvx gsc-mcp-full auth      # sign in (if Google warns the app is unverified: Advanced → Continue — it's your own app)
uvx gsc-mcp-full doctor    # should list your properties

AI クライアントを再起動して、次のように質問します。

Search Console のプロパティを一覧表示してから、example.com のパフォーマンス概要を教えてください。

行き詰まった場合は、トラブルシューティングをご覧ください。

任意の設定として、env ブロックに追加する価値がある項目です。現地の日付でレポートする場合は "GSC_TIMEZONE": "Europe/Berlin"、クエリの大半が 1 つの言語の場合は "GSC_LANG": "fa"（または ar、tr、ja など）を指定します。pip を使いたい場合は、pip install gsc-mcp-full を実行すると同じ gsc-mcp-full コマンドを利用できます。

質問例

• 「example.com の週次 SEO レポートを作成してください。概要、変化した点、最も有望な機会を 3 つ教えてください。」
• 「先月からクリック数が 30% 以上減少したページと、それらのページで減少したクエリを教えてください。」
• 「キーワードのカニバリゼーションを見つけ、それぞれどのページを優先すべきか教えてください。」
• 「検索結果の 1 ページ目に表示されているページのうち、クリック率が低いものはどれですか？より良いタイトルを提案してください。」
• 「この 20 個の URL にインデックス登録の問題がないか確認してください。」
• 「トラフィックをブランドと非ブランドに分けてください。ブランド用語：toyota、تویوتا。」
• 「16 か月分の履歴を同期してから、'boiler' を含むクエリの月ごとのクリック数を表示してください。」

その他のプロンプトとすぐに使えるワークフローについては、使用ガイドをご覧ください。

言語

Search Console では、異なる文字列はそれぞれ別のクエリとしてカウントされます。同じ検索語を複数の方法で入力できる場合、1 つのキーワードが複数の少量データの行に分かれてしまいます。

🌍 のマークが付いたツールは、分析前にこれらを統合します。ルールは各文字体系に合わせて定められています。表示されるテキストは変更されず、グループ化のみが変わります。統合には 2 つのレベルがあります。標準では同じ単語の異なる入力方法を統合し、ゆるい統合ではさらに、表記が近いものも統合します。

26 の文字体系が認識されます。英語のみのサイトでも、英字の大小、区切り記号、スペースの違いが統合されるため、データが失われることはありません。ただし、c++、c#、.net は別々に扱われ、3.5 が 35 として扱われることもありません。

中国語、日本語、タイ語では、エクストラをインストールすると、top_terms は実際の単語分割ツールを使用します。uvx --from "gsc-mcp-full[zh]" gsc-mcp-full を実行してください（または [ja]、[th]、[all]）。すべてのルールの背景については、言語ガイドをご覧ください。

16 か月を超える履歴

Google は 16 か月を過ぎると Search Console のデータを削除し、1 回のリクエストで取得できる行数にも上限を設けています。sync_history は日ごとのデータをローカルの SQLite ファイルに保存するため、使い始めた日からこの両方の制限が適用されなくなります。

uvx gsc-mcp-full sync example.com --days 480     # first run: everything Google still has
uvx gsc-mcp-full sync example.com --days 7       # daily, from cron: only new days are fetched

🗄️ のマークが付いたツールはすべて source="history" を受け付けます。詳細と cron の例については、履歴ガイドをご覧ください。

設定

設定は、クライアントの env ブロックに指定する環境変数です。最初の項目のみ必須です。

コマンドライン

gsc-mcp-full                    # run the server — what your AI client starts
gsc-mcp-full auth [--force]     # sign in with Google
gsc-mcp-full doctor             # check setup and list properties
gsc-mcp-full sync SITE --days N # store history locally
gsc-mcp-full serve --transport streamable-http --port 8000   # serve over HTTP instead of stdio
gsc-mcp-full tools              # print the tool reference

セキュリティ

• 指定がない限り読み取り専用です。 デフォルトのサインインでは Search Console の内容を変更できません。
• すべてのデータはお使いのマシン内に保管されます。 サーバーはローカルで動作し、Google とのみ通信します。サインイン情報は、ご本人だけが読み取れるファイルに保存され、ログに記録されることはありません。
• 書き込みツールは GSC_ALLOW_WRITE=1 でロック解除され、呼び出しのたびにチェックされます。
• 検索クエリはデータとして扱われます。 Google には誰でも任意の内容を入力でき、データ内の情報がアクションを引き起こすことはありません。

詳しくはセキュリティガイドをご覧ください。脆弱性を非公開で報告するには、SECURITY.mdをご覧ください。

よくある質問

Google Search Console の公式 MCP サーバーはありますか？ 執筆時点（2026 年 10 月）ではありません。Google は Google Analytics 用の MCP サーバーを公開していますが、Search Console 用は公開していません。そのため、このサーバーのようなコミュニティ製サーバーは、Google の公開 Search Console API を使用しています。

無料で使えますか？ はい。このサーバーは MIT ライセンスのオープンソースで、Search Console API は無料で利用でき、Google Cloud プロジェクトに請求先アカウントは必要ありません。

どの AI アシスタントで使えますか？ stdio またはストリーミング可能な HTTP 経由で、Claude Desktop、Claude Code、Cursor、Windsurf、エージェントモードの VS Code、OpenAI Codex CLI など、あらゆる MCP クライアントで使えます。

サイトを変更したり、壊したりすることはありますか？ いいえ。Search Console のレポートを読み取ります。書き込みアクセスを有効にすると、Search Console でプロパティの追加や削除、サイトマップの送信や削除ができますが、ウェブサイト自体には何も行いません。

スプレッドシートにエクスポートする場合とどう違いますか？ 質問すると、回答が返ってきます。サーバーはデータを取得し、表記の揺れを統合して分析を実行し、短い表を返します。AI のコンテキストがデータであふれないよう、行数には上限が設けられています。

Search Console の最新のレポートオプションに対応していますか？ 24 時間表示（予備データを含む毎時のデータポイント）と、毎時、毎日、毎週、毎月の粒度に対応しています。hours=24 を指定した hourly_performance と、performance_overview および history_trend の granularity をご利用ください。ウェブ検索をテキストベースとマルチモーダル（Google Lens、Circle to Search）に分ける新しい機能は Search Console の UI でのみ利用できます。Google の API はまだこのデータを返さないため、どの MCP サーバーでも利用できません。

ページのインデックス登録、Core Web Vitals、リンクのレポートに対応していますか？ いいえ。Google はこれらのレポートを API 経由で提供していないため、どの MCP サーバーでも利用できません。URL ごとのインデックス登録状況は、検査ツールで確認できます。

データはどれくらい前までさかのぼれますか？ Google から取得できるデータは 16 か月分です。履歴のローカル同期を開始すれば、期間の制限はありません。

Python の知識は必要ですか？ いいえ。すべて uvx が実行するため、設定ファイルを 1 つ編集するだけです。

開発

git clone https://github.com/mamrrez/gsc-mcp-full && cd gsc-mcp-full
uv venv && uv pip install -e ".[dev,all]"
uv run pytest        # no network or credentials needed
uv run ruff check
uv run python scripts/live_check.py   # optional: read-only check of every tool against your own property

言語ルールや実際のクエリのサンプルをはじめ、コントリビューションを歓迎します。詳しくはCONTRIBUTING.mdをご覧ください。

関連プロジェクト

• gtrends-mcp-full — Google Trends の関連 MCP サーバーです。Trending Now、時間別・地域別の関心度、関連検索、季節性、検索シェアを API キーなしで確認できます。

ライセンス

MIT © Mohammadreza Hasanpour

このプロジェクトは Google とは無関係であり、Google の承認を受けていません。Google Search Console は Google LLC の商標です。