mcp-gsc

mcp-gsc

Google Search Console MCP サーバー — 自然言語で検索アナリティクスのクエリを実行し、URL を検査し、サイトマップを管理できます。
Bun + TypeScript で構築されています。Claude、Cursor、あらゆる MCP クライアントで動作します。

---

クイックスタート

1. 認証情報を取得する

Google Cloud Console から OAuth クライアントの認証情報を取得する必要があります。

1. Google Cloud Console にアクセスします

2. プロジェクトを作成します（または既存のプロジェクトを選択します）

3. Google Search Console API を有効にします：

   • APIs & Services → Library → 「Google Search Console API」を検索 → Enable

4. OAuth consent screen を設定します（未設定の場合）：

   • APIs & Services → OAuth consent screen → External
   • アプリ名とメールアドレスを入力し、スコープ https://www.googleapis.com/auth/webmasters を追加します

5. 認証情報を作成します：

   • APIs & Services → Credentials → Create Credentials → OAuth client ID
   • アプリケーションの種類：Desktop app（localhost へのリダイレクトが自動的に許可されます）
   • JSON ファイルをダウンロードします

6. 認証情報のパスを設定します：

export GOOGLE_GSC_CREDENTIALS_PATH=/path/to/credentials.json

7. セットアップを実行して認証します：

npx mcp-gsc setup

ブラウザーが開いて OAuth の同意を求められ、更新トークンが保存され、GSC プロパティへのアクセスが検証されます。その後、MCP クライアント用の設定スニペットが表示されます。

2. Claude Code に追加する

claude mcp add gsc --scope user --transport stdio \
  -e GOOGLE_GSC_CREDENTIALS_PATH=/path/to/credentials.json \
  -- npx -y mcp-gsc@latest

これで完了です。Claude Code を再起動すると、ツールが利用可能になります。

Bun がインストールされていれば、bunx mcp-gsc@latest でも動作します。 npx 経由で実行する場合は Node 22 以降が必要です。

Claude Desktop / Cursor

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "mcp-gsc@latest"],
      "env": {
        "GOOGLE_GSC_CREDENTIALS_PATH": "/path/to/credentials.json"
      }
    }
  }
}

Codex CLI

~/.codex/config.toml に追加します（JSON ではなく TOML です）：

[mcp_servers.gsc]
command = "npx"
args = ["-y", "mcp-gsc@latest"]
startup_timeout_sec = 30
env = { GOOGLE_GSC_CREDENTIALS_PATH = "/path/to/credentials.json" }

Codex の起動タイムアウトはデフォルトで 10 秒ですが、初回の npx の取得には短すぎることがよくあります。startup_timeout_sec を延長する（30 なら安全です）か、パッケージをグローバルにインストールして（npm i -g mcp-gsc）、代わりに command = "mcp-gsc" を使用してください。

サービスアカウント（代替手段）

ブラウザーベースの OAuth を使わずにサーバー間認証を行う場合：

1. Google Cloud Console でサービスアカウントを作成します
2. JSON キーファイルをダウンロードします
3. Google Search Console で、各プロパティにサービスアカウントのメールアドレスをユーザーとして追加します
4. GOOGLE_GSC_CREDENTIALS_PATH にキーファイルのパスを指定します。認証タイプは自動検出されます

ツール（25）

コアツール（常に利用可能）

サイト

ツール	説明
list_properties	権限レベルとともに、すべての GSC プロパティを一覧表示します
get_property_details	プロパティの確認情報、所有権、権限を表示します

検索アナリティクス

ツール	説明
search_analytics	ディメンション、フィルター、ブランド別の分類を指定して、検索パフォーマンス（クリック数、表示回数、CTR、掲載順位）をクエリします

ディメンション：query、page、country、device、date、searchAppearance、hour

タイプ：web、image、video、news、discover、googleNews

注：searchAppearance は query または page と組み合わせることはできません。hour には data_state="hourly_all" が必要です（直近 10 日間のみ）。国コードは ISO 3166-1 alpha-3（usa、gbr、deu）です。

サイトマップ

ツール	説明
list_sitemaps	ステータス、タイプ、インデックス登録数、エラーとともにサイトマップを一覧表示します
get_sitemap	コンテンツの内訳を含む、サイトマップの詳細情報を表示します

URL 検査

ツール	説明
inspect_url	URL のインデックス登録状況、クロール情報、リッチリザルト、正規 URL を確認します
batch_inspect_urls	最大 10 件の URL を一度に検査し、分類された結果を表示します

レート制限：サイトごとに 1 分あたり 600 件、1 日あたり 2,000 件（自動追跡）。

エクスポート

ツール	説明
export_csv	検索アナリティクス全体をローカルの CSV ファイルにエクスポートします（1 回の呼び出しで 25K 行ずつ自動ページネーションし、最大 1M 行まで対応）

拡張ツール（デフォルトでは無効）

GOOGLE_GSC_ENABLE_EXTENDED_TOOLS=true で有効にします：

レポートスイート

ツール	説明
performance_overview	指標の集計と日別の推移
compare_periods	2つの期間を比較し、差分を計算
top_movers	期間間で最も増加・減少した項目
device_country_breakdown	デバイス別および／または国別のパフォーマンス

SEO スイート

ツール	説明
quick_wins	表示回数が多くCTRが低い、上位表示まであと一歩のクエリ（掲載順位4～20位）
cannibalization	同じクエリで競合している複数のページ
opportunity_finder	新たに出現したクエリ、CTRが低いまま表示回数が増加しているクエリ、パフォーマンスが低下している項目
position_tracking	特定のクエリ／ページの掲載順位の推移
ctr_anomalies	掲載順位に対してCTRが異常なクエリ
content_decay	過去のピーク時から表示回数が50％を超えて減少したページ／クエリ
weekly_seo_report	すべてをまとめたレポート：概要＋早期に成果を上げられる項目＋大きく変動した項目

テクニカルSEOスイート

ツール	説明
indexing_coverage	URLを一括検査し、分類されたインデックス登録状況を表示
sitemap_health	サイトマップのエラーパターン、鮮度、インデックス登録済みと送信済みの比率

書き込みツール（デフォルトでは無効）

GOOGLE_GSC_ENABLE_WRITES=true で有効にできます。

ツール	説明
add_site	GSC に新しいサイトを追加
delete_site	GSC からサイトを削除
submit_sitemap	新しいサイトマップを送信
delete_sitemap	サイトマップを削除／送信解除
request_indexing	Indexing API を使って、Google に URL のクロールをリクエスト
get_indexing_status	URL のインデックス登録が最後に送信された日時

Indexing API の前提条件。 最後の2つは、このサーバーの他の機能とは異なる Google API を使用するため、他のツールには不要な次の3つの条件を満たす必要があります。

1. mcp-gsc setup を再実行する — この機能が追加される前に作成された認証情報には、auth/indexing スコープがありません。該当する場合、ツールがその旨を明示します。
2. Google Cloud プロジェクトで Indexing API を有効にする — console.cloud.google.com/apis/library/indexing.googleapis.com
3. Search Console でプロパティの確認済み オーナー であること。フルユーザーのアクセス権では不十分です。

Google が Indexing API の正式なサポート対象としているのは、JobPosting または BroadcastEvent の構造化データを含むページのみで、デフォルトの割り当ては1日あたり200 URLです。この API はクロールをリクエストするものであり、インデックス登録を保証するものではありません。

設定

変数	必須	デフォルト	説明
GOOGLE_GSC_CREDENTIALS_PATH	はい	—	OAuth クライアント JSON またはサービスアカウントキーへのパス
GOOGLE_GSC_TOKEN_PATH	いいえ	自動決定	キャッシュされた OAuth トークンへのパス（デフォルト：認証情報と同じディレクトリにある *_token.json）
GOOGLE_GSC_PROPERTY	いいえ	—	デフォルトのプロパティ URL（例：sc-domain:example.com）。ドメインのみの指定も可能です。
GOOGLE_GSC_ENABLE_WRITES	いいえ	false	書き込みツールを有効にする
GOOGLE_GSC_ENABLE_EXTENDED_TOOLS	いいえ	false	拡張分析ツール（追加13個）を有効にする
GOOGLE_GSC_ENV_FILE	いいえ	.env	.env ファイルへのパス
DEBUG	いいえ	—	デバッグログを有効にする

プロパティの解決： example.com のようにドメインのみを指定できます。サーバーは、確認済みのプロパティと照合して、sc-domain:example.com または https://example.com/ に自動的に解決します。

使用例

AI アシスタントに次のように依頼します。

• 「今月の上位10件のクエリを表示して」
• 「example.com で早期に成果を上げられる項目を探して」
• 「過去3か月間でトラフィックが減少しているページはどれ？」
• 「これらの URL がインデックス登録されているか確認して：url1, url2, url3」
• 「今週のパフォーマンスを先週と比較して」
• 「過去28日間の検索分析データをすべて CSV にエクスポートして」
• 「自分のサイトの週次 SEO レポートを作成して」
• 「キーワードのカニバリゼーションの問題を探して」

今後のツールのアイデア

• コンテンツギャップ分析（競合データとの連携が必要です）
• Core Web Vitals との連携（PageSpeed Insights API 経由）
• 複数プロパティの比較
• 検索での表示に関する詳細分析
• コンバージョンデータ取得のための Google Analytics との連携
• レポートの自動スケジュール設定

更新

npx @latest を使用する場合（推奨）：常に最新バージョンを利用できます。

バイナリを使用する場合：サーバーは起動時に新しいリリースを確認し、古いバージョンの場合は stderr にログを出力します。

mcp-gsc --version

開発

Bun が必要です。

git clone https://github.com/pijusz/mcp-gsc.git
cd mcp-gsc
bun install
bun test           # tests
bun run build      # standalone binary
bun run inspect    # MCP Inspector
bun run check      # biome format + lint

ライセンス

MIT