Google Search Console Mcp Server

GSC-MCP-Server

Google Search Console MCP サーバー — Google Search Console を Claude、Cursor、その他の MCP クライアントに接続します。

主な機能

• 🔍 検索アナリティクス — クリック数、インプレッション数、CTR、掲載順位のデータを照会します
• 📊 SEO の機会 — CTR の低いキーワードを見つけ、カニバリゼーションの問題を検出します
• 📈 レポート — 週次サマリー、期間比較
• 🗺️ サイトマップ — サイトマップの一覧表示、送信、管理
• 🔎 URL 検査 — インデックス登録状況を確認します（full スコープが必要です）
• 💾 キャッシュ — 繰り返しのクエリを高速化する SQLite キャッシュ
• 🔐 セキュア — OAuth トークンを OS のキーチェーンに保存します

クイックスタート

# Install globally
npm install -g @appsyogi/gsc-mcp-server

# Set up OAuth credentials
gsc-mcp init

# Verify setup
gsc-mcp doctor

# Start the server (for MCP clients)
gsc-mcp run

前提条件

1. Google Cloud OAuth 認証情報を作成する

Google Cloud Console で独自の OAuth 認証情報を作成する必要があります。

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
3. Google Search Console API を有効にします：
   • 「APIs & Services」→「Library」に移動します
   • 「Google Search Console API」を検索します
   • 「Enable」をクリックします
4. OAuth 認証情報を作成します：
   • 「APIs & Services」→「Credentials」に移動します
   • 「Create Credentials」→「OAuth client ID」をクリックします
   • 「Desktop application」を選択します
   • 名前を入力します（例：「GSC-MCP」）
   • 「Create」をクリックします
5. Client ID と Client Secret をコピーします
6. テストユーザーを追加します（アプリがテストモードの場合に必要です）：
   • 「APIs & Services」→「OAuth consent screen」に移動します
   • 「Test users」セクションまでスクロールします
   • 「Add users」をクリックします
   • 認証に使用する Google アカウントのメールアドレスを追加します
   • 「Save」をクリックします

注： アプリの公開ステータスが「Testing」の間は、テストユーザーのみ認証できます。テストユーザーは最大 100 人追加できます。

2. GSC-MCP を設定する

init コマンドを実行し、認証情報を入力します：

gsc-mcp init

これにより、次の処理が行われます：

• Client ID と Client Secret の入力を求めます
• Google 認証用のブラウザーを開きます
• リフレッシュトークンを OS のキーチェーンに安全に保存します

使い方

CLI コマンド

# Initialize with OAuth (interactive)
gsc-mcp init

# Initialize with service account
gsc-mcp init --service-account /path/to/key.json

# Initialize with full scope (for sitemap submission, URL inspection)
gsc-mcp init --scope full

# Check configuration and connectivity
gsc-mcp doctor
gsc-mcp doctor --verbose

# Start MCP server (stdio mode)
gsc-mcp run

# Start in HTTP mode (for debugging)
gsc-mcp run --http 3333

# View current configuration
gsc-mcp config

# Clear credentials
gsc-mcp logout

MCP クライアントの設定

Claude Desktop

Claude Desktop の設定ファイル（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "gsc": {
      "command": "gsc-mcp",
      "args": ["run"]
    }
  }
}

VS Code（Copilot）

VS Code の MCP 設定（~/.vscode/mcp.json またはワークスペース設定）に追加します：

{
  "servers": {
    "gsc": {
      "command": "gsc-mcp",
      "args": ["run"],
      "type": "stdio"
    }
  }
}

Cursor

Cursor の MCP 設定に追加します：

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "@appsyogi/gsc-mcp-server", "run"]
    }
  }
}

利用可能なツール

検索アナリティクス

ツール	説明
searchanalytics.query	ディメンションとフィルターを指定して検索パフォーマンスデータを照会します
report.comparePeriods	2 つの期間を比較します

サイトマップ

ツール	説明	スコープ
sitemaps.list	すべてのサイトマップを一覧表示します	readonly
sitemaps.get	サイトマップの詳細を取得します	readonly
sitemaps.submit	サイトマップを送信します	full
sitemaps.delete	サイトマップを削除します	full

URL 検査

ツール	説明	スコープ
urlInspection.inspect	URL のインデックス登録状況を検査します	full
urlInspection.batchInspect	複数の URL を検査します	full

SEO の機会

ツール	説明
opportunities.lowCtrHighPos	成果につながりやすいキーワード（掲載順位 4～20、CTR 低）を見つけます
opportunities.cannibalization	キーワードのカニバリゼーションを検出します
report.weeklySummary	週次のパフォーマンスサマリーを生成します

エクスポート

ツール	説明
export.csv	データを CSV 形式でエクスポートします
export.json	データを JSON 形式でエクスポートします

LLM の最適化（v0.2.0+）

すべてのツールは、LLM のユースケースでトークン消費を抑えるためのパラメーターに対応しています。

コンパクトなレスポンス形式

任意のツールに format: "compact" を追加すると、LLM 向けに最適化された出力を取得できます。

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-01-01",
  "endDate": "2026-01-28",
  "dimensions": ["query"],
  "format": "compact"
}

コンパクト形式の機能：

• 短いキー名（impressions の代わりに imp、position の代わりに pos）
• CTR をパーセント文字列で表示（0.054123... の代わりに "5.41%"）
• 自然言語による概要フィールド
• ページパスから URL プレフィックスを削除

コンパクトなレスポンスの例：

{
  "summary": "Top query 'example keyword' got 150 clicks at position 3.2",
  "rows": [
    {"key": "example keyword", "clicks": 150, "imp": 2800, "ctr": "5.36%", "pos": 3.2}
  ]
}

日付の集計粒度

日付ディメンションのクエリでは、granularity を使って行数を減らせます。

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2025-07-01",
  "endDate": "2026-01-28",
  "dimensions": ["date"],
  "granularity": "weekly"
}

オプション：

• daily — デフォルト。日ごとのデータを返します
• weekly — 週単位で集計します（月曜日を週の開始日とします）
• monthly — 月単位で集計します
• auto — 日付範囲に応じて選択します（90日超は月単位、21日超は週単位）

デフォルトの行数制限

デフォルトの rowLimit は 25 です（LLM のコンテキストウィンドウに合わせて最適化されています）。必要に応じて、より大きな値を指定してください。

{
  "siteUrl": "sc-domain:example.com",
  "rowLimit": 100
}

最大：25,000 行。

リソース

サーバーは、参照可能なリソースを公開します。

• gsc://sites — すべてのプロパティを一覧表示
• gsc://sites/{siteUrl}/sitemaps — プロパティのサイトマップを一覧表示

スコープ

GSC-MCP は 2 つの権限レベルに対応しています。

読み取り専用（デフォルト）

• 検索アナリティクスのクエリ
• サイトマップの一覧表示
• SEO 分析ツール

gsc-mcp init  # Uses readonly by default

フル

• 読み取り専用のすべての機能に加えて、以下に対応します。
• サイトマップの送信／削除
• URL 検査

gsc-mcp init --scope full

設定ファイル

GSC-MCP は、プラットフォームごとに異なる場所に設定を保存します。

プラットフォーム	設定パス
macOS	~/.config/gsc-mcp/
Linux	~/.config/gsc-mcp/
Windows	%APPDATA%/gsc-mcp/

ファイル：

• config.json — OAuth クライアント ID／シークレット、スコープ設定
• cache.sqlite — クエリキャッシュと保存済みプリセット

利用可能な場合、トークンは OS のキーチェーンに安全に保存されます。

サービスアカウントの設定

自動化やサーバーでの利用には、OAuth の代わりにサービスアカウントを使用できます。

1. Google Cloud Console でサービスアカウントを作成します
2. JSON キーファイルをダウンロードします
3. Google Search Console で、サービスアカウントのメールアドレスをオーナーとして追加します
4. 初期化します。

gsc-mcp init --service-account /path/to/key.json

API クォータ

Google Search Console API のデフォルトのクォータは 1 日あたり 1,200 クエリです。GSC-MCP には以下の機能があります。

• 指数バックオフによる自動再試行
• API 呼び出しを減らすクエリキャッシュ
• 大規模な結果セットのページネーション処理

例

すぐに成果を上げられるキーワードを見つける

Use gsc-mcp to find quick-win opportunities for my site https://example.com

週次レポート

Generate a weekly performance summary for https://example.com

期間を比較する

Compare search performance for https://example.com between last week and the week before

データをエクスポートする

Export the top 1000 queries for https://example.com in the last 28 days as CSV

開発

# Clone the repo
git clone https://github.com/AppsYogi-com/gsc-mcp-server.git
cd gsc-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run in dev mode
npm run dev

# Test locally
node dist/cli/index.js doctor

ライセンス

MIT

貢献

貢献を歓迎します。Issue または PR を作成してください。

クレジット

以下を使用して構築されています。

• @modelcontextprotocol/sdk
• googleapis
• commander
• better-sqlite3