Google Search Console MCP

English | Русский

A1 Google Search Console MCP は、AIアプリをGoogle Search Consoleに接続します。検索パフォーマンスを調査し、URLがインデックスされているかを確認し、サイトマップを検査し、必要に応じてサイトマップを意図的に送信または削除できます。

このサーバーは、Googleアカウントがアクセスできるプロパティで動作します。重要なのは、Search Consoleのプロパティ値を正確に使用することです。ドメインプロパティとURLプレフィックスプロパティは別のオブジェクトです。

• 12のツール。 7つのツールは、プロパティ、検索データ、サイトマップ、インデックス状態を読み取ります。2つはプロパティの追加やサイトマップの送信、3つはデータの削除や任意のAPIメソッドの呼び出しができます。

• 正確なプロパティID。 https://example.com/、https://www.example.com/、sc-domain:example.com はそれぞれ異なります。使用する値は list_sites で確認できます。

• コンテキスト付きの検索データ。 クリック数、インプレッション数、CTR、掲載位置を、日付、ページ、クエリ、国、デバイス、検索表示形式で照会できます。

• インデックス確認であり、公開ではない。 URL検査はGoogleの現在のステータスを説明します。ページをインデックスに強制するものではありません。

読み取り専用の質問から始めましょう。

私のプロパティの過去28日間の上位20件の検索クエリを、クリック数とCTR付きで表示してください。

サーバーに接続 · ユースケースを見る · 技術ドキュメントを開く

1分で動作を確認

ユーザー: https://example.com/pricing はインデックスされていますか？されていない場合、その理由は？

アシスタント: URLを検査し、インデックス判定、カバレッジ、クロール情報、正規URLを表示します。何も変更しません。

ユーザー: 送信済みのサイトマップを確認して、エラーがあるものを再送信できるよう準備してください。

アシスタント: サイトマップとその警告、エラーを表示し、再送信する前に確認を求めます。

ユーザー: 確認します。

アシスタント: 選択したサイトマップを再送信します。ページのコンテンツは変更されず、インデックス登録も保証されません。

Related MCP server: mcp-gsc

目次

• クイックスタート

• できること

• Search Consoleプロパティの仕組み

• 変更を伴う操作

• アクセスの取得

• 設定

• データ、制限、バックグラウンド処理

• 技術ドキュメント

• サポート

クイックスタート

Node.js 20以上、Search ConsoleプロパティにアクセスできるGoogleアカウント、Google CloudのOAuth認証情報が必要です。

1. OAuthアクセスを準備します。

2. AIアプリにサーバーを追加します。

3. 上記の読み取り専用の質問から始めます。

アプリ内: Settings → Plugins → MCP servers を開き、Add server を選択して、GOOGLE_SEARCH_CONSOLE_CLIENT_ID、GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET、GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN を指定して npx -y mcp-google-search-console@latest を追加します。

codex mcp add google-search-console \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_ID=your_client_id \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-search-console@latest
codex mcp list

Codex MCPドキュメント

claude mcp add \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_ID=your_client_id \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-search-console \
  -- npx -y mcp-google-search-console@latest
claude mcp list

Claude Code MCPドキュメント

Settings → Developer → Edit Config を開いて追加します:

{"mcpServers":{"google-search-console":{"command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"your_client_id","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"your_client_secret","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"your_refresh_token"}}}}

Edit Config がない場合は、macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは %APPDATA%\Claude\claude_desktop_config.json を編集します。

Claude Desktop MCPドキュメント

macOS/Linuxでは ~/.cursor/mcp.json、Windowsでは %USERPROFILE%\.cursor\mcp.json に追加します:

{"mcpServers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"your_client_id","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"your_client_secret","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"your_refresh_token"}}}}

Cursor MCPドキュメント

MCP: Open User Configuration を実行して追加します:

{"servers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"${input:gsc_client_id}","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"${input:gsc_client_secret}","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"${input:gsc_refresh_token}"}}},"inputs":[{"type":"promptString","id":"gsc_client_id","description":"Google OAuth client ID"},{"type":"promptString","id":"gsc_client_secret","description":"Google OAuth client secret","password":true},{"type":"promptString","id":"gsc_refresh_token","description":"Google OAuth refresh token","password":true}]}

MCP: List Servers で確認します。 VS Code MCPドキュメント

できること

検索機会を見つける

• 今月最もクリックが多かったクエリとページは？

• 前の期間と比べてクリックが減ったページは？

• 平均掲載位置が10未満の mcp を含むクエリを表示して。

インデックス状態とサイトマップを確認する

• このURLはインデックスされていますか？カバレッジ、クロール、正規URLの情報を表示して。

• 送信済みサイトマップのうち、エラーや警告があるものはどれ？

• 現在のステータスを表示した後に、このサイトマップを再送信して。

プロパティを慎重に管理する

• アクセスできるSearch Consoleプロパティを一覧表示して。

• この正確なプロパティ値を追加して。所有権の確認は別途行います。

• 確認後に、このプロパティをアカウントから削除して。

Search Consoleプロパティの仕組み

URLプレフィックスプロパティには、プロトコルと末尾のスラッシュを含める必要があります（例: https://example.com/）。ドメインプロパティは sc-domain:example.com のように記述します。類似した値では403または404になるため、list_sites が返す正確な値を使用してください。

add_site はプロパティを登録するだけです。検証はSearch Console UIまたはSite Verification APIで行います。検索データは米国太平洋時間に基づきます。end_date は期間に含まれ、最終的なアナリティクスデータは通常2〜3日遅れます。data_state: "all" を指定すると、より新しい変動中の行も含まれる場合があります。

変更を伴う操作

確認プロンプトはAIクライアントが制御します。サーバーは読み取り、書き込み、破壊的呼び出しをマークするため、クライアントは調査と実際の変更を区別できます。

アクセスの取得

Search ConsoleデータにアクセスするにはGoogle OAuth 2.0が必要です。APIキーだけでは不十分です。

1. Google Cloudプロジェクトを作成または選択し、Google Search Console API を有効にします。

2. OAuth同意画面を設定し、Desktop app OAuthクライアントを作成します。

3. OAuth 2.0 Playground で Use your own OAuth credentials を使用して、プロパティにアクセスできるGoogleアカウントを認証し、リフレッシュトークンを取得します。

4. サイトマップとプロパティ変更を含めるには https://www.googleapis.com/auth/webmasters を使用します。読み取り専用アクセスを意図的に必要とする場合にのみ https://www.googleapis.com/auth/webmasters.readonly を使用します。

テストモードのリフレッシュトークンは7日後に期限切れになる場合があります。長期的なアクセスには、OAuthアプリを公開するか、Internal Workspaceアプリを使用してください。クライアントシークレットとリフレッシュトークンはパスワードと同じように扱ってください。

設定

* OAuth 3点セットまたはアクセストークンのいずれかを指定します。

データ、制限、バックグラウンド処理

• プライバシー。 ローカルサーバーはGoogleにアクセスし、インストールID、バージョン、ツール名を含む匿名テレメトリを送信します — OAuthトークン、プロパティデータ、ツール引数、プロンプトを送信することは決してありません。オプトアウトするには ASKADS_TELEMETRY=0 を設定します。

• API制限。 URL検査は、プロパティごとに1日2,000回、1分間に600回までです。アナリティクスはリクエストごとに最大25,000行を返します。ロングテールの匿名化されたクエリは返されません。ページネーションを使用し、サイト全体をURLごとに検査しないでください。

• バックグラウンド監視なし。 サーバーは呼び出されている間だけ動作します。AIアプリがスケジュールタスクをサポートしている場合は、サイトマップや重要なURLを定期的に確認できます。

技術ドキュメント

• MCP機能カタログ — ツールごとのタスク指向ページ。

• すべてのツールと入力

• 開発ドキュメント

• 公開ドキュメント

• Google Search Console API

サポート

バグを発見した場合や、シナリオが必要な場合は、Issueを作成 するか、Telegram で連絡してください。