searchconsole-mcp

プロジェクト向けに Google Search Console を自動化する MCP サーバー：検索アナリティクス、サイトマップ管理、サイト プロパティ、URL 検査。

ツール

Related MCP server: Google Search Console + GA4 MCP Server

初回の Google セットアップ

1. Google Cloud Console でプロジェクトを作成します。

2. Google Search Console API を有効にします（API とサービス > ライブラリ）。

3. サービス アカウントを作成し（IAM と管理 > サービス アカウント）、JSON キーをダウンロードします。

4. Search Console の各プロパティで 設定 > ユーザーと権限 > ユーザーを追加 に移動し、サービス アカウントのメールアドレス（...@...iam.gserviceaccount.com）を貼り付けて オーナー 権限を付与します（URL Inspection API を使用するにはオーナー権限が必要です）。

設定

環境変数：

サーバーは起動時に作業ディレクトリから .env も読み込みます。

MCP クライアントへの登録

opencode（~/.config/opencode/opencode.json またはプロジェクトの .opencode/opencode.json）：

{
  "mcp": {
    "searchconsole": {
      "type": "local",
      "command": ["node", "/absolute/path/to/searchconsole-mcp/dist/index.js"],
      "environment": {
        "GSC_SERVICE_ACCOUNT_FILE": "/absolute/path/to/service-account.json",
        "GSC_DEFAULT_SITE": "sc-domain:example.com"
      }
    }
  }
}

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "searchconsole": {
      "command": "node",
      "args": ["/absolute/path/to/searchconsole-mcp/dist/index.js"],
      "env": {
        "GSC_SERVICE_ACCOUNT_FILE": "/absolute/path/to/service-account.json",
        "GSC_DEFAULT_SITE": "sc-domain:example.com"
      }
    }
  }
}

開発

npm install
npm run build     # tsc -> dist/
npm start         # run the server on stdio
npm run smoke     # boots the server and lists tools

注記

• アナリティクス データは約 2 日遅れます。最新の部分的なデータも含めるには、dataState: "all" を渡します。

• API は 1 リクエストあたりのアナリティクスの行数を 25,000 行に制限しています。ページングには startRow を使用してください。

• API 経由でサイトを追加した場合、所有権が確認されるまでそのサイトは未確認のままです。最も簡単な方法は、先に UI でサービス アカウントのメールアドレスをオーナーとして追加することです。