gsc

gsc-mcp

English | 한국어

Google Search Console API と Google Indexing API の MCP サーバーです。すべての API を網羅しています。

MCP SDK にインストールされるランタイム依存関係に合わせて、Node.js 20 以降が必要です。

使用する場面

タスク	ツール
「自分のサイトがどの検索クエリでランクインしているか確認する」	search_analytics_query
「対象となる求人情報またはライブ配信の URL を Google に通知する」	indexing_publish
「インデックス登録エラーがあるページを見つける」	url_inspection_inspect
「過去 30 日間の検索パフォーマンスデータを取得する」	search_analytics_query
「モバイルとデスクトップのクリック率を比較する」	search_analytics_query（device でグループ化）
「サイトマップを Google に送信する」	sitemaps_submit
「対象となる求人情報／ライブ配信の URL をまとめて通知する」	indexing_batch_publish

AI エージェント向け： 機械可読な概要については、llms.txt をご覧ください。templates/CLAUDE.md または templates/AGENTS.md をプロジェクトにコピーして、この MCP についてエージェントに説明できます。

searchAnalytics.query のみをラップする他の GSC MCP サーバーとは異なり、このサーバーでは Google Search Console API と Indexing API で利用可能なすべてのエンドポイントを公開しています。

ツール（13）

サイト

ツール	説明
sites_list	Search Console のすべてのサイト（プロパティ）を一覧表示します
sites_get	特定のサイトの詳細を取得します
sites_add	新しいサイト（プロパティ）を追加します
sites_delete	サイトを削除します

サイトマップ

ツール	説明
sitemaps_list	サイトに送信されたすべてのサイトマップを一覧表示します
sitemaps_get	特定のサイトマップの詳細を取得します
sitemaps_submit	サイトマップを送信します
sitemaps_delete	サイトマップを削除します

検索アナリティクス

ツール	説明
search_analytics_query	フィルタリングとグループ化を行い、検索パフォーマンスデータ（クリック数、表示回数、CTR、掲載順位）を照会します。hour ディメンションを使った時間単位のデータにも対応しています。

URL 検査

ツール	説明
url_inspection_inspect	URL のインデックス登録状況、クロール情報、リッチリザルト、AMP を検査します（非推奨のモバイルユーザビリティ項目は存在しない場合があります）

Indexing API

ツール	説明
indexing_publish	対象となる JobPosting または BroadcastEvent の URL の更新／削除を Google に通知します
indexing_get_metadata	対象 URL の最新の通知メタデータを取得します（contentType が必要です。インデックス登録状況ではありません）
indexing_batch_publish	対象 URL を最大 100 件まとめて通知し、各リクエストのステータスを報告します

Indexing API の対象条件： Google がこの API に対応しているのは、JobPosting の構造化データを含むページ、または VideoObject に BroadcastEvent が埋め込まれたライブ配信ページのみです。対応するタイプを呼び出し側が指定する必要があるため、ツールでは contentType が必須です。API の応答が成功したことは通知の受信を確認するものであり、Google による URL のインデックス登録を保証するものではありません。インデックス登録状況を確認するには url_inspection_inspect を使用してください。Google のIndexing API 使用ガイドをご覧ください。

Indexing API の割り当て

Google のプロジェクトあたりのデフォルト上限は、公開リクエストが 1 日あたり 200 件、メタデータリクエストが 1 分あたり 180 件、エンドポイント全体で 1 分あたり 380 件です。1 日あたりの上限は太平洋時間の午前 0 時にリセットされます。URL を 100 件まとめて送信しても 100 件分のリクエストを消費します。バッチ処理で削減できるのは接続数であり、割り当ての消費量ではありません。通知を送る前に、プロジェクトの実際の割り当てを確認してください。公式の割り当てリファレンスをご覧ください。

認証

2 つの認証方式に対応しています：

オプション 1：OAuth2 リフレッシュトークン

{
  "mcpServers": {
    "gsc-mcp": {
      "command": "npx",
      "args": ["-y", "@mikusnuz/gsc-mcp"],
      "env": {
        "GSC_CLIENT_ID": "your-client-id",
        "GSC_CLIENT_SECRET": "your-client-secret",
        "GSC_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

必要な OAuth2 スコープ：

• https://www.googleapis.com/auth/webmasters
• https://www.googleapis.com/auth/indexing

オプション 2：サービスアカウント

{
  "mcpServers": {
    "gsc-mcp": {
      "command": "npx",
      "args": ["-y", "@mikusnuz/gsc-mcp"],
      "env": {
        "GSC_SERVICE_ACCOUNT_KEY_PATH": "/path/to/service-account-key.json"
      }
    }
  }
}

Search Console の読み取り／書き込みツールを使用するには、十分な権限を持つ所有者またはユーザーとしてサービスアカウントを追加してください。Indexing API ツールを使用するには、Google の要件により、プロパティの委任された所有者としてサービスアカウントを追加する必要があります。ユーザーレベルのアクセスでは不十分です。

セットアップガイド

OAuth2 のセットアップ

1. Google Cloud Console にアクセスします
2. プロジェクトを作成します（または既存のプロジェクトを選択します）
3. Search Console API と Indexing API を有効にします
4. OAuth 2.0 認証情報を作成します（デスクトップアプリの種類）
5. OAuth Playground を使用して、次のスコープでリフレッシュトークンを生成します：
   • https://www.googleapis.com/auth/webmasters
   • https://www.googleapis.com/auth/indexing

サービスアカウントのセットアップ

1. Google Cloud Console にアクセスします
2. サービスアカウントを作成します
3. JSON キーファイルをダウンロードします
4. Search Console API と Indexing API を有効にします
5. Search Console で、サイトの所有者としてサービスアカウントのメールアドレスを追加します

ライセンス

MIT