Google Search Console

Google Search Console MCP 服务 — gsc-mcp-full

面向 Google Search Console 的完整 MCP 服务。 用日常语言向 Claude、Cursor、Windsurf、VS Code、Codex 或任何其他 MCP 客户端询问搜索表现、索引和站点地图，并获取分析结果，而不只是一张电子表格。

37 个工具 · 覆盖 Search Console API 的每个端点 · 24 小时视图和每小时数据 · 超过 16 个月的历史数据 · 确保各种语言中的数字准确无误。

快速入门 · 工具 · 语言 · 常见问题 · 完整文档 · 项目页面

适用对象： Claude Desktop · Claude Code · Cursor · Windsurf · VS Code（Copilot Agent 模式）· OpenAI Codex CLI · 任何通过 stdio 或 HTTP 连接的 MCP 客户端。

工具

包含 8 组共 37 个工具。你不必亲自调用它们——用自然语言提问，AI 就会选择合适的工具。

🌍 合并不同拼写形式 · 🗄️ 可处理本地历史数据（任意日期范围）· ✍️ 需要写入权限（GSC_ALLOW_WRITE=1）

📊 搜索效果

🎯 SEO 机会

🌍 多语言洞察

🗄️ 无限历史记录

🔍 编入索引与 URL 检查

🗺️ 站点地图

🏠 资源

🛠️ 实用工具

每个工具的所有参数：工具参考。

快速开始

三个步骤，大约十分钟，免费。你需要一个有权访问 Search Console 的 Google 账号。

1. 创建 Google 凭据

Google 要求所有读取 Search Console 的应用都标识自身，因此你只需创建一次免费的“OAuth 客户端”。

1. 打开 Google Cloud Console 并创建一个项目（名称不限）。
2. 为该项目启用 Google Search Console API。
3. 打开 Credentials → Create credentials → OAuth client ID。如果系统要求，先填写同意屏幕：类型选 External，应用名称不限，邮箱填写你自己的邮箱。
4. 选择 Desktop app，创建客户端，然后下载 JSON。将文件保存在固定位置，例如 ~/gsc/client_secret.json。
5. 在同意屏幕页面点击 Publish app。否则，Google 会每隔 7 天将你登出。个人使用无需审核。

2. 连接你的 AI 客户端

如果你尚未安装 uv，请先安装（该页面提供了一条命令）。它会为你下载并运行服务，无需安装其他内容。

然后将以下内容添加到客户端的 MCP 配置中，并将路径替换为你自己的文件路径：

{
  "mcpServers": {
    "search-console": {
      "command": "uvx",
      "args": ["gsc-mcp-full"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/Users/you/gsc/client_secret.json"
      }
    }
  }
}

claude mcp add search-console -e GSC_CREDENTIALS_PATH=/Users/you/gsc/client_secret.json -- uvx gsc-mcp-full

[mcp_servers.search-console]
command = "uvx"
args = ["gsc-mcp-full"]

[mcp_servers.search-console.env]
GSC_CREDENTIALS_PATH = "/Users/you/gsc/client_secret.json"

3. 登录并提问

在终端中登录一次。浏览器会打开；选择拥有 Search Console 资源的 Google 账号。

export GSC_CREDENTIALS_PATH=~/gsc/client_secret.json
uvx gsc-mcp-full auth      # sign in (if Google warns the app is unverified: Advanced → Continue — it's your own app)
uvx gsc-mcp-full doctor    # should list your properties

重启 AI 客户端并提问：

列出我的 Search Console 资源，然后概述 example.com 的表现。

遇到问题？请参阅故障排查。

可选设置，可添加到 env 配置块中："GSC_TIMEZONE": "Europe/Berlin"，用于生成本地日期报告；如果你的查询大多使用同一种语言，也可以添加 "GSC_LANG": "fa"（或 ar、tr、ja 等）。想用 pip？运行 pip install gsc-mcp-full 即可获得相同的 gsc-mcp-full 命令。

可以尝试的提问

• “为 example.com 生成每周 SEO 报告：整体概况、变化情况，以及最值得把握的三个机会。”
• “自上个月以来，哪些页面的点击量下降了 30% 以上？它们分别失去了哪些查询？”
• “查找关键词蚕食，并告诉我每个关键词应该由哪个页面获得排名。”
• “哪些搜索结果位于第一页，但点击率较低？请推荐更好的标题。”
• “检查这 20 个 URL 是否存在索引问题。”
• “将我的流量拆分为品牌词和非品牌词。品牌词：toyota、تویوتا。”
• “同步 16 个月的历史数据，然后显示包含‘boiler’的查询的每月点击量。”

更多提示词和现成工作流，请参阅：使用指南。

语言

Search Console 会将每个不同的字符串都视为单独的查询。当同一个搜索词可以有多种输入方式时，一个关键词就会变成几条数据量较小的行：

标记为 🌍 的工具会在分析前将这些内容合并，并为每种文字脚本制定相应规则。你看到的文本不会被更改，只有分组方式会改变。分为两个级别：标准级别会合并同一个词的不同输入形式，宽松级别还会合并拼写相近的词。

可识别 26 种文字系统。仅使用英语的网站也不会丢失任何内容：大小写、分隔符和空格差异也会合并，同时 c++、c# 和 .net 仍保持独立，3.5 也绝不会变成 35。

对于中文、日语和泰语，安装额外组件后，top_terms 会使用真正的分词器——uvx --from "gsc-mcp-full[zh]" gsc-mcp-full（或 [ja]、[th]、[all]）。每条规则背后的原理：语言指南。

超过 16 个月的历史记录

Google 会在 16 个月后删除 Search Console 数据，并限制单次请求返回的行数。sync_history 会将每天的数据存储在本地 SQLite 文件中，因此从开始使用当天起，这两项限制都不再适用。

uvx gsc-mcp-full sync example.com --days 480     # first run: everything Google still has
uvx gsc-mcp-full sync example.com --days 7       # daily, from cron: only new days are fetched

所有标记为 🗄️ 的工具都接受 source="history"。详情和 cron 示例：历史记录指南。

配置

设置以环境变量的形式放在客户端的 env 块中。只有第一项是必需的。

命令行

gsc-mcp-full                    # run the server — what your AI client starts
gsc-mcp-full auth [--force]     # sign in with Google
gsc-mcp-full doctor             # check setup and list properties
gsc-mcp-full sync SITE --days N # store history locally
gsc-mcp-full serve --transport streamable-http --port 8000   # serve over HTTP instead of stdio
gsc-mcp-full tools              # print the tool reference

安全

• 除非你另行启用，否则仅限只读。 默认登录方式无法更改 Search Console 中的任何内容。
• 所有内容都保留在你的设备上。 服务在本地运行，只与 Google 通信。登录信息保存在只有你能读取的文件中，且绝不会被记录到日志。
• 写入工具受 GSC_ALLOW_WRITE=1 保护，并且每次调用都会进行检查。
• 搜索查询会被视为数据。 任何人都可以在 Google 中输入任意内容；你的数据中没有任何内容能触发操作。

更多信息请参阅安全指南。如需私下报告漏洞，请参阅 SECURITY.md。

常见问题

有官方的 Google Search Console MCP 服务吗？ 截至撰写本文时（2026 年 10 月），还没有。Google 发布了 Google Analytics 的 MCP 服务，但没有发布 Search Console 的，因此像本项目这样的社区服务会使用 Google 公开的 Search Console API。

它免费吗？ 是的。该服务采用 MIT 许可证开源，Search Console API 不收费，Google Cloud 项目也无需关联结算账号。

它适用于哪些 AI 助手？ 任何 MCP 客户端都可以：Claude Desktop、Claude Code、Cursor、Windsurf、Agent 模式下的 VS Code、OpenAI Codex CLI 等，支持 stdio 或可流式传输的 HTTP。

它会更改或破坏我的网站吗？ 不会。它只读取 Search Console 报告。启用写入权限后，它可以在 Search Console 中添加或移除资源，以及提交或删除站点地图，但不会对你的网站本身进行任何操作。

它与导出到电子表格有什么不同？ 你提出问题，它就返回答案。服务会获取数据、合并拼写变体、执行分析并返回简短表格，同时限制结果大小，避免占满 AI 的上下文。

它支持 Search Console 最新的报告选项吗？ 24 小时视图（按小时显示数据点，包括初步数据）以及按小时、日、周和月汇总的粒度均已支持：使用 hourly_performance 并设置 hours=24，以及在 performance_overview 和 history_trend 中设置 granularity。将网页搜索拆分为基于文本和多模态搜索（Google Lens、Circle to Search）是 Search Console 界面才有的新功能；Google 的 API 尚未返回这类数据，因此任何 MCP 服务都无法提供。

它包含网页索引、Core Web Vitals 或链接报告吗？ 不包含——Google 不通过其 API 提供这些报告，因此任何 MCP 服务都无法提供。检查工具可以查询单个 URL 的索引状态。

数据可以追溯多久？ Google 提供最近 16 个月的数据。开始在本地同步历史数据后，追溯范围不再受限。

我需要懂 Python 吗？ 不需要。uvx 会运行所有内容；你只需编辑一个配置文件。

开发

git clone https://github.com/mamrrez/gsc-mcp-full && cd gsc-mcp-full
uv venv && uv pip install -e ".[dev,all]"
uv run pytest        # no network or credentials needed
uv run ruff check
uv run python scripts/live_check.py   # optional: read-only check of every tool against your own property

欢迎贡献，尤其是语言规则和真实查询示例——请参阅 CONTRIBUTING.md。

相关项目

• gtrends-mcp-full — 配套的 Google Trends MCP 服务：Trending Now、随时间和地区变化的兴趣度、相关搜索、季节性和搜索份额，无需 API 密钥。

许可证

MIT © Mohammadreza Hasanpour

本项目与 Google 无关，也未获 Google 认可。Google Search Console 是 Google LLC 的商标。