mcp-gsc

属于 DigestSEO 开源 SEO 工具套件的一部分。

• 产品: digestseo.com/gsc-mcp

• 支持: digestseo.com/support

• 隐私: digestseo.com/privacy

自托管启动器以 @digestseo/mcp-gsc 的形式提供：

npx -y @digestseo/mcp-gsc

有关 Google OAuth 和 Cloudflare 部署配置，请参阅 SETUP.md。

30 秒连接

每个已部署的实例都暴露相同的端点结构：

https://<your-worker>.workers.dev/mcp

DigestSEO 托管的实例可在以下位置获取：

https://mcp-gsc.digestseo.com/mcp

Claude Code

claude mcp add --transport http gsc https://<your-worker>.workers.dev/mcp

Cursor

ChatGPT — 将其添加为自定义连接器；请参阅下面的在你的 AI 客户端中连接。

一个可自托管的 Model Context Protocol (MCP) 服务器，用于 Google Search Console。将其连接到 Claude.ai、Cursor、ChatGPT 或任何兼容 MCP 的客户端，然后向你的 AI 助手询问你网站的有机搜索表现——展示次数、点击次数、热门查询、索引状态和站点地图健康状况——直接来自你自己的 Google 账户。

它运行在 Cloudflare Workers 上，并附带一键 Google OAuth 入门：在客户端中连接服务器，使用 Google 登录一次，授予所请求的 Google Search Console 权限，然后完成。无需复制 API 密钥，也无需管理服务账户 JSON。

更喜欢零设置？ 托管版本——自动将每周电子邮件摘要发送到你的收件箱——位于 digestseo.com。此仓库是你可以自行运行的开源核心。

工具

默认情况下（GSC_ACCESS_MODE=readwrite），此服务器暴露 17 个工具。只读分析和报告工具标有 MCP 的 readOnlyHint；下面的写入工具可以更改 Search Console 属性、站点地图或索引状态。设置 GSC_ACCESS_MODE=readonly 以仅请求 Search Console 只读范围并暴露 12 个只读工具。

读写模式请求 Google Search Console 读写和 Indexing API 范围。只读模式仅请求 https://www.googleapis.com/auth/webmasters.readonly（外加 openid 和 email），并且不注册五个写入工具。读写模式仍然是默认模式，以便现有部署保持其当前行为；请参阅 SETUP.md 在连接用户之前选择模式。

indexing.request 资格。 Google 的 Indexing API 不是通用的页面提交工具——截至撰写本文时，Google 自己的文档将其限制为两种内容类型：具有 JobPosting 结构化数据的页面，以及具有嵌套在 VideoObject 内的 BroadcastEvent 结构化数据的直播页面。在提交之前，服务器会获取目标 URL 并检查其 JSON-LD 是否包含这两种类型之一；如果两者都不存在（或无法获取页面），它会返回一个错误，解释该 URL 为何不符合资格，而不是调用 Indexing API。成功提交仅表示 Google 已收到通知——并不保证该 URL 会被索引。

Related MCP server: gsc-mcp

你可以问什么

连接后，你可以向助手询问以下内容：

• "过去 28 天内按点击次数排名的前 20 个查询是什么？"

• "比较 example.com 本月与上月的展示次数——哪些页面下降了？"

• "https://example.com/pricing 是否已被索引？上次抓取是什么时候？"

• "我的博客在哪些查询上排名第 5–15 位？这些是我的快速获胜机会。"

• "给我一份截至今天的 sc-domain:example.com 每周摘要。"

• "我的任何站点地图是否有错误或警告？"

• "使用正则表达式按查询将我的点击分为品牌和非品牌。"

• "我的网站在 Google Discover 与常规网页搜索中的表现如何？"

在你的 AI 客户端中连接

部署服务器后（请参阅 SETUP.md），将你的 Worker 的 /mcp URL 粘贴到客户端中即可连接：

https://<your-worker>.workers.dev/mcp

• Claude.ai — 设置 → 连接器 → 添加自定义连接器 → 粘贴 /mcp URL。将客户端 ID 和客户端密钥留空。首次使用时，Claude 会打开 Google 登录流程；授予部署所请求的访问权限，连接器就会变绿。

• Cursor — 将其添加为指向相同 /mcp URL 的自定义 MCP 服务器。

• ChatGPT（支持连接器/MCP）— 添加一个带有 /mcp URL 的自定义连接器。

任何兼容 MCP 的客户端都可以使用——它们都指向相同的 /mcp 端点并共享相同的 OAuth 流程。

设置

自托管意味着使用你自己的 Google OAuth 凭据和 Cloudflare 账户。完整且可复制粘贴的指南位于 SETUP.md — 包括关于 Google OAuth 验证以及应用未验证时 7 天刷新令牌限制的重要说明。

快速概览：

git clone https://github.com/<you>/mcp-gsc.git
cd mcp-gsc
npm install
cp wrangler.example.jsonc wrangler.jsonc       # then paste in your KV ids
# set GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET / TOKEN_ENCRYPTION_KEY as secrets
# choose GSC_ACCESS_MODE=readonly in wrangler.jsonc for a read-only deployment
npm run deploy

有关每个步骤的详细信息，请参阅 SETUP.md。

开发

npm install
npm test              # typecheck + offline unit tests (what CI runs)
npm run dev           # wrangler dev (local)
npm run test:smoke    # structural smoke tests against a deployment

欢迎贡献 — 请参阅 CONTRIBUTING.md。

许可证

MIT © 2026 DigestSEO.

由 Tomi Šeregi 构建和维护，他是 digestseo.com 背后的构建者——为非技术型网站所有者提供每周 SEO 摘要。