Google_search_console

mcp-google_search_console

Google Search Console MCP 工具包

属于 Pipeworx — 一个将 AI Agent 连接到 1879+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供商无关联、未获其认可，也并非由其发布。

工具

工具	描述
gsc_list_sites	列出已连接的 Search Console 账号中的站点（资源），并显示每个站点的权限级别。请先调用此工具，以获取其他工具所需的准确 siteUrl（例如，“https://example.com/”或“sc-domain:example.com”）。
gsc_search_analytics	查询 Search Console 搜索效果数据：点击次数、展示次数、点击率和平均排名，并按维度分组。可用于查询“上个月的热门查询/页面”、自然搜索点击率和排名趋势。siteUrl 必须与 gsc_list_sites 返回的值完全一致。
gsc_list_sitemaps	列出已为某项资源提交的站点地图，包括上次下载时间、警告/错误和已编入索引的数量。可用于检查站点地图状态。
gsc_inspect_url	检查 Google 中某个 URL 的索引状态：覆盖状态、上次抓取时间、规范网址、移动设备易用性和富媒体搜索结果状态。可用于排查页面未被编入索引的原因。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "google_search_console": {
      "url": "https://gateway.pipeworx.io/google_search_console/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/google_search_console/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 的共享元工具 — ask_pipeworx、 discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于此表中的数量：目前，单个工具包端点除了自身工具包的工具，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当天情况的权威依据。

这是有意为之，并非意外复用。元工具可以让限定范围的连接通过 ask_pipeworx 跨整个目录进行路由，从而回答此工具包未涵盖的问题，而无需添加第二个 MCP 服务。目前无法挂载不带这些元工具的工具包端点；如果额外的 schema 占用的上下文超过了路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

你也可以连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1879+ 个数据源。唯一的区别是直接列出的工具包工具不同；无论连接哪个 URL，ask_pipeworx 都可以访问所有工具包的工具。

没有 MCP 客户端？通过 HTTP 调用

此工具包通过已连接的 google_search_console 账号运行，因此需要 Pipeworx 密钥：请在 https://pipeworx.io/account 登录，连接 google_search_console，然后使用 Authorization: Bearer <your Pipeworx key> 调用 POST https://gateway.pipeworx.io/v1/tools/gsc_list_sites。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/gsc_list_sites。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账号）

此软件包也可作为本地 stdio MCP 服务运行 — 无需 Pipeworx 账号，也无需通过网关中转：

{
  "mcpServers": {
    "google_search_console": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-google_search_console"]
    }
  }
}

也可以直接运行，确认服务能否启动：

npx -y @pipeworx/mcp-google_search_console

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具 — 不包含上文网关连接额外提供的共享元工具。相同的源代码、相同的工具，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用简单的英文提问，而不是直接调用工具 — 这既适用于上文的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Google_search_console data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT