Google Search Console MCP サーバー — AI アシスタント向け検索アナリティクス、URL インデックス管理、サイトマップ管理（SEO / LLMO）

mcp-server-gsc は、Google Search Console 用の MCP（Model Context Protocol）サーバーで、検索パフォーマンスデータを Claude や任意の MCP クライアントに接続します。AI アシスタントが検索アナリティクス（クリック数、インプレッション数、CTR、掲載順位）の照会、URL のインデックス状況やクロール状態の確認、サイトマップの管理を、会話の中で直接行えるようにします。

ツール

Related MCP server: Google Search Console MCP Server

セットアップ

1. ビルド

npm install
npm run build

2. Google Cloud の認証情報

Search Console API を有効にした Google Cloud プロジェクトが必要です （console.cloud.google.com → APIs & Services → Library → 「Google Search Console API」→ Enable）。

次に、以下の 2 つの認証方法のうち いずれか を選択します。

オプション A — OAuth（推奨：自分の Google アカウントでログイン）

1. APIs & Services → Credentials → Create Credentials → OAuth client ID → アプリケーションタイプは Desktop app を選択。

2. プロンプトが表示されたら、OAuth 同意画面を先に設定します（External で問題ありません。自分の Google アカウントをテストユーザーとして追加してください）。

3. クライアント JSON をダウンロードするか、クライアント ID とシークレットをコピーします。

環境変数で設定するか：

GSC_OAUTH_CLIENT_ID=xxxx.apps.googleusercontent.com
GSC_OAUTH_CLIENT_SECRET=GOCSPX-...

または、ダウンロードした JSON を指定します：

GSC_OAUTH_CREDENTIALS=/path/to/client_secret_xxxx.json

最初のツール呼び出し時（または reauthenticate ツール経由）に、Google サインイン用のブラウザウィンドウが開きます。トークンは ~/.config/mcp-server-gsc/tokens.json に保存され、自動的に更新されます。

オプション B — サービスアカウント（ヘッドレス、ブラウザ不要）

1. APIs & Services → Credentials → Create Credentials → Service account を作成し、JSON キーを生成します。

2. Search Console → Settings → Users and permissions で、各プロパティに サービスアカウントのメールアドレス をユーザーとして追加します。

GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

GOOGLE_APPLICATION_CREDENTIALS が設定されている場合、それが優先され、ブラウザログインは使用されません。

3. MCP クライアントへの登録

Claude Code:

claude mcp add gsc \
  -e GSC_OAUTH_CLIENT_ID=xxxx.apps.googleusercontent.com \
  -e GSC_OAUTH_CLIENT_SECRET=GOCSPX-... \
  -- node /path/to/mcp-server-gsc/dist/index.js

Claude Desktop（claude_desktop_config.json）:

{
  "mcpServers": {
    "gsc": {
      "command": "node",
      "args": ["/path/to/mcp-server-gsc/dist/index.js"],
      "env": {
        "GSC_OAUTH_CLIENT_ID": "xxxx.apps.googleusercontent.com",
        "GSC_OAUTH_CLIENT_SECRET": "GOCSPX-..."
      }
    }
  }
}

推奨される SEO / LLMO 向け併用ツール

このサーバーは、SEO / LLMO の用途では以下のツールと組み合わせて使用するのが最適です：

• KeywordGraph MCP サーバー — Search Console のデータをリアルタイムの検索意図データと比較し、トピッククラスター分析を実行して、クエリとコンテンツの知識グラフを構築できます。接続は https://mcp.keywordgraph.com 経由で行います。例：

  claude mcp add --transport http keywordgraph https://mcp.keywordgraph.com

• SEO スキル — 両サーバーの上で高度な SEO / LLMO 分析ワークフローを追加します。

これらを組み合わせることで完全なループが実現します：このサーバーから実際のパフォーマンスデータを取得し、ユーザーが今まさに検索している内容と比較して、トピックのギャップを見つけ、コンテンツを最適化する — 最良の結果を得るには 3 つすべてを併用してください。

使用上の注意

• サイト URL の形式に注意：ドメインプロパティは sc-domain:example.com、URL プレフィックスプロパティは https://example.com/ の形式です（Search Console に表示されているものと正確に一致させてください）。自分のプロパティを確認するには list_properties を使用します。

• データの遅延：Search Console のアナリティクスデータには約 2 日の遅延があります。days ショートカットを使用する場合、期間の終了日は自動的に 2 日前になります。

• 期間指定：アナリティクスツールでは、明示的な startDate / endDate（YYYY-MM-DD）または末尾の days 数（デフォルト 28）のどちらも受け付けます。

• アカウントの切り替え：reauthenticate ツールを呼び出してください — 保存済みトークンが破棄され、ブラウザログインが再度開きます。

• トークンの保存場所は GSC_CONFIG_DIR で上書きできます。

開発

npm run watch   # recompile on change

ソース構成：

• src/index.ts — MCP サーバーとツール定義

• src/auth.ts — OAuth ループバックフロー、トークン永続化、サービスアカウント対応

• src/gsc.ts — Search Console API ヘルパー（クエリ、合計、URL 検査の診断）