Google Search Console MCP Server

Name: Google Search Console MCP Server
Author: guchey

@guchey

代码仓库

关于 Google Search Console MCP Server

暂无概览

基本信息

分类

搜索

许可证

MIT

运行时

python

传输方式

stdio

发布者

guchey

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-google-search-console": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Google Search Console MCP Server?

The Google Search Console MCP Server is a tool that enables AI assistants (via the Model Context Protocol) to retrieve and analyze search performance data from Google Search Console. It is intended for developers and SEO professionals who want to integrate search analytics into AI workflows, providing programmatic access to metrics like clicks, impressions, and rankings.

How to use Google Search Console MCP Server?

Install with pip install mcp-server-google-search-console and set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of your service account JSON key. Start the server with mcp-server-gsc (or uvx run mcp-server-gsc). Configure Claude Desktop by adding a gsc entry to the mcpServers object, specifying the command and environment variable. Use the search_analytics tool with required parameters siteUrl, startDate, and endDate.

Key features of Google Search Console MCP Server

Retrieve search analytics with customizable dimensions
Supports query, page, country, device, and searchAppearance dimensions
Filter by search type (web, image, video, news)
Adjustable aggregation type and row limit
Easy authentication via Google service account credentials

Use cases of Google Search Console MCP Server

Automate weekly SEO performance reports using an AI assistant
Query search analytics data by country or device for targeted analysis
Integrate Google Search Console data into chatbot-based analytics dashboards
Analyze search appearance changes (e.g., AMP, video results) over custom date ranges
Extract top queries and pages for a specific property without manual API calls

FAQ from Google Search Console MCP Server

What are the prerequisites?

Python 3.10 or higher, a Google Cloud project with the Search Console API enabled, and a service account with access to Search Console.

How do I authenticate?

Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of your downloaded JSON key from the Google Cloud Console.

What parameters does the `search_analytics` tool require?

siteUrl (site URL), startDate, and endDate (both in YYYY-MM-DD format). Optional parameters include dimensions, type, aggregationType, and rowLimit.

Can I run the server without installing it?

Yes, using uvx run mcp-server-gsc with optional Python version and environment variable flags.

How do I configure Claude Desktop to use this server?

Add a JSON entry to Claude’s MCP configuration with command: "mcp-server-gsc" and the GOOGLE_APPLICATION_CREDENTIALS environment variable. An alternative using uvx is also provided.