SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI营销工具mcp-google-search-console

mcp-google-search-console

这是一个连接 AI 应用与 Google Search Console 的 MCP 服务器，让用户可在对话中分析搜索表现、查询点击与展示数据、检查 URL 收录状态，并查看或提交站点地图。它通过 OAuth 2.0 连接，支持从对话完成授权，无需配置文件。共提供 18 个工具，涵盖读取、写入和移除操作。需要 Node.js 20+ 和可访问相应资源的 Google 账号。

访问官网

工具介绍

用途

Google Search Console MCP 是一个 MCP 服务器，用于将 AI 应用连接到 Google Search Console。它让用户可以在与 AI 助手的对话中调查搜索表现、检查某个 URL 是否已被收录、查看站点地图，并在需要时提交或移除站点地图。

主要能力

服务器提供 18 个工具：其中七个工具用于读取属性、搜索数据、站点地图和索引状态；两个工具用于添加属性或提交站点地图；三个工具可以移除数据或调用任意 API 方法。

  • 搜索数据分析：可按日期、页面、查询词、国家、设备或搜索外观查询点击次数、展示次数、点击率（CTR）和平均排名。
  • 收录状态检查：通过 URL 检查了解 Google 当前对某个 URL 的收录状态，包括收录判定、覆盖范围、抓取信息和规范 URL。注意这不会强制页面进入索引。
  • 站点地图管理：查看已提交的站点地图及其警告和错误，并在确认后重新提交；也可按需提交或移除站点地图。
  • 属性管理：列出、添加或移除 Search Console 属性。添加属性仅完成注册，所有权验证仍需在 Search Console 界面或 Site Verification API 中完成。
  • 精确属性标识：域名属性和 URL 前缀属性是不同的对象。例如 https://example.com/、https://www.example.com/ 和 sc-domain:example.com 互相独立，必须使用 list_sites 返回的精确值，否则会返回 403 或 404。

使用方式

需要 Node.js 20+ 和一个 Google 账号。安装时不需要凭据，服务器从对话中完成连接。

  1. 将服务器添加到 AI 应用。在应用设置中添加服务器，使用命令 npx -y mcp-google-search-console@latest。不同 AI 客户端的配置位置可能不同：
    • 某些客户端使用设置 → 扩展，或设置 → MCP 服务器，选择 STDIO 并填入命令和环境变量。
    • Claude Desktop 的旧版构建可回退使用 JSON stdio 配置，macOS 保存到 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 保存到 %APPDATA%\Claude\claude_desktop_config.json。
    • Cursor 可添加到 ~/.cursor/mcp.json（macOS/Linux）或 %USERPROFILE%.cursor\mcp.json（Windows）。
    • VS Code 可运行 MCP: Open User Configuration 并添加配置，用 MCP: List Servers 检查。
  2. 在对话中连接：说“connect Google Search Console”，助手会引导完成 OAuth 客户端创建和授权，无需编辑配置文件，无需重启。
  3. 从只读问题开始，例如：“显示我的属性过去 28 天排名前 20 的搜索查询，包含点击次数和 CTR。”

从对话连接（推荐）

  • setup_instructions 打印检查清单：创建或选择 Google Cloud 项目、启用 Google Search Console API、配置同意屏幕并创建桌面应用 OAuth 客户端。
  • 下载该客户端的 JSON（“Download JSON”）并把路径提供给助手；set_client 以仅所有者可读的方式存储它，密钥不会经过对话。
  • start_login 返回 Google 同意链接。在本机打开并批准；授权码通过 127.0.0.1 的一次性监听器（PKCE）返回，不会经过聊天。
  • finish_login 交换授权码并将令牌保存到 ~/.config/mcp-google-search-console/credentials.json（权限 0600），并用真实的 Google Search Console 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。
  5. 测试模式的刷新令牌可能在七天后过期。发布 OAuth 应用或使用内部 Workspace 应用以获得长期访问。将客户端密钥和刷新令牌视为密码。

所有环境变量均为可选；一个都不提供时，服务器会从对话中连接。需要提供 OAuth 三件套或访问令牌其中之一。

适用场景

  • 查找搜索机会：本月哪些查询和页面带来了最多点击？与上一周期相比哪些页面失去了点击？显示包含 mcp 且平均排名低于 10 的查询。
  • 检查收录状态和站点地图：这个 URL 是否被收录？显示覆盖范围、抓取和规范信息。哪些已提交的站点地图有错误或警告？在显示当前状态后重新提交此站点地图。
  • 谨慎管理属性：列出我可以访问的 Search Console 属性；添加这个精确的属性值（我会单独验证所有权）；确认后从我的账号移除此属性。

限制

  • URL 检查不强制页面进入索引；添加属性不完成所有权验证。
  • 搜索数据使用太平洋时间；end_date 为包含式，最终分析数据通常滞后两到三天。data_state: "all" 可能包含更新、仍在变化的数据行。
  • AI 客户端控制确认提示。服务器标记读取、写入和破坏性调用，以便客户端区分检查和实际更改。
  • 隐私方面：本地服务器调用 Google 并发送匿名遥测，包括安装 ID、版本和工具名称，但绝不包含 OAuth 令牌、属性数据、工具参数或提示。可设置 ASKADS_TELEMETRY=0 退出。
  • API 限制：URL 检查每属性每天限 2,000 次、每分钟 600 次。分析每个请求最多返回 25,000 行；长尾匿名化查询永远不会返回。应使用分页，不要逐 URL 检查整个站点。
  • 无后台监控：服务器仅在调用时工作。如果 AI 应用支持计划任务，可以定期检查站点地图或重要 URL。
  • 需要 OAuth 2.0，API 密钥不够。
  • 该仓库当前发布 npm stdio 包，不包含 .mcpb 捆绑包。
  • 资料中未提供定价信息。

同类工具

查看分类