Google Search Console MCP

Google Search Console MCP

用于 Google Search Console 的只读 MCP 服务。五种工具涵盖所有读取功能：资源、Search Analytics（筛选、自动分页以突破 25,000 行上限、小时级数据）、站点地图、URL 检查和带节流的批量检查。我们在生产环境中为每一位 SEO 客户运行此服务。

安装

Claude Code：

claude mcp add gsc -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json -- uvx scalably-gsc-mcp

Codex：

codex mcp add gsc --env GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json -- uvx scalably-gsc-mcp

Claude Desktop：从最新的 GitHub 发布版本下载 gsc-mcp.mcpb 并打开。

设置

1. 在 Google Cloud 中创建或选择一个项目，并在其中启用 Google Search Console API（APIs and Services、Library）。
2. 在该项目中创建服务账号并下载其 JSON 密钥。
3. 将服务账号的电子邮件地址添加为你要查询的每个 Search Console 资源的用户（Settings、Users and permissions）。完全权限和受限权限都可用于读取。

无需 OAuth 同意屏幕；此服务使用 webmasters.readonly 范围，以服务账号进行身份验证。

工具（5 种）

工具	功能
gsc_list_sites	列出服务账号可读取的 Search Console 资源
gsc_query_search_analytics	使用筛选条件、自动分页和小时级数据查询 Search Analytics
gsc_list_sitemaps	列出某个资源的站点地图，或读取其中一个站点地图
gsc_inspect_url	检查单个 URL 的索引状态
gsc_batch_inspect_urls	使用客户端节流检查多个 URL

配置

变量	必需	用途
GOOGLE_APPLICATION_CREDENTIALS	是	包含 Search Console 只读范围的 Google 服务账号 JSON 文件路径；将每个资源共享给该服务账号的电子邮件地址
GSC_LOG_LEVEL	否	INFO（默认值）或 DEBUG
GSC_RETRY_BASE_SECONDS	否	针对瞬时 API 错误的重试退避基础延迟，单位为秒（默认值为 1）
GSC_WEBMASTERS_BASE、GSC_SEARCHCONSOLE_BASE	否	覆盖两个 Google API 基础 URL（测试套件用于指向本地模拟服务；正常使用时请保持未设置）
GSC_TEST_ACCESS_TOKEN	否	仅供测试套件使用：用于绕过服务账号的字面 bearer token。正常使用时切勿设置

回复格式

每个工具都会返回包含 status（succeeded、partial、no_op）、operation、summary、target、result、proof、warnings、recovery 的 JSON。失败会显示为工具错误，文本格式为 <code>: <message> <hint>。partial 状态中若包含 proof.nextStartRow，则表示应从该行继续。

限制

每次 Search Analytics 调用最多返回 25,000 行（服务会自动分页，最多至 max_rows）。URL 检查：Google 对每个资源的限制为每分钟 600 次、每天 2,000 次。服务会在客户端对批量检查进行速率控制（默认每秒 8 次请求），并在批次超过每日配额时发出警告；它不会跨调用跟踪每日用量，因此请自行记录。

验证

每个发布版本都会在 CHANGELOG.md 中列出软件包版本、.mcpb 的 sha256，以及其所基于的生产提交。CI 会在每次推送时运行测试，并对构建的 wheel 执行全新安装。

隐私政策

此服务在你自己的机器上本地运行，并使用你自己的凭据。它不收集个人数据，不含遥测功能，不会持久存储任何内容，只会与其封装的供应商 API 通信。包括 Scalably 在内的任何第三方都不会收到你的数据。联系方式：[email protected]。规范版本：https://scalably.io/connector-privacy.html

许可证

MIT。版权所有：Scalably。