SS

shin-sibainu/google-search-console-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

29 stars 4 forks 品質 65 トレンド 11MIT

Google検索コンソールAPI用のモデルコンテキストプロトコルサーバー - ClaudeコードとClaudeデスクトップと統合

概要

ClaudeコードとCursorを介してGoogle検索コンソールAPIデータへのプログラム的なアクセスを提供するモデルコンテキストプロトコル(MCP)サーバー。 ステップバイステップセットアップガイドにジャンプして、完全な指示に従ってください。 - あなたがアクセスしているすべての検索コンソールプロパティを取得する - 柔軟なフィルタリングでクエリ検索パフォーマンスデータ - 连续 - ◀ - 取得サイトマップのステータスとインデックス作成の統計 - 特定のURLの詳細なインデックス作成ステータス - Check - Googleをインデックスにするか、URLを削除を要求する - ✓ - 2つの期間間の検索性能を比較 - ️️ - 実用的なガイダンスで詳細なエラーメッセージ - ヒント - ヒント - ハンドル率制限と一時的な障害 - ✅ - すべてのパラメータは、すべてのAPI呼び出し前に有効 - 検索コンソールに登録されたサイト - サイトの所有権検証 - クエリしたい検索コンソールプロパティへのアクセス - GCP プロジェクト(無料ティアは十分です) - 有効 - 認証情報(デスクトップアプリタイプ) - (オプション) は、submit url for indexing を使用する場合に有効です。 REST : GCP の設定のみが必要です.

概要(AI 翻訳)

ClaudeコードとCursorを介してGoogle検索コンソールAPIデータへのプログラム的なアクセスを提供するモデルコンテキストプロトコル(MCP)サーバー。

クイックスタート

このMCPサーバーに新しい? ステップバイステップセットアップガイドにジャンプして、完全な指示に従ってください。

##特徴

  • ANSI リストサイト - あなたがアクセスしているすべての検索コンソールのプロパティを取得する
  • 柔軟なフィルタリングによる検索パフォーマンスデータ
  • 議事録*サイトマップ情報 - サイトマップのステータスとインデックス統計の取得
  • ✓URL検査** - 特定のURLの詳細なインデックス作成状況をチェック
  • 📤 * インデックス作成の URL を省略** - Google をインデックス化または URL を削除
  • ✓ 比較期間** - 2つの期間間の検索性能を比較
  • 🛡️ Robust エラー処理 - 実行可能なガイダンスで詳細なエラーメッセージ
  • 任意の自動リトライロジック** - 処理速度制限と過渡障害
  • ✅Input Validation - API呼び出し前のすべてのパラメータを検証

前提条件

このMCPサーバーを使用する前に、次の操作が必要です。

##1. Google検索コンソール

  • 検索コンソールに登録されたサイト
  • サイト所有権の検証
  • クエリしたい検索コンソールプロパティへのアクセス

##2. Googleクラウドプラットフォーム(GCP)

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Google Search Console MCP Server

A Model Context Protocol (MCP) server that provides programmatic access to Google Search Console API data through Claude Code and Cursor.

Quick Start

New to this MCP server? Jump to Step-by-Step Setup Guide for complete instructions.

Features

  • 🔍 List Sites - Get all Search Console properties you have access to
  • 📊 Search Analytics - Query search performance data with flexible filtering
  • 🗺️ Sitemap Information - Retrieve sitemap status and indexing statistics
  • 🔎 URL Inspection - Check detailed indexing status of specific URLs
  • 📤 Submit URL for Indexing - Request Google to index or remove URLs
  • 📈 Compare Periods - Compare search performance between two time periods
  • 🛡️ Robust Error Handling - Detailed error messages with actionable guidance
  • 🔄 Automatic Retry Logic - Handles rate limits and transient failures
  • ✅ Input Validation - Validates all parameters before API calls

Prerequisites

Before using this MCP server, you need:

1. Google Search Console

  • Site registered in Search Console
  • Site ownership verified
  • Access to the Search Console property you want to query

2. Google Cloud Platform (GCP)

  • A GCP project (free tier is sufficient)
  • Google Search Console API enabled
  • OAuth 2.0 Client ID credentials (Desktop app type)
  • (Optional) Indexing API enabled if you want to use submit_url_for_indexing

💡 Note: You only need to set up GCP once. The CLIENT_ID and CLIENT_SECRET are reusable across multiple sites in your Search Console.

Setup

1. Configure Claude Code

Create .mcp.json in your project root:

{
  "mcpServers": {
    "google-search-console": {
      "command": "npx",
      "args": ["-y", "-p", "google-search-console-mcp-server", "google-search-console-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

⚠️ Important: The args must include all three parts:

  1. "-y" - Auto-confirm npx prompt
  2. "-p", "google-search-console-mcp-server" - Package name
  3. "google-search-console-mcp" - Executable name (different from package name!)

💡 Note: GOOGLE_REDIRECT_URI defaults to http://localhost:8080 and doesn’t need to be specified unless you want to use a different port.

2. Get Google OAuth Credentials

💡 Tip: You can use an existing OAuth 2.0 Client ID from other services (Supabase, Firebase, etc.) or create a new one.

  1. Go to Google Cloud Console
  2. Create or select a project
  3. Enable APIs:
    • Navigate to “APIs & Services” → “Enable APIs and Services”
    • Search and enable “Google Search Console API”
    • (Optional) Enable “Indexing API” if you want to use submit_url_for_indexing
GitHub で README 全文を見る

インストール

npx -y -p google-search-console-mcp-server google-search-console-mcp
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "google-search-console": { "command": "npx", "args": ["-y", "-p", "google-search-console-mcp-server", "google-search-console-mcp"], "env": { "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com", "GOOGLE_CLIENT_SECRET": "your-client-secret", "GOOGLE_REFRESH_TOKEN": "your-refresh-token" } } } }