gsc

gsc-mcp

English | 한국어

适用于 Google Search Console API 和 Google Indexing API 的 MCP 服务，提供完整的 API 覆盖。

需要 Node.js 20 或更高版本，以匹配 MCP SDK 已安装的运行时依赖项。

适用场景

任务	工具
“查看我的网站在哪些查询中获得排名”	search_analytics_query
“通知 Google 某个符合条件的招聘信息或直播 URL”	indexing_publish
“查找存在索引错误的页面”	url_inspection_inspect
“获取过去 30 天的搜索效果数据”	search_analytics_query
“比较移动设备和桌面设备的点击率”	search_analytics_query（按 device 分组）
“向 Google 提交我的站点地图”	sitemaps_submit
“批量通知符合条件的招聘信息／直播 URL”	indexing_batch_publish

致 AI Agent： 请参阅 llms.txt 中的机器可读摘要。将 templates/CLAUDE.md 或 templates/AGENTS.md 复制到项目中，向 Agent 介绍此 MCP。

与其他只封装 searchAnalytics.query 的 GSC MCP 服务不同，此服务提供 Google Search Console 和 Indexing API 中的所有端点。

工具（13 个）

网站

工具	说明
sites_list	列出 Search Console 中的所有网站（资源）
sites_get	获取特定网站的详细信息
sites_add	添加新网站（资源）
sites_delete	移除网站

站点地图

工具	说明
sitemaps_list	列出网站已提交的所有站点地图
sitemaps_get	获取特定站点地图的详细信息
sitemaps_submit	提交站点地图
sitemaps_delete	删除站点地图

搜索分析

工具	说明
search_analytics_query	查询搜索效果数据（点击次数、展示次数、点击率、排名），支持筛选和分组。支持使用 hour 维度查询小时级数据。

URL 检查

工具	说明
url_inspection_inspect	检查 URL 的索引状态、抓取信息、富媒体搜索结果和 AMP 信息（已弃用的移动设备易用性字段可能不存在）

Indexing API

工具	说明
indexing_publish	通知 Google 某个符合条件的 JobPosting 或 BroadcastEvent URL 更新或移除
indexing_get_metadata	获取符合条件的 URL 的最新通知元数据（需要 contentType；不是索引状态）
indexing_batch_publish	批量通知最多 100 个符合条件的 URL，并报告每个嵌入式请求的状态

Indexing API 资格要求： Google 仅对包含 JobPosting 结构化数据的页面，或在 VideoObject 中嵌入 BroadcastEvent 的直播页面支持此 API。工具要求提供 contentType，因此调用方必须指定适用的受支持类型。API 成功响应表示已收到通知，但不保证 Google 已将该 URL 编入索引。请使用 url_inspection_inspect 检查索引状态。请参阅 Google 的 Indexing API 使用指南。

Indexing API 配额

Google 的默认项目级限制为每天 200 个发布请求、每分钟 180 个元数据请求，以及所有端点合计每分钟 380 个请求。每日限额会在太平洋时间午夜重置。包含 100 个 URL 的批次仍会消耗 100 个请求；批处理减少的是连接数，而不是配额用量。发送通知前，请先查看项目的实际配额。请参阅官方配额参考。

身份验证

支持两种身份验证方式：

选项 1：OAuth2 刷新令牌

{
  "mcpServers": {
    "gsc-mcp": {
      "command": "npx",
      "args": ["-y", "@mikusnuz/gsc-mcp"],
      "env": {
        "GSC_CLIENT_ID": "your-client-id",
        "GSC_CLIENT_SECRET": "your-client-secret",
        "GSC_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

所需的 OAuth2 范围：

• https://www.googleapis.com/auth/webmasters
• https://www.googleapis.com/auth/indexing

选项 2：服务账号

{
  "mcpServers": {
    "gsc-mcp": {
      "command": "npx",
      "args": ["-y", "@mikusnuz/gsc-mcp"],
      "env": {
        "GSC_SERVICE_ACCOUNT_KEY_PATH": "/path/to/service-account-key.json"
      }
    }
  }
}

对于 Search Console 读写工具，请将服务账号添加为所有者或具有足够权限的用户。对于 Indexing API 工具，Google 要求将服务账号添加为资源的委派所有者；用户级访问权限并不足够。

设置指南

OAuth2 设置

1. 前往 Google Cloud Console
2. 创建项目（或选择现有项目）
3. 启用 Search Console API 和 Indexing API
4. 创建 OAuth 2.0 凭据（桌面应用类型）
5. 使用 OAuth Playground 生成具有以下范围的刷新令牌：
   • https://www.googleapis.com/auth/webmasters
   • https://www.googleapis.com/auth/indexing

服务账号设置

1. 前往 Google Cloud Console
2. 创建服务账号
3. 下载 JSON 密钥文件
4. 启用 Search Console API 和 Indexing API
5. 在 Search Console 中，将服务账号邮箱添加为您网站的所有者

许可证

MIT