Google Search Console MCP

Google Search Console MCP

English | Русский

A1 Google Search Console MCP 将 AI 应用连接到 Google Search Console。调查搜索表现、检查 URL 是否已编入索引、查看站点地图，并在需要时有意提交或移除站点地图。

它适用于你的 Google 账号可访问的资源。需要注意的是，它使用精确的 Search Console 资源值——网域资源和网址前缀资源是不同的对象。

• 18 个工具。 七个工具用于读取资源、搜索数据、站点地图和索引状态；两个用于添加资源或提交站点地图；三个可移除数据或调用任意 API 方法。
• 在对话中完成连接。 说“连接 Google Search Console”：服务会引导你配置 OAuth 客户端，通过 PKCE 在 127.0.0.1 接收 Google 的重定向，并自行保管令牌——无需配置文件，也无需重启。
• 精确的资源 ID。 https://example.com/、https://www.example.com/ 和 sc-domain:example.com 各不相同。list_sites 会显示要使用的值。
• 带上下文的搜索数据。 按日期、网页、查询、国家/地区、设备或搜索外观查询点击次数、展示次数、点击率和排名。
• 检查索引，而非发布内容。 URL 检查会说明 Google 当前的状态；它不会强制将网页编入索引。

先从只读问题开始：

显示我的资源过去 28 天内点击次数和点击率最高的 20 个搜索查询。

连接服务 · 查看使用场景 · 查看技术文档

一分钟了解其工作方式

你： https://example.com/pricing 已编入索引了吗？如果没有，为什么？

助手： 检查该 URL，并显示索引判定、覆盖范围、抓取信息和规范 URL。不会进行任何更改。

你： 检查我已提交的站点地图，并准备重新提交有错误的那个。

助手： 显示站点地图及其警告和错误，然后在再次提交前请求确认。

你： 确认。

助手： 重新提交所选站点地图。此操作不会更改网页内容，也不保证网页会被编入索引。

目录

• 快速入门
• 可以让它做什么
• Search Console 资源的工作方式
• 可能发生的更改
• 获取访问权限
• 配置
• 数据、限制和后台工作
• 技术文档
• 支持

快速开始

你需要 Node.js 20+ 和一个 Google 账号。安装时无需凭据——服务会在对话过程中连接。

1. 将服务添加到你的 AI 应用。
2. 说“连接 Google Search Console”：助手会引导你创建 OAuth 客户端并批准访问权限，无需编辑配置文件。
3. 从上面的只读问题开始。

codex mcp add google-search-console \
  -- npx -y mcp-google-search-console@latest
codex mcp list

claude mcp add \
  --transport stdio --scope user google-search-console \
  -- npx -y mcp-google-search-console@latest
claude mcp list

{"mcpServers":{"google-search-console":{"command":"npx","args":["-y","mcp-google-search-console@latest"]}}}

{"mcpServers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"]}}}

{"servers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"]}}}

你可以让它做什么

寻找搜索机会

• 本月哪些查询和页面带来了最多点击？
• 与上一时期相比，哪些页面的点击量下降了？
• 显示包含 mcp 且平均排名低于 10 的查询。

检查索引状态和站点地图

• 此 URL 是否已编入索引？显示覆盖范围、抓取和规范网址信息。
• 哪些已提交的站点地图存在错误或警告？
• 显示此站点地图当前状态后重新提交。

谨慎管理资源

• 列出我可以访问的 Search Console 资源。
• 添加此确切的资源值；我会另行验证所有权。
• 确认后从我的账号中移除此资源。

Search Console 属性的工作方式

URL 前缀属性必须包含协议和末尾的斜杠，例如 https://example.com/。网域属性的写法为 sc-domain:example.com。属性值略有不同时会导致 403 或 404，因此请使用 list_sites 返回的确切值。

add_site 只会注册属性。验证仍需在 Search Console 界面或 Site Verification API 中完成。搜索数据使用太平洋时间；end_date 是包含在内的，最终分析数据通常会延迟两到三天。data_state: "all" 可能包含较新的、仍在变化的数据行。

可能发生的变化

AI 客户端控制确认提示。服务会标记读取、写入和破坏性调用，以便客户端区分检查操作与实际更改。

获取访问权限

Google Search Console 要求使用 OAuth 2.0；API 密钥并不足够。可通过两种方式连接，第一种方式无需配置文件。

从聊天中连接（推荐）

说“连接 Google Search Console”，助手就会引导你完成流程：

1. setup_instructions 会打印检查清单：创建或选择 Google Cloud 项目、启用 Google Search Console API、配置同意屏幕并创建 桌面应用 OAuth 客户端。
2. 下载该客户端的 JSON（“Download JSON”），并将其路径提供给助手——set_client 会将其设为仅所有者可访问。机密信息不会经由对话传递。
3. start_login 会返回 Google 授权链接。在此计算机上打开该链接并批准；验证码会返回到 127.0.0.1 上的一次性监听器（PKCE），绝不会经由聊天传递。
4. finish_login 会交换验证码，并将令牌保存到 ~/.config/mcp-google-search-console/credentials.json（权限模式为 0600），然后通过实际调用 Google Search Console API 验证令牌——因此，如果 API 仍处于关闭状态，会立即发现。

每次调用时都会重新读取令牌，因此连接会立即生效，无需重启 AI 应用。auth_status 会显示已连接的账号，logout 会撤销并删除凭据。

环境变量（CI、无人值守安装）

1. 创建或选择 Google Cloud 项目，并启用 Google Search Console API。
2. 配置 OAuth 同意屏幕，并创建 桌面应用 OAuth 客户端。
3. 使用 OAuth 2.0 Playground 中的 Use your own OAuth credentials，授权可访问这些属性的 Google 账号并获取刷新令牌。
4. 使用 https://www.googleapis.com/auth/webmasters 以包含站点地图和属性更改。只有在确实需要只读访问时，才使用 https://www.googleapis.com/auth/webmasters.readonly。

测试模式下的刷新令牌可能会在七天后过期。发布 OAuth 应用，或使用 Internal Workspace 应用，以获得长期访问权限。请将客户端密钥和刷新令牌视为密码。

配置

所有变量均为可选项——即使不设置任何变量，服务也会从聊天中连接。

* 请提供 OAuth 三项配置或访问令牌。

数据、限制和后台工作

• 隐私。 本地服务会调用 Google，并发送匿名遥测数据，其中包含安装 ID、版本和工具名称——绝不会包含 OAuth 令牌、属性数据、工具参数或提示词。设置 ASKADS_TELEMETRY=0 即可选择退出。
• API 限制。 URL 检查每天每个属性最多允许 2,000 次，每分钟最多 600 次。分析每次请求最多返回 25,000 行；长尾匿名查询永远不会返回。请使用分页，不要逐个 URL 检查整个网站。
• 不进行后台监控。 服务仅在被调用时运行。如果你的 AI 应用支持计划任务，可以定期检查站点地图或重要 URL。

技术文档

• MCP 功能目录 — 面向任务的页面，介绍每个工具。
• 所有工具和输入
• 开发文档
• 发布文档
• Google Search Console API

支持

发现了 Bug 或有使用场景需求？创建议题，或在 Telegram 上留言。

你已读到最后！