Google Search Console

この動画では、サンプルデータを使ったホスト版 getmcpads を紹介しています。クリエイティブギャラリーやアラートから Google Sheets へのエクスポート、一括配信まで、MCP Apps はホスト版製品に含まれます。このリポジトリでは、スタンドアロンのネイティブ API ツールを提供します。

20 個の読み取りツール · 読み取り専用として設計されています。

独自のプラットフォーム認証情報と、Claude Desktop、Claude Code、Cursor などの stdio MCP に対応するクライアントを使ってローカルで実行できます。リクエストはプラットフォームに直接送信されます。対応する ChatGPT の構成を含む、管理された接続を利用する場合は、ホスト版をご利用ください。

新着情報

v2.1.1：Zod 4 のセキュリティアップデート · 2026 年 10 月 26 日

• zod を 4.6.7 に更新しました。4.6.6 より前の Zod のすべてのリリースは、重大度の高いアドバイザリ GHSA-mrhx-c7xc-m3w5 の対象です。サイズ制限のあるコレクションに対する検証でメモリを使い果たすおそれがあり、この修正を含む Zod 3 のリリースはありません。npm audit --omit=dev で再び脆弱性が報告されなくなりました。
• Zod 3 の検証動作を維持しました。パラメーターのデフォルト値は使用前に検証され、補完されるため、省略されたオブジェクトにも引き続き必須フィールドを指定する必要があります。
• パラメーターがオプション、またはデフォルト値を持つ場合も、それぞれの説明を維持します。Zod 4 ではラップされたスキーマにのみ説明が保存されるため、そうしないと共有のフォールバック説明で置き換えられる可能性があります。
• MCP 経由で公開されるツール名、パラメーター、説明に変更はありません。server-card.json は Zod 4 の JSON Schema 出力で再生成されており、一部の制約の表記が異なります。

以前のリリース

バージョン	日付	主な変更点
2.1.0	2026 年 10 月 23 日	サイトの許可リストと、取り消されたトークンの処理
2.0.1	2026 年 9 月 23 日	パブリックリポジトリを復元
2.0.0	2026 年 9 月 20 日	ゲートウェイの同期とセキュリティ修正
1.1.0	2026 年 9 月 13 日	プラットフォーム機能の同期と品質契約
1.0.2	2026 年 8 月 30 日	MCP 経由でパッケージバージョンを通知
1.0.1	2026 年 8 月 30 日	公式 MCP Registry 向けに、com.getmcpads/google-search-console の server.json と mcpName を追加
1.0.0	2026 年 8 月 29 日	オープンソースとして初回リリース

変更履歴の全文 · すべてのリリース

ソース同期：SOURCE_SYNC.md。

アップグレードに関する注意事項

Node.js 22.23.4、24.22.1、26.12.1、またはこれらの系列のより新しいリリースが必要です。古いリリースには2026年10月のセキュリティ修正が含まれておらず、そのいずれかで起動すると、サーバーは stderr に警告を出力します。CI では Node 22、24、26 を対象としています。

このリリースでは、設定に破壊的変更はありません。3.0.0 で予定されている変更が1つあります。2.x では GSC_SITE_URLS は任意ですが、3.0.0 では必須になります。設定すると、すべてのツールで指定したプロパティのみが対象となり、GSC_SITE_URL はそのいずれかである必要があります。未設定の場合、サーバーは従来どおり起動し、設定を推奨するメッセージを stderr に1行出力します。20個のツール、そのスキーマ、上限付きのレポート制限に変更はありません。

このリリースのインストール

これは GitHub のソースリリースです。npm と MCP Registry のバージョンは別途公開されています。以下のコマンドではこのバージョンを正確に指定します。このドキュメントの後半にある、バージョンを固定していない npx の例では、npm で現在利用可能なバージョンが選択されます。

git clone --branch v2.1.1 --depth 1 https://github.com/get-mcp-ads/google-search-console-mcp-server.git
cd google-search-console-mcp-server
npm ci
npm run build

MCP クライアントでは、node を実行し、dist/cli.js の絶対パスと、以下に記載するプラットフォーム認証情報を指定してください。

管理された接続をお求めですか？ ホスト型の getmcpads で Google Search Console を利用する。アカウントを接続し、アシスタントがアクセスできるデータを選択して、ホスト型 MCP 接続を利用できます。現在の機能とプランについては、サイトをご覧ください。

利用できる機能

20個の読み取りツール	Search Analytics、サイト、サイトマップ、URL Inspection、およびこれらを基にした分析
API ラッパーにとどまらない SEO 分析	カニバリゼーションの検出、クエリのクラスタリング、期間ごとの増減、インデックス登録の監視リスト、大規模サイトのサンプリング計画
7個のリソース	モデルが読み取れる最新のカタログ：指標、ディメンション、フィルター、互換性ルール、8つのワークフローレシピ、読み取り専用のプレイブック
クォータの安全策	すべての URL Inspection 呼び出しは10件の URL に制限されるため、試しに質問を1つしただけで1日分のクォータを使い切ることはありません
書き込み機能は一切ありません	フラグではなく、コードの性質です。以下をご覧ください

データの取得にとどまらない機能

Search Console は行に関する質問に答えます。実際によくある質問の多くは変化に関するものです。どのクエリで順位を落としたか、どのページが同じ検索語をめぐって競合しているか、インデックス登録に変化が起きているか、といったことです。

これらのツールは、作業をモデル任せにせず、代わりに実行します。

ツール	回答する質問
gsc_detect_cannibalization	どのページが同じクエリをめぐって競合しているか
gsc_find_losses_gains	2つの期間の間に何を獲得し、何を失ったか
gsc_cluster_queries	どのクエリが同じ検索意図に属するか
gsc_compare_search_types	ウェブ、画像、動画、ニュースにどのような違いがあるか
gsc_analyze_search_appearance_trends	リッチリザルトがどのように変化しているか
gsc_indexation_watchlist	どの URL でインデックス登録の判定が変わったか
gsc_plan_large_site_sampling	すべてを検査できないとき、どの URL を検査するか

---

数値を信頼する前に知っておくべきこと

Search Console が返すのは上位 N 件であり、サイト全体の合計ではありません。

query や page などのディメンションを指定してクエリを実行すると、API はクリック数順に並べた上位の行を、指定した行数の上限まで返します。それらの行のクリック数を合計しても、サイト全体の合計にはなりません。ロングテールが含まれておらず、大規模なサイトではトラフィックの大半が欠落することもあります。

正確な合計を得るには、ディメンションを指定せずにクエリを実行してください。期間を比較する場合は、同じ条件で比較してください。ディメンション、行数の上限、検索タイプをすべて同じにします。

gsc_query_search_analytics は実際に返されたデータを報告し、gsc_validate_query は実行前に組み合わせを検証します。しかし、計算上の誤りを避けるのは利用者自身です。これは Search Console の分析で最もよくある間違いです。

ほかにも、覚えておくべき制限が2つあります。

• 履歴はおよそ16か月分です。 それより古いデータは、処理が遅いのではなく、すでに削除されています。
• データの確定には約3日かかります。 どのデータが確定済みかは gsc_get_data_freshness で確認できます。

---

読み取り専用である理由と、今後も変わらない理由

書き込みツールはなく、それを追加する環境変数もありません。Search Console API は、サイトマップの送信や削除、プロパティの追加や削除、インデックス登録のリクエストを実行できます。このサーバーでは、そのいずれも公開していません。

要求するスコープもその方針を反映しており、webmasters ではなく webmasters.readonly です。モデルが書き込みを試みても、トークンでは実行できません。

書き込みが適切な広告プラットフォームのサーバーでは、必須のプレビュー機能付きで書き込みに対応しています。 Meta Ads · Google Ads · TikTok Ads

getmcpads.com のホスト版でも同じルールが適用され、Search Console は読み取り専用です。

---

認証情報の取得

一度だけ取得する、3 つの値です。

1. OAuth クライアント

Google Cloud プロジェクトで Google Search Console API を有効にし、APIs & Services → Credentials で OAuth クライアントを作成します。ローカルで使用する場合は Desktop app を選択します。client ID と client secret を控えてください。

2. リフレッシュトークン

プロパティを所有している、またはそのプロパティを読み取れる Google アカウントでログインし、OAuth 同意フローを一度実行して、リフレッシュトークンを保管します。要求するのは webmasters.readonly のみです。

📖 インストール型アプリ向け Google OAuth

リフレッシュトークンは期限切れになりません。 このサーバー専用の OAuth クライアントを使用すれば、そのクライアントだけを個別に失効させられます。

手早く試す場合は、代わりに GSC_ACCESS_TOKEN に有効期間の短いトークンを設定できます。ただし、1 時間以内に期限切れになるため、日常的な作業には使えません。

1 つのプロパティのために OAuth クライアントを設定するのは避けたい場合は、getmcpads.com が同意フローを代行し、ホストされたエンドポイント経由で同じツールを提供します。

3. サイト URL（任意）

毎回渡さずに済むよう、GSC_SITE_URL を設定します。どちらのプロパティ形式も使用できます。

プロパティの種類	値
URL プレフィックス	https://example.com/（末尾のスラッシュが必要です）
ドメイン	sc-domain:example.com

アクセス可能なプロパティを gsc_list_sites で一覧表示し、最初の呼び出しとして gsc_health_check を実行してください。秘密情報を表示せずに認証情報を検証します。

---

セットアップ

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS） または %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "search-console": {
      "command": "npx",
      "args": ["-y", "@getmcpads/google-search-console-mcp-server"],
      "env": {
        "GSC_CLIENT_ID": "your-client-id",
        "GSC_CLIENT_SECRET": "your-client-secret",
        "GSC_REFRESH_TOKEN": "your-refresh-token",
        "GSC_SITE_URLS": "sc-domain:example.com"
      }
    }
  }
}

Claude Desktop を再起動します。「先月、どのクエリが減った？」と尋ねてください。

Claude Code

claude mcp add search-console --env GSC_CLIENT_ID=... --env GSC_CLIENT_SECRET=... --env GSC_REFRESH_TOKEN=... -- npx -y @getmcpads/google-search-console-mcp-server

Cursor

プロジェクト内の .cursor/mcp.json に設定します。形式は上記の Claude Desktop 設定と同じです。

ソースから実行

git clone https://github.com/get-mcp-ads/google-search-console-mcp-server.git
cd google-search-console-mcp-server
npm install && npm run build
cp .env.example .env   # then fill in your credentials
npm start

設定

変数	デフォルト	意味
GSC_CLIENT_ID	なし	OAuth クライアント ID
GSC_CLIENT_SECRET	なし	OAuth クライアントのシークレット
GSC_REFRESH_TOKEN	なし	同意フローで取得
GSC_ACCESS_TOKEN	なし	上記 3 つの代替。1 時間以内に期限切れになります
GSC_SITE_URL	なし	任意のデフォルトプロパティ
GSC_SITE_URLS	未設定	推奨。各ツールでアクセス可能なプロパティをカンマ区切りで指定します。Search Console に表示される表記どおりに記述してください。未設定の場合、認証情報でアクセスできるすべてのプロパティが使用可能です。3.0.0 では必須です
LOG_LEVEL	info	debug、info、warn、error

OAuth の値 3 つ、または GSC_ACCESS_TOKEN のいずれかが必要です。どちらも指定されていない場合、サーバーは起動を拒否します。

npm run doctor

---

ツール

すべてのツールを以下に示します。パラメーターと出力の完全なスキーマについては、server-card.json を参照してください。

20 個の読み取りツール

ツール	目的
gsc_list_sites	現在の認証情報でアクセスできる Google Search Console プロパティをすべて一覧表示します。
gsc_get_site	Search Console プロパティを 1 つ取得し、正確な権限レベルを確認します（読み取り専用の sites.get）。
gsc_health_check	トークンを公開せずに、Google Search Console の読み取り専用認証、表示可能なプロパティ、設定済みのデフォルトサイト、権限レベルを確認します。
gsc_query_search_analytics	Google Search Console の検索アナリティクスをクエリします。
gsc_inspect_url	URL の Google インデックス登録状況、クロール情報、モバイル ユーザビリティ、AMP、リッチリザルトを検査します。
gsc_bulk_inspect_urls	保守的な逐次処理上限と正規化された URL 検査結果を用いて、複数の URL を検査します。
gsc_list_sitemaps	Search Console プロパティに送信されたサイトマップを、処理状況と送信済み／インデックス登録済み件数を含めて一覧表示します。
gsc_get_sitemap	フィードの完全なパスを指定して、送信済みサイトマップを 1 つ取得します。種類、取得状態、警告／エラー、送信済み／インデックス登録済みコンテンツの合計を含みます。
gsc_get_sitemap_health	ステータス別合計、送信済み／インデックス登録済みコンテンツの件数、警告、エラーを含む、拡張された読み取り専用のサイトマップ健全性サマリーを返します。
gsc_compare_search_types	Search Console の検索タイプ（ウェブ、画像、動画、ニュース、Discover、Google ニュース）ごとのパフォーマンスを比較します。
gsc_get_data_freshness	直近の日次行をクエリして、検索アナリティクスデータの最新日を検出します。
gsc_monitor_indexation_freshness	検索アナリティクスの鮮度、サイトマップのインデックス登録数、任意の少数の URL 検査サンプルを含む、読み取り専用の監視スナップショットです。
gsc_track_sitemap_deltas	読み取り専用のサイトマップ差分トラッカーです。
gsc_analyze_search_appearance_trends	GSC で利用可能な場合に、Search Analytics の searchAppearance ディメンションを使って構造化データとリッチリザルトの傾向を分析します。
gsc_plan_large_site_sampling	サイトマップのリスクシグナルと検索アナリティクスのページパフォーマンスに基づいて、大規模サイト向けの読み取り専用 URL 検査サンプリング計画を作成します。
gsc_indexation_watchlist	重要な URL 向けの読み取り専用 URL 検査ウォッチリストです。
gsc_find_losses_gains	2 つの期間のクエリまたはページのパフォーマンスを比較し、クリック数／表示回数／CTR／掲載順位の増減を返します。
gsc_cluster_queries	シンプルなトークンと検索意図のシグナル（ブランド／非ブランド、質問、カテゴリ、トピックのトークン）を使って、Search Console のクエリをクラスタリングします。
gsc_detect_cannibalization	Search Analytics のクエリとページの行から、複数のページがクリック数／表示回数を競合しているクエリを検出します。
gsc_validate_query	実行前に、Search Console の指標／ディメンション／検索タイプの組み合わせを検証します。

7 個のリソース

URI	内容
gsc://manifest	このサーバーが公開する内容と、最初に実行するツール
gsc://metrics	検索アナリティクスの 8 つの指標（生データと派生データ）
gsc://dimensions	7 つのディメンションと、それぞれが有効な場所
gsc://filters	5 つのフィルター演算子と、それぞれが受け付ける値
gsc://compatibility	各ディメンションが対応する検索タイプとデータ状態
gsc://recipes	8 つの手順形式のワークフロー
gsc://p2-readonly-playbooks	監視用プレイブックとその不変条件

---

セキュリティ

• クライアントシークレットとリフレッシュトークンは、どのログレベルでもログに記録されず、ディスクにも書き込まれません。
• 失効したリフレッシュトークンは一度だけ報告されます。 Google が invalid_grant を返すと、それ以降のすべての呼び出しで再認証の手順を含む同じメッセージが返され、サーバーは再起動するまで Google にトークンを要求しなくなります。
• プロパティを制限できます。 GSC_SITE_URLS を設定すると、別のプロパティを指定した呼び出しはリクエストを送信する前に拒否され、gsc_list_sites には許可されたプロパティのみが表示されます。
• 接続先は3つのホストのみです。API には searchconsole.googleapis.com と www.googleapis.com、トークンの更新には oauth2.googleapis.com を使用します。ソースに4つ目のホストが現れるとビルドが失敗するテストがあります。
• リダイレクト先へのフェッチは行いません。 すべての送信呼び出しで redirect: "error" を設定しているため、リダイレクトによってベアラートークンやクライアントシークレットが別のホストに転送されることはありません。これを指定しないフェッチがあるとビルドが失敗するテストがあります。
• スコープは webmasters.readonly です。 トークン自体に書き込み権限はありません。
• テレメトリーはありません。 サーバーは Google 以外にはネットワークリクエストを行いません。

ポリシー全文：SECURITY.md。

---

マネージド型のマルチプラットフォーム版をお探しですか？

ローカルサーバーを運用せずにこのソースを利用したい場合は、ホスト型 Search Console をお試しください。 getmcpads は広告、Search Console、GA4 にも、1つの MCP URL を通じて接続します。 利用可能なソースとプランの制限はサイトに記載されています。アカウントの接続は引き続き必要です。

1. Search Console の接続ガイドに従います。
2. アシスタントによる読み取りを許可するアカウントまたはプロパティを選択します。
3. Claude、 ChatGPT、または Codexを接続します。
4. 読み取り専用の分析を試します：「オーガニッククリック数の変化につながったページとクエリを特定してください。データの欠落を明示し、何も変更しないでください。」

有料プランを選ぶ前に、現在のホスト型ツールカタログと 料金をご確認ください。 この Apache 2.0 アダプターは、お客様自身の認証情報を使って、独立して引き続き利用できます。

---

貢献

イシューやプルリクエストを歓迎します。CONTRIBUTING.mdをご覧ください。 セキュリティ関連の報告を行う前に、SECURITY.mdをお読みください。

ライセンス

Apache License 2.0。NOTICEもご覧ください。

Google および Google Search Console は Google LLC の商標です。 このプロジェクトは Google LLC と提携、承認、または後援を受けていません。 公開 API を利用する独立したクライアントです。

MCP コントラクトとデスクトップバンドル

各ツールは、読み取り／書き込みアノテーション、パラメーターの説明、構造化出力スキーマを宣言します。成功した呼び出しではペイロードが structuredContent.result として公開され、エラーでは isError: true が維持されます。生成されたサーバーカードには定義のみが含まれます。

npm run bundle -- /path/to/output を実行すると、現在のカタログから .mcpb デスクトップバンドルをビルドできます。認証情報はインストール時にローカルで入力します。このサーバーは引き続き読み取り専用です。

getmcpads のその他のツール

Meta Ads · Google Ads · Google Analytics 4 · TikTok Ads · Pinterest Ads · X Ads

getmcpadsのEmmanuelがメンテナンスしています。お問い合わせ：[email protected]。