Google Search Console MCP server for SEOs

SEO担当者向け Google Search Console MCP サーバー

Google Search Console（GSC）を AI アシスタントに接続し、自然言語での会話を通じて SEO データを分析できる Model Context Protocol（MCP）サーバーです。Claude Desktop、Cursor、Codex CLI、Gemini CLI、Antigravity、およびその他の MCP 対応クライアントで動作します。

セットアップを省略して、さらに活用しましょう。 より高機能なホスト型バージョンです。ワンクリックでサインインでき、GA4 ツールも追加されています。Claude Desktop、Claude Code、Claude.ai、Codex、Cursor、およびあらゆる MCP クライアントで動作します。100 席限定です。 → Advanced GSC MCP（ホスト型）

---

新着情報

[0.4.1] — 2026年9月

• check_indexing_issues が並行実行されるようになりました — #31 と同じ修正により、sc-domain:* プロパティに対する10件の URL バッチでタイムアウトしなくなりました。 @kuldiph に感謝します。（#55）
• get_search_by_page_query に残っていた不要な orderBy を削除しました（Search Analytics API では無視されるため）。 @kuldiph に感謝します。（#55）

[0.4.0] — 2026年9月

• リッチリザルトの問題が表示されるようになりました — inspect_url_enhanced と batch_url_inspection が正しい API パスからリッチリザルトの問題を取得するようになり、マークアップの問題が黙って破棄されず、報告されるようになりました。 @patrickweh に感謝します。（#46、#48）
• batch_url_inspection が並行実行されるようになりました — sc-domain:* プロパティに対する10件の URL バッチでタイムアウトしなくなりました。 @remotesensei に感謝します。（#31）
• compare_search_periods の差分を修正しました — 期間1が分析対象期間、期間2がベースラインになり、増加が減少ではなく増加として表示されます。 @JKdreaming に感謝します。（#42）
• get_advanced_search_analytics の並べ替えが機能するようになりました — sort_by／sort_direction が無視されず、適用されるようになりました。 @kuldiph に感謝します。（#54）
• エラーハンドリングを強化しました — 致命的なシグナルが握りつぶされないよう、裸の except: 節を置き換えました。 @kuldiph に感謝します。（#53）
• 注： batch_url_inspection では、リッチリザルトの判定と区別できるよう、URLごとの verdict フィールド名が index_verdict に変更されます。

[0.3.3] — 2026年7月

• mcp 2.0 が原因で新規インストールが壊れる問題を修正しました — mcp[cli]<2.0.0 に固定しました。mcp SDK 2.0.0（2026-07-28 リリース）で mcp.server.fastmcp モジュールが削除されたため、新規の uvx mcp-search-console インストールはすべて、起動時に ModuleNotFoundError: No module named 'mcp.server.fastmcp' でクラッシュしていました。新規インストールでは、再び動作する 1.x SDK が解決されるため、--with "mcp<2" による回避策は不要です。

[0.3.2] — 2026年4月

• uvx での OAuth ブラウザーフローを修正しました — macOS で MCP サブプロセスとして実行した際にブラウザーのログインウィンドウが開かなくなる isatty のブロックを削除しました。OAuth は手動でターミナルから実行しなくても、uvx ですぐに使えるようになりました。
• get_capabilities ツールを追加しました — これを呼び出すと、利用可能なツールと現在の認証状態の全一覧を一度に取得できます。AI アシスタントが利用可能なツールを把握できていない場合に便利です。
• 認証エラーメッセージを改善しました — 認証情報が不足または期限切れの場合、すべてのツールで必要な操作が明確に表示されるようになりました。

---

できること

プロパティ管理

• すべての GSC プロパティを一か所で確認できます
• 検証の詳細と所有者情報を取得できます
• アカウントへのプロパティの追加や削除ができます

検索アナリティクスとレポート

• サイトへの訪問者を呼び込んでいる検索クエリを確認できます
• インプレッション数、クリック数、クリック率を追跡できます
• パフォーマンスの傾向を分析し、期間を比較できます
• AI アシスタントが作成したグラフでデータを可視化できます

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

• 特定のページにインデックス登録の問題があるか確認できます
• Google が最後にページをクロールした日時を確認できます
• 複数の URL を一度に検査し、傾向を特定できます

サイトマップ管理

• すべてのサイトマップとそのステータスを確認できます
• 新しいサイトマップを送信できます
• エラーや警告を確認できます

---

利用可能なツール

ツール	機能	必要な情報
get_capabilities	すべてのツールを一覧表示し、認証ステータスを表示します。不明な場合は最初に呼び出してください	なし
list_properties	すべての GSC プロパティを表示します	なし
get_site_details	特定のサイトの詳細を表示します	サイト URL
get_search_analytics	クリック数、インプレッション数、CTR、掲載順位を含む上位の検索クエリとページを表示します	サイト URL、期間
get_performance_overview	サイトのパフォーマンスの概要を表示します	サイト URL、期間
compare_search_periods	2 つの期間のパフォーマンスを比較します	サイト URL、2 つの日付範囲
get_search_by_page_query	特定のページへのトラフィックをもたらしている検索語句を表示します	サイト URL、ページ URL
get_advanced_search_analytics	国、デバイス、検索クエリ、ページで絞り込んだアナリティクスを表示します	サイト URL
inspect_url_enhanced	URL のクロールとインデックス登録のステータスを詳しく表示します	サイト URL、ページ URL
batch_url_inspection	最大 10 件の URL を一度に検査します	サイト URL、URL のリスト
check_indexing_issues	複数の URL についてインデックス登録の問題を確認します	サイト URL、URL のリスト
get_sitemaps	サイトのすべてのサイトマップを一覧表示します	サイト URL
list_sitemaps_enhanced	エラーや警告を含むサイトマップの詳細情報を表示します	サイト URL
manage_sitemaps	サイトマップを送信または削除します	サイト URL、操作
reauthenticate	OAuth ブラウザーログインを再実行します（アカウントの切り替え）	なし

すべての 20 個のツールの一覧を確認するには、AI アシスタントに「call get_capabilities」と依頼してください。

---

---

はじめに

ステップ 1 — Google API 認証情報を設定する

クライアントを設定する前に、認証情報が必要です。次のいずれかの方法を選んでください。

オプション A — OAuth（推奨 — ご自身の Google アカウントを使用）

1. Google Cloud Console にアクセスし、プロジェクトを作成するか選択します
2. Search Console API を有効にします
3. 認証情報 に移動し、［認証情報を作成］→［OAuth クライアント ID］を選択します
4. OAuth 同意画面を設定し、［デスクトップアプリ］を選択して［作成］をクリックします
5. JSON ファイルをダウンロードし、恒久的に保存できる場所（例：~/Documents/client_secrets.json）に保存します

初回使用時にブラウザーウィンドウが開き、Google アカウントへのサインインを求められます。その後はトークンが保存されるため、再度ブラウザーを操作する必要はありません。

オプション B — サービスアカウント（自動化またはチームでの利用向け）

1. Google Cloud Console に移動し、プロジェクトを作成または選択します
2. Search Console API を有効化します
3. 認証情報 に移動 → 認証情報を作成 → サービスアカウント
4. キータブに移動 → キーを追加 → 新しいキーを作成 → JSON → ダウンロード
5. ファイルを永続的な場所に保存します（例: ~/Documents/service_account.json）
6. サービスアカウントのメールアドレスを GSC プロパティに追加します: Search Console → 設定 → ユーザーと権限 → ユーザーを追加 → 全権限

🎥 このセクションのステップバイステップのセットアップチュートリアルを見る

2026 年更新 — 新しい uvx 方式を使用した完全なインストールプロセスを網羅し、Google 認証情報の設定から最初のクエリの成功までを扱います。

---

ステップ 2 — インストール

オプション A — uvx（推奨）

クローンも、Python のインストールも、仮想環境も不要です。uvx がサーバーを自動的にダウンロードして実行し、常に最新の状態に保ちます。

uv をインストール — ターミナルを開き、3 つのコマンドを順番にすべて実行します:

# 1. Download and install
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Activate in the current Terminal session
source $HOME/.local/bin/env

# 3. Make it permanent for all future sessions
echo 'source $HOME/.local/bin/env' >> ~/.zshrc

確認:

uv --version

なぜ 3 つのコマンドすべてが必要なのですか？ インストーラーは uv を ~/.local/bin に配置しますが、すでに開いているターミナルセッションはそのフォルダをまだ認識していません。ステップ 2 で即座に有効化します。ステップ 3 により、今後のすべてのターミナルウィンドウで自動的に利用できるようになります。

次に AI クライアントを設定します:

---

Claude Desktop

設定ファイル: ~/Library/Application Support/Claude/claude_desktop_config.json

OAuth:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

サービスアカウント:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

---

Cursor

設定ファイル: ~/.cursor/mcp.json

OAuth:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

---

Codex CLI

設定ファイル: ~/.codex/config.toml

OAuth:

[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_OAUTH_CLIENT_SECRETS_FILE = "/full/path/to/client_secrets.json" }

サービスアカウント:

[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_CREDENTIALS_PATH = "/full/path/to/service_account.json", GSC_SKIP_OAUTH = "true" }

---

uvx のパスを確認する方法: macOS/Linux では、uv をインストールした後にターミナルで which uvx を実行します（通常は /Users/YOUR_NAME/.local/bin/uvx）。Windows では、PowerShell で Get-Command uvx | Select-Object -ExpandProperty Source を実行します（または cmd で where uvx）— 通常は C:\Users\YOUR_NAME\.local\bin\uvx.exe です。上記の設定にある /FULL/PATH/TO/uvx をそのパスに置き換えてください。

なぜフルパスが必要なのですか？ Claude Desktop や Cursor のような GUI アプリは、シェル設定（~/.zshrc）を読み込まずに起動するため、~/.local/bin を認識しません。フルパスを使用することで、アプリの起動方法にかかわらず動作することが保証されます。spawn uvx ENOENT エラーが表示される場合、これが解決策です。

設定を保存した後、アプリを完全に終了し（Cmd+Q）、再度開いてください。

OAuth の場合: 初回利用時にブラウザウィンドウが自動的に開き、ログインを求められます。その後はトークンがキャッシュされ、再度求められることはありません。

---

オプション B — クローン（上級者向け）

この方法の手順を動画で見たいですか？ 以下のチュートリアルでは、クローンによるインストール手順を段階的に解説しています。仮想環境の設定、依存関係、設定方法を確認できます。

コードを変更したり、特定のローカルバージョンを実行したりする場合は、この方法を使用してください。この方法では、認証情報の設定手順に上記の動画チュートリアルを使用します。

Python 3.11 以降が必要です。 このサーバーは Python 3.10 以前では起動しません。また、Claude Desktop などの GUI クライアントから起動すると、エラーが表示されずに失敗します（ツールが表示されず、ログファイルも書き込まれません）。python --version でバージョンを確認してください。3.11 未満の場合は、Python 3.11 以降をインストールし、仮想環境を作り直してください。uvx を使う方法（オプション A）では Python のバージョンが自動管理されるため、この問題を回避できます。Windows ではこちらの方法をおすすめします。

リポジトリをクローンします：

git clone https://github.com/AminForou/mcp-gsc.git
cd mcp-gsc

または、このページ上部にある緑色の Code ボタンから ZIP をダウンロードして、解凍してください。

環境を設定します：

uv venv .venv
uv pip install -r requirements.txt

AI クライアントを設定します（Claude Desktop の例）：

OAuth：

{
  "mcpServers": {
    "gscServer": {
      "command": "/full/path/to/mcp-gsc/.venv/bin/python",
      "args": ["/full/path/to/mcp-gsc/gsc_server.py"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

サービスアカウント：

{
  "mcpServers": {
    "gscServer": {
      "command": "/full/path/to/mcp-gsc/.venv/bin/python",
      "args": ["/full/path/to/mcp-gsc/gsc_server.py"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

Mac のパスの例：

• Python：/Users/yourname/Documents/mcp-gsc/.venv/bin/python
• スクリプト：/Users/yourname/Documents/mcp-gsc/gsc_server.py

---

ステップ 3 — テスト

AI アシスタントに 「GSC のプロパティを一覧表示して」 と尋ねます。

プロパティが表示されたら、動作しています。表示されない場合は、「get_capabilities を呼び出して」 と尋ねて、認証の状態を確認し、問題を診断してください。

---

環境変数リファレンス

変数	必須	デフォルト	説明
GSC_OAUTH_CLIENT_SECRETS_FILE	OAuth のみ	—	OAuth クライアントシークレット JSON の絶対パスです。uvx を使用する場合は必ず指定してください。
GSC_CREDENTIALS_PATH	サービスアカウントのみ	—	サービスアカウント JSON キーの絶対パスです。uvx を使用する場合は必ず指定してください。
GSC_SKIP_OAUTH	いいえ	false	"true" に設定すると、サービスアカウント認証を強制し、OAuth を完全にスキップします
GSC_DATA_STATE	いいえ	"all"	"all" は GSC ダッシュボードと同じデータを返します。"final" は確定済みのデータのみを返します（2～3 日の遅延があります）。
GSC_ALLOW_DESTRUCTIVE	いいえ	false	"true" に設定すると、サイトの追加／削除およびサイトマップの削除ツールが有効になります

---

Cursor Marketplace

ワンクリックでインストールできます。Cursor Marketplace で mcp-search-console を検索してください。

インストール後、認証情報を設定して（上記のステップ 1 を参照）、Cursor Agent のチャットでバンドルされているスキルを直接使用します。

スキル	呼び出し方	機能
seo-weekly-report	「example.com の SEO 週次レポートを実行して」	期間ごとの比較と上位クエリを含む、過去 28 日間の詳細なパフォーマンス概要
cannibalization-check	「example.com でキーワードのカニバリゼーションを確認して」	複数のページが競合するクエリを見つけ、残すページを提案します
indexing-audit	「上位ページのインデックス登録を監査して」	上位 20 ページをまとめて調査し、優先順位付きの修正リストを返します
content-opportunities	「example.com のコンテンツ機会を見つけて」	表示回数が多く CTR が低い、掲載順位 11～20 位のクエリを抽出します

---

サンプルプロンプト

ツール	サンプルプロンプト
list_properties	"GSC のすべてのプロパティを一覧表示し、インデックスに登録されているページ数が最も多いものを教えてください。"
get_search_analytics	"過去 30 日間の mywebsite.com の検索クエリ上位 20 件を表示し、CTR が 2% 未満のものを強調表示して、タイトルの改善案を提案してください。"
get_performance_overview	"過去 28 日間の mywebsite.com のパフォーマンス概要を視覚的に作成し、異常な急落や急上昇を特定して、考えられる原因を説明してください。"
check_indexing_issues	"次のページのインデックス登録に関する問題を確認してください：mywebsite.com/product、mywebsite.com/services、mywebsite.com/about"
inspect_url_enhanced	"mywebsite.com/landing-page を包括的に検査し、実行可能な改善案を提示してください。"
compare_search_periods	"1 月と 2 月のサイトのパフォーマンスを比較してください。最も改善したクエリはどれですか？"
get_advanced_search_analytics	"表示回数が多いものの掲載順位が 10 位未満のクエリを分析してください。対象は米国のモバイルトラフィックに限定してください。"

---

トラブルシューティング

spawn uvx ENOENT または command not found: uvx

AI クライアントが uvx を見つけられません。uvx だけを指定するのではなく、フルパスを使用してください。

# Find your full path (macOS/Linux):
which uvx
# Typically: /Users/YOUR_NAME/.local/bin/uvx

# Find your full path (Windows PowerShell):
Get-Command uvx | Select-Object -ExpandProperty Source
# Typically: C:\Users\YOUR_NAME\.local\bin\uvx.exe

設定で "command": "uvx" をフルパス（例："command": "/Users/YOUR_NAME/.local/bin/uvx"）に置き換えてください。

インストール直後に uv --version を実行すると「command not found」と表示される

インストーラーによって ~/.local/bin が更新されますが、現在のターミナルセッションにはまだ反映されていません。次を実行してください。

source $HOME/.local/bin/env

次に、恒久的に追加します。

echo 'source $HOME/.local/bin/env' >> ~/.zshrc

認証に失敗する／認証情報ファイルが見つからない

認証情報ファイルには絶対パスを指定してください。相対パスや ~/ は使用しないでください。例：

/Users/yourname/Documents/client_secrets.json   ✅
~/Documents/client_secrets.json                 ✅
client_secrets.json                              ❌

MCP が Claude Desktop アプリでは動作するが、ウェブサイトでは動作しない

MCP サーバーはお使いのマシン上でローカルに実行されます。claude.ai/download からダウンロードした Claude Desktop アプリでのみ動作し、claude.ai のブラウザーインターフェースでは動作しません。

AI クライアントの設定に関する問題

1. 設定内のすべてのファイルパスが正しい絶対パスであることを確認してください
2. 設定を変更した後は、アプリを完全に終了（Cmd+Q）してから再起動してください。ウィンドウを閉じるだけでは不十分です
3. AI アシスタントに「call get_capabilities」と依頼してください。認証の状態とエラーが正確に報告されます

---

安全性：破壊的な操作

デフォルトでは、add_site、delete_site、delete_sitemap は無効になっています。有効にするには：

"GSC_ALLOW_DESTRUCTIVE": "true"

---

リモートでのデプロイと Docker（上級者向け）

標準的なセットアップでは、サーバーをローカルで実行します。このセクションは、リモートサーバーまたはコンテナー内で実行する場合にのみ参照してください。

HTTP トランスポート

MCP_TRANSPORT=sse MCP_HOST=0.0.0.0 MCP_PORT=3001 python gsc_server.py

変数	デフォルト	説明
MCP_TRANSPORT	stdio	ネットワーク／リモートで使用する場合は sse に設定します
MCP_HOST	127.0.0.1	バインドするホスト
MCP_PORT	3001	バインドするポート

Docker

docker build -t mcp-gsc .

docker run \
  -e MCP_TRANSPORT=sse \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=3001 \
  -e GSC_CREDENTIALS_PATH=/app/credentials.json \
  -v /path/to/credentials.json:/app/credentials.json \
  -p 3001:3001 \
  mcp-gsc

---

関連ツール

Advanced GSC Visualizer — インタラクティブなグラフ、最大 25,000 行のワンクリックエクスポート、キーワードのカニバリゼーション検出、AI アシスタントを備えた Chrome 拡張機能（14,000 人以上が利用）。すべて Google Search Console 内で直接利用できます。同じ作者が開発しています。Chrome ウェブストアからインストール →

---

貢献

バグを見つけた場合や改善案がある場合は、GitHub で issue を作成するか、プルリクエストを送ってください。

問題を報告し、修正に貢献してくださった皆さんに感謝します。以下の方々をはじめ、多くの方にご協力いただきました。 @patrickweh、@remotesensei、 @JKdreaming、@kuldiph。

---

ライセンス

MIT License。詳細は LICENSE ファイルをご覧ください。

---

変更履歴

[0.4.1] — 2026年9月

• check_indexing_issues が URL を並行して検査するようになり（#31 と同じ修正）、sc-domain:* プロパティに対して 10 URL のフルバッチを実行してもタイムアウトしなくなりました。（#55 を修正、@kuldiph さんに感謝）
• get_search_by_page_query から残っていた orderBy を削除しました。これは Search Analytics API が無視する無効なフィールドで、#54 のクリーンアップと整合しています。（#55 を修正、@kuldiph さんに感謝）

[0.4.0] — 2026年9月

• inspect_url_enhanced と batch_url_inspection におけるリッチリザルトの問題レポートを修正しました。問題は detectedItems[].items[].issues[]（issueMessage）から読み取られるようになりました。これは API が実際に返すキーであり、問題が黙って破棄されなくなりました。（#46、#48 を修正、@patrickweh さんに感謝）
• batch_url_inspection が URL を並行して検査するようになり、遅い sc-domain:* プロパティでも 10 URL のフルバッチがクライアントのタイムアウト内に完了するようになりました。（#31 を修正、@remotesensei さんに感謝）
• compare_search_periods がデルタを期間 1 の期間 2 に対する相対値として計算するようになりました（期間 2 をパーセンテージの基準とし、正の値 = 期間 1 の方が良好）。方向性はドキュメント化されています。（#42 を修正、@JKdreaming さんに感謝）
• get_advanced_search_analytics が、Search Analytics API が無視する orderBy を送信する代わりに、sort_by/sort_direction をクライアント側で適用するようになりました。（#54 を修正、@kuldiph さんに感謝）
• 3 つの裸の except: 句を except Exception: に置き換え、KeyboardInterrupt/SystemExit が飲み込まれなくなりました。（#53 を修正、@kuldiph さんに感謝）
• 破壊的変更: batch_url_inspection は URL ごとの verdict フィールドを index_verdict に改名しました。

[0.3.3] — 2026年7月

• mcp[cli]>=1.3.0,<2.0.0 に固定しました。mcp SDK 2.0.0 では mcp.server.fastmcp が削除され、新規の uvx インストールがすべて ModuleNotFoundError で壊れていました。2.0 未満に上限を設けることで、動作するインストールが復元されます。（#41 を修正）

[0.3.2] — 2026年4月

• uvx 向け OAuth ブラウザーフローを修正 — macOS で MCP サブプロセスとして実行しているときに OAuth ブラウザーウィンドウが開かなくなる isatty ブロックを削除しました。OAuth + uvx がすぐに動作するようになりました。
• get_capabilities ツール — 利用可能なすべてのツールをカテゴリ別にグループ化し、ライブの認証ステータスも 1 回の呼び出しで返します。
• より良い認証エラーメッセージ — すべてのツールが、認証情報がないか期限切れの場合に reauthenticate を呼び出すよう明示的に案内するようになりました。
• list_properties の説明を改善 — 遅延ツール読み込みを使用するクライアントでのセマンティックなツール検出が向上しました。

[0.3.1] — 2026年4月

• list_properties が実際の認証エラーを隠蔽する問題を修正しました。認証情報がない場合は早期に失敗します。

[0.3.0] — 2026年4月

• 4 つの SEO スキルを同梱した Cursor Marketplace プラグイン
• プラットフォームのユーザー設定ディレクトリへの安定したトークン保存（uvx のアップグレードをまたいでも保持されます）
• すべてのデータツールで構造化 JSON 出力
• 39 件のユニットテスト

[0.2.2] — 2026年4月

• 破壊的ツール向けのセーフティモード（デフォルトでは無効）
• リモートデプロイ向けの HTTP/SSE トランスポート
• Dockerfile

[0.2.1] — 2026年3月

• Google アカウントを切り替えるための reauthenticate ツール
• サイトマップの TypeError クラッシュを修正
• ドメインプロパティの 404 エラーを修正

[0.2.0] — 2026年3月

• デフォルトで dataState: "all"（GSC ダッシュボードと一致）
• 柔軟な row_limit パラメーター（最大 500）
• 高度な分析向けの多次元フィルタリング

[0.1.0] — 初回リリース

• プロパティ管理、検索分析、URL 検査、サイトマップ管理をカバーする 19 のツール
• OAuth とサービスアカウント認証