Google Search Console MCP Server (mcp-gsc)

什么是 Google Search Console MCP Server (mcp-gsc)？

mcp-gsc 是一个开源的 Google Search Console MCP 服务器，可以把你的 GSC 资源接入 Claude Desktop、Cursor、Codex CLI 等 AI 助手。接入后，你能用自然语言查询点击量、展示次数、索引状态和站点地图。

它是 AminForou 开发的社区版 GSC MCP 服务器，采用 MIT 许可证，用 Python 编写，在 PyPI 上的包名是 mcp-search-console。Google 没有发布官方的 Search Console MCP 服务器。它在本地通过 stdio 运行，并使用你的 OAuth 登录或服务账号调用 Search Console API。

如何使用 Google Search Console MCP Server (mcp-gsc)？

设置分三步：创建凭据、安装 uv、配置客户端。

1. 创建凭据（二选一）。

• OAuth（推荐）：在 Google Cloud Console 中创建或选择一个项目，启用 Search Console API，创建类型为 Desktop app 的 OAuth client ID，然后下载 JSON 文件（例如 ~/Documents/client_secrets.json）。首次使用时会打开浏览器窗口完成 Google 登录，之后令牌会被缓存。
• 服务账号（适合自动化或团队）：启用同一个 API，创建服务账号并下载 JSON 密钥。然后在 Search Console → 设置 → 用户和权限中，把服务账号邮箱添加到你的资源。

2. 安装 uv。推荐用 uvx 运行服务器。它会自动下载服务器并为你管理 Python：

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
echo 'source $HOME/.local/bin/env' >> ~/.zshrc

图形界面应用不会读取你的 shell 配置，所以请在配置中填写 which uvx 输出的完整路径。

3. 配置客户端。编辑配置后，彻底退出应用再重新打开，然后提问：“List my GSC properties”。

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

如果使用服务账号，请把 env 块换成 "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json" 和 "GSC_SKIP_OAUTH": "true"。

Claude Code

README 没有给出本地服务器的 Claude Code 命令。可以用 Claude Code 标准的 claude mcp add 语法注册同一个 stdio 命令：

claude mcp add gscServer -e GSC_OAUTH_CLIENT_SECRETS_FILE=/full/path/to/client_secrets.json -- uvx mcp-search-console

Cursor

在 ~/.cursor/mcp.json 中使用与 Claude Desktop 相同的 JSON。也可以在 Cursor Marketplace 搜索 mcp-search-console 一键安装。该版本内置四个技能：seo-weekly-report、cannibalization-check、indexing-audit 和 content-opportunities。

Codex

添加到 ~/.codex/config.toml：

[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_OAUTH_CLIENT_SECRETS_FILE = "/full/path/to/client_secrets.json" }

如需修改代码，也可以克隆仓库，在虚拟环境（Python 3.11+）中运行 gsc_server.py。

Google Search Console MCP Server (mcp-gsc) 的主要功能

• 列出你有权访问的所有 GSC 资源，以及验证和所有权信息。
• 获取搜索分析数据（查询词、页面、点击量、展示次数、CTR、排名），可按国家、设备、查询词和页面筛选。
• 对比两个日期区间，显示哪些查询词和页面的流量上升或下降。
• 检查单个 URL，或一次批量检查最多 10 个 URL 的抓取和索引状态，包括富媒体搜索结果问题。
• 列出和提交站点地图，并检查其中的错误和警告。
• 支持 OAuth（你自己的 Google 账号）或服务账号，可用 reauthenticate 切换账号。
• 破坏性工具（add_site、delete_site、delete_sitemap）默认关闭，需要设置 GSC_ALLOW_DESTRUCTIVE=true 才能启用。
• 可选 SSE 传输方式，并提供 Dockerfile，用于远程或容器部署。

Google Search Console MCP Server (mcp-gsc) 工具

README 列出了 15 个核心工具。调用 get_capabilities 会返回全部 20 个工具，并显示当前的认证状态。

• 资源：list_properties 和 get_site_details 显示你的站点及详细信息。
• 搜索分析：get_search_analytics、get_performance_overview、get_search_by_page_query、get_advanced_search_analytics 和 compare_search_periods 涵盖热门查询词、页面级搜索词、筛选报告和时段对比。每次请求最多返回 500 行（row_limit）。
• URL 检查：inspect_url_enhanced、batch_url_inspection 和 check_indexing_issues 报告抓取日期、索引结论和索引问题。
• 站点地图：get_sitemaps、list_sitemaps_enhanced 和 manage_sitemaps 显示站点地图状态，也可以提交或删除站点地图。
• 实用工具：get_capabilities 和 reauthenticate。

Google Search Console MCP Server (mcp-gsc) 的使用场景

• 优化标题和描述：“Show me the top 20 search queries for mywebsite.com in the last 30 days, highlight any with CTR below 2%, and suggest title improvements.”
• 诊断流量下降：“Compare my site's performance between January and February. What queries improved the most?”
• 审核索引：“Check these pages for indexing issues: mywebsite.com/product, mywebsite.com/services, mywebsite.com/about”
• 发现接近首页的关键词：“Analyze queries with high impressions but positions below 10, filtered to mobile traffic in the US only.”
• 生成单页报告：“Do a comprehensive inspection of mywebsite.com/landing-page and give me actionable recommendations.”

Google Search Console MCP Server (mcp-gsc) 与替代方案对比

Google 没有官方的 Search Console MCP 服务器，所有选择都来自社区。mcp-gsc 是 GitHub 上 Star 最多的一个（约 1,900 个），并且一直有人维护。

• ahonn 的 Google Search Console MCP Server 是 Node.js 服务器（npm 包 mcp-server-gsc）。它使用服务账号认证，侧重大批量分析数据拉取（最多 25,000 行）、正则筛选和“quick wins”识别。
• saurabhsharma2u 的 Search Console MCP 在一个服务器中整合了 Google Search Console、Bing Webmaster Tools、GA4 和 AdSense。

如果你需要用自己的账号走 OAuth、需要 URL 检查和站点地图工具，并希望用 uvx 简单安装，选 mcp-gsc 即可。

Google Search Console MCP Server (mcp-gsc) 常见问题排查

• spawn uvx ENOENT 或 command not found: uvx：客户端找不到 uvx。把 "command": "uvx" 换成 which uvx 输出的完整路径，例如 /Users/YOUR_NAME/.local/bin/uvx。
• 安装后马上运行 uv --version 提示找不到命令：运行 source $HOME/.local/bin/env，并把它加入 ~/.zshrc。
• 认证失败或找不到凭据文件：请使用 JSON 文件的绝对路径，不要只写文件名。然后让助手“call get_capabilities”，查看具体的认证错误。
• 使用克隆方式时没有出现任何工具：服务器需要 Python 3.11+。由 Claude Desktop 启动时，低版本 Python 会静默失败。请升级 Python 或改用 uvx。
• 在 Claude Desktop 中可用，在 claude.ai 上不可用：该服务器在本地运行，只能在桌面或 CLI 客户端中使用，不能在 claude.ai 网页界面中使用。