Claude Code 및 Cursor를 통해 Google Search Console API 데이터에 프로그래밍 액세스를 제공하는 모델 Context Protocol (MCP) 서버.

빠른 시작

**이 MCP 서버에 새로운? ** Step-by-Step Setup 가이드로 이동합니다.

특징

• Physics List Sites - 모든 검색 콘솔 속성을 가져가세요.
• Search Analytics - 유연한 필터링으로 Query 검색 성능 데이터
• 過去️ 사이트맵 정보 - 사이트 맵 상태 및 색인 통계
• ☛ URL Inspection - 특정 URL의 상세 색인 상태를 확인
• 지수에 대한 하위 URL - Google을 인덱스로 요청하거나 URL을 제거
• 📈Compare Periods - 두 시간 사이의 검색 성능 비교
• ️ Robust Error Handling - 행동 가능한 지도를 가진 상세한 오류 메시지
• ܧAutomatic Retry Logic - 핸들 속도 제한 및 일시 장애
• ✅ ** 입력 유효성** - API 호출 전에 모든 매개 변수를 검증

필수품

이 MCP 서버를 사용하기 전에, 당신은 필요로 합니다:

##1. 구글 검색 콘솔

• Search Console에 등록된 사이트
• 사이트 소유권 확인
• 쿼리 할 검색 콘솔 속성에 액세스

##2. 구글 클라우드 플랫폼 (GCP)

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