Google Search Console MCP Server (mcp-gsc)

Google Search Console MCP Server (mcp-gsc) とは？

mcp-gsc は、GSC プロパティを Claude Desktop、Cursor、Codex CLI などの AI アシスタントに接続するオープンソースの Google Search Console MCP サーバーです。クリック数、表示回数、インデックス状況、サイトマップを自然言語で問い合わせられます。

AminForou が開発するコミュニティ製の GSC MCP サーバーで、MIT ライセンスの Python 製です。PyPI では mcp-search-console として公開されています。Google は公式の Search Console MCP サーバーを公開していません。ローカルで stdio 経由で動作し、OAuth ログインまたはサービスアカウントで Search Console API を呼び出します。

Google Search Console MCP Server (mcp-gsc) の使い方

セットアップは 3 ステップです。認証情報を作成し、uv をインストールして、クライアントを設定します。

1. 認証情報を作成する（どちらか一方）。

• OAuth（推奨）：Google Cloud Console でプロジェクトを作成または選択し、Search Console API を有効化します。次に種類が Desktop app の OAuth client ID を作成し、JSON ファイル（例：~/Documents/client_secrets.json）をダウンロードします。初回利用時にブラウザが開いて Google ログインを求められ、その後はトークンがキャッシュされます。
• サービスアカウント（自動化やチーム向け）：同じ API を有効化し、サービスアカウントを作成して JSON キーをダウンロードします。その後、Search Console →「設定」→「ユーザーと権限」で、サービスアカウントのメールアドレスをプロパティに追加します。

2. uv をインストールする。推奨される方法は uvx でサーバーを実行する方法です。uvx がサーバーをダウンロードし、Python も管理します。

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
echo 'source $HOME/.local/bin/env' >> ~/.zshrc

GUI アプリはシェルの設定を読み込みません。設定には which uvx で得たフルパスを使ってください。

3. クライアントを設定する。設定を編集したらアプリを完全に終了して再起動し、「List my GSC properties」と尋ねます。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

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

サービスアカウントを使う場合は、env ブロックを "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json" と "GSC_SKIP_OAUTH": "true" に置き換えます。

Claude Code

README には、ローカルサーバー用の Claude Code コマンドは書かれていません。同じ stdio コマンドは、Claude Code 標準の claude mcp add 構文で登録できます。

claude mcp add gscServer -e GSC_OAUTH_CLIENT_SECRETS_FILE=/full/path/to/client_secrets.json -- uvx mcp-search-console

Cursor

~/.cursor/mcp.json に Claude Desktop と同じ JSON を記述します。Cursor Marketplace で mcp-search-console を検索してワンクリックでインストールすることもできます。こちらには seo-weekly-report、cannibalization-check、indexing-audit、content-opportunities の 4 つのスキルが同梱されています。

Codex

~/.codex/config.toml に追加します。

[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" }

コードを変更したい場合は、リポジトリをクローンし、仮想環境（Python 3.11+）で gsc_server.py を実行することもできます。

Google Search Console MCP Server (mcp-gsc) の主な機能

• アクセスできるすべての GSC プロパティを、確認情報と所有権の詳細とともに一覧表示します。
• 検索アナリティクス（クエリ、ページ、クリック数、表示回数、CTR、掲載順位）を取得し、国、デバイス、クエリ、ページで絞り込めます。
• 2 つの期間を比較し、トラフィックが増えたクエリやページ、減ったクエリやページを示します。
• 単一の URL、または最大 10 件の URL を一括で検査し、クロールとインデックスの状況を確認します。リッチリザルトの問題も対象です。
• サイトマップの一覧表示と送信を行い、エラーや警告を確認します。
• OAuth（自分の Google アカウント）とサービスアカウントの両方に対応し、reauthenticate でアカウントを切り替えられます。
• 破壊的な操作を行うツール（add_site、delete_site、delete_sitemap）はデフォルトで無効です。有効にするには GSC_ALLOW_DESTRUCTIVE=true が必要です。
• オプションの SSE トランスポートと Dockerfile があり、リモートやコンテナでのデプロイに使えます。

Google Search Console MCP Server (mcp-gsc) のツール

README には 15 個の主要ツールが記載されています。get_capabilities を呼び出すと、全 20 ツールと現在の認証状態が返されます。

• プロパティ：list_properties と get_site_details は、サイトとその詳細を表示します。
• 検索アナリティクス：get_search_analytics、get_performance_overview、get_search_by_page_query、get_advanced_search_analytics、compare_search_periods は、上位クエリ、ページ単位の検索語句、絞り込みレポート、期間比較を扱います。1 リクエストあたり最大 500 行（row_limit）です。
• URL 検査：inspect_url_enhanced、batch_url_inspection、check_indexing_issues は、クロール日、インデックス判定、インデックスの問題を報告します。
• サイトマップ：get_sitemaps、list_sitemaps_enhanced、manage_sitemaps は、サイトマップの状態を表示し、送信や削除を行います。
• ユーティリティ：get_capabilities と reauthenticate。

Google Search Console MCP Server (mcp-gsc) のユースケース

• タイトルやメタ情報の改善：「Show me the top 20 search queries for mywebsite.com in the last 30 days, highlight any with CTR below 2%, and suggest title improvements.」
• トラフィック減少の診断：「Compare my site's performance between January and February. What queries improved the most?」
• インデックス監査：「Check these pages for indexing issues: mywebsite.com/product, mywebsite.com/services, mywebsite.com/about」
• あと一歩で上位に入るキーワードの発見：「Analyze queries with high impressions but positions below 10, filtered to mobile traffic in the US only.」
• ページ単位のレポート：「Do a comprehensive inspection of mywebsite.com/landing-page and give me actionable recommendations.」

Google Search Console MCP Server (mcp-gsc) と代替ツールの比較

Google 公式の Search Console MCP サーバーはないため、選択肢はすべてコミュニティ製です。mcp-gsc は GitHub で最もスターが多く（約 1,900）、メンテナンスも続いています。

• ahonn の Google Search Console MCP Server は Node.js 製のサーバー（npm の mcp-server-gsc）です。サービスアカウント認証を使い、大量の分析データ取得（最大 25,000 行）、正規表現フィルター、「quick wins」の検出に重点を置いています。
• saurabhsharma2u の Search Console MCP は、Google Search Console、Bing Webmaster Tools、GA4、AdSense を 1 つのサーバーにまとめています。

自分のアカウントでの OAuth、URL 検査、サイトマップのツール、シンプルな uvx インストールを求めるなら、mcp-gsc を選んでください。

Google Search Console MCP Server (mcp-gsc) のトラブルシューティング

• spawn uvx ENOENT または command not found: uvx：クライアントが uvx を見つけられていません。"command": "uvx" を、which uvx で得たフルパス（例：/Users/YOUR_NAME/.local/bin/uvx）に置き換えてください。
• インストール直後に uv --version でコマンドが見つからない：source $HOME/.local/bin/env を実行し、~/.zshrc にも追加してください。
• 認証に失敗する、または認証情報ファイルが見つからない：ファイル名だけでなく、JSON ファイルの絶対パスを指定してください。そのうえでアシスタントに「call get_capabilities」と頼むと、具体的な認証エラーを確認できます。
• クローン方式でツールが表示されない：サーバーには Python 3.11+ が必要です。Claude Desktop から起動した場合、古いバージョンでは何も表示されずに失敗します。Python を更新するか、uvx を使ってください。
• Claude Desktop では動くが claude.ai では動かない：このサーバーはローカルで動作するため、デスクトップや CLI のクライアントでのみ使えます。claude.ai のウェブ画面では使えません。