# @digestseo/mcp-gsc 中文文档

规范地址：https://npmcn.com/package/%40digestseo/mcp-gsc/

版本：0\.4\.41
npm 元数据更新时间：2026-11-11T14:36:35.131Z
中文译文更新时间：2026-11-14T15:48:23.437Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40digestseo/mcp-gsc
原文对照：https://npmcn.com/package/%40digestseo/mcp-gsc/?lang=original
项目主页：https://digestseo.com/gsc-mcp/
源码仓库：https://github.com/AKzar1el/mcp-gsc

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：397 kB，31 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：^22\.18\.0 \|\| \>=24\.11\.0
- 运行依赖：5 个
- 首次发布：2026-07-27T17:25:37.479Z
- 最新版本发布：2026-11-11T14:36:34.640Z
- 近 30 天下载量：1994（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：43（近 12 个月 43 个）

## 中文简介

自宿Google搜索控制台MCP服务器用于分析,URL检查,站点地图,索引,以及SEO报告Cloudflare Workers.

## 安装

```sh
npm install @digestseo/mcp-gsc
```

也可以使用：`pnpm add @digestseo/mcp-gsc`、`yarn add @digestseo/mcp-gsc`、`bun add @digestseo/mcp-gsc`

## README

# 缩写

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://npmcn.com/package/%40digestseo/mcp-gsc/LICENSE) [![MCP](https://img.shields.io/badge/MCP-remote%20server-8A2BE2)](https://modelcontextprotocol.io/) [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.AKzar1el%2Fmcp--gsc-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.AKzar1el/mcp-gsc) [![CI](https://github.com/AKzar1el/mcp-gsc/actions/workflows/ci.yml/badge.svg)](https://github.com/AKzar1el/mcp-gsc/actions/workflows/ci.yml) [![npm version](https://img.shields.io/npm/v/%40digestseo%2Fmcp-gsc.svg)](https://www.npmjs.com/package/@digestseo/mcp-gsc) [![mcp-gsc MCP server](https://glama.ai/mcp/servers/AKzar1el/mcp-gsc/badges/score.svg)](https://glama.ai/mcp/servers/AKzar1el/mcp-gsc)

部分 **[文摘社](https://digestseo.com/)** 一套开源的 SEO 工具.

-   产品 : [digitseo.com/gsc-mcp (中文(简体) )](https://digestseo.com/gsc-mcp/)
-   工程案例研究: [文摘SEO MCP 套件——AI能见度,搜索控制台,网络验证和趋势智能](https://tomiseregi.si/projects/digestseo-mcp-suite)
-   支助: [documentseo.com/ support (英语)](https://digestseo.com/support/)
-   隐私 : [digitseo.com/ 隐私](https://digestseo.com/privacy/)

自宿发射装置作为 [`@digestseo/mcp-gsc`](https://www.npmjs.com/package/@digestseo/mcp-gsc)。对于新的分析/只报告连接,明确以只读模式开始:

```bash
GSC_ACCESS_MODE=readonly npx -y @digestseo/mcp-gsc
```

在 Windows PowerShell 上,使用 `$env:GSC_ACCESS_MODE = 'readonly'` 接下来是 `npx -y @digestseo/mcp-gsc` 换句话说 提供您自己的 Google OAuth 和加密设置 [钢筋混凝土](https://npmcn.com/package/%40digestseo/mcp-gsc/SETUP.md) 在启动任一命令之前.

Npm 发射器只启动回放 **可流取的 HTTP** 员工在 `127.0.0.1` (开口) `8080` 它不是一个 stdio MCP 进程。 你可以运行 `npx` 命令来自任意目录,因为发射器从已安装的软件包中解析其捆绑的工人配置。 启动软件包的客户端应当连接到 `http://127.0.0.1:8080/mcp` 提供了 Google OAuth 和 符号加密环境变量后 [钢筋混凝土](https://npmcn.com/package/%40digestseo/mcp-gsc/SETUP.md)。发射装置在开始Wrangler之前退出,如果 `GOOGLE_CLIENT_ID`, (中文(简体) ), `GOOGLE_CLIENT_SECRET`,或 `TOKEN_ENCRYPTION_KEY` 缺少或空白,它也拒绝非空白 `TOKEN_ENCRYPTION_KEY` 除非是有效的 Base64 将代码解码为32 字节。 错误只识别无效或缺失的设置, 绝不是它的秘密值, 因此一个损坏的 OAuth 会话没有启动 。 它在儿童进程环境中保留了秘密值, Wrangler 通过已声明的本地机密加载它们; 它们的值不被复制到 Wrangler 中 `--var` 命令行参数。 在第一个 OAuth 登录之前, 授权精确的回调 `http://127.0.0.1:8080/google/callback` 在Google Cloud中(或使用相同的自定义) `PORT` ; 发射器在启动时打印两个URL.

**Docker/Glama网络绑定.** 寻常 `npx` 发射装置默认情况下只保留回回转( s)`MCP_GSC_BIND_IP=127.0.0.1`) (中文(简体) ). Docker 图像明确设置 `MCP_GSC_BIND_IP=0.0.0.0` **在容器内**,因为 Docker 端口转发无法只到达容器的回路接口。 当在您的计算机上发布 Docker 端口时, 偏好 `-p 127.0.0.1:8080:8080` 以限制主机访问;仅在主机外暴露它时才有适当的HTTPS/OAuth部署配置和授权的Google重定向URI. `MCP_GSC_BIND_IP` 仅接受 `127.0.0.1` 或者说 `0.0.0.0`;不要对本地 npm 普通使用使用全接口绑定.

本地 KV 和持久对象状态, 包括加密的 Google 会话, 存储于 `~/.mcp-gsc/state` 默认,而不是在已版本 npm 缓存内。 这使得本地连接在软件包升级和普通npm缓存清理中保持可用. 设定 `MCP_GSC_STATE_DIR` 要使用另一个目录; 保留相同的 `TOKEN_ENCRYPTION_KEY` 当重用已有状态时, 因为存储的刷新符被加密 。 发射台在启动时打印有效的状态目录. 有了这个稳定路径的首次发布可能需要一次Google重联,因为更古老的出發器会将存储在npm包缓存下的地方状态放出.

发射器的 **隐性倒置** 遗 物 `GSC_ACCESS_MODE=readwrite` 用于向后兼容。 上面只读命令和检查的自寄模板明确选择 `readonly`:Google OAuth随后只请求只读搜索控制台范围,而6个变异工具仍未注册. 选择到 `readwrite` 仅针对实际需要修改搜索控制台属性,站点映射或符合条件的索引API URL的工作流程.

Google OAuth 和 Cloudflare 的部署配置, 请遵循 [钢筋混凝土](https://npmcn.com/package/%40digestseo/mcp-gsc/SETUP.md)。 。 。 .

### 连接本地发射装置

对于当前已核实的快速连接路径,请提供Google OAuth和符号加密环境变量 [钢筋混凝土](https://npmcn.com/package/%40digestseo/mcp-gsc/SETUP.md),然后使用上面适当的只读命令(或故意选择)启动 npm 发射器 `readwrite` 工作流程的特殊性.

然后将您的 MCP 客户端连接到启动器的回路端 :

```
http://127.0.0.1:8080/mcp
```

自办云旗 继续使用工人部署 `https://<your-worker>.workers.dev/mcp`. Repo目前没有作为快速连接路径广告发布所有者托管的远程,因为其部署的工具合同是发布软件包的后盾.

**克劳德代码**

```bash
claude mcp add --transport http gsc http://127.0.0.1:8080/mcp
```

**OpenAI 代码 CLI / IDE**

```bash
codex mcp add gsc --url http://127.0.0.1:8080/mcp
```

Codex CLI和Codex IDE扩展共享MCP配置,因此注册服务器一次就能使两个客户端都能使用相同的本地连接. 在使用连接前启动 npm 启动器; 当需要认证时, Codex 会打开服务器的 OAuth 流量 .

**视觉工作室代码( GitHub 副驾驶)**

[![Add GSC MCP to VS Code](https://img.shields.io/badge/VS_Code-Add_GSC_MCP-007ACC?logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=gsc&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22http%3A%2F%2F127.0.0.1%3A8080%2Fmcp%22%7D)

按钮只添加本地可流 HTTP 连接; 它确实 **没有** 启动 npm 启动器或配置 Google OAuth 。 跟随 [钢筋混凝土](https://npmcn.com/package/%40digestseo/mcp-gsc/SETUP.md) 启动上面的发射器 **同台机器** 在连接和签名前作为 VS 代码。 远程 VS 代码环境无法到达您的计算机 `127.0.0.1` 终点.

**光标**

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=gsc&config=eyJ1cmwiOiJodHRwOi8vMTI3LjAuMC4xOjgwODAvbWNwIn0%3D)

当此寄存器被安装为光标插件时, Cursor 也会自动发现三个捆绑的代理技能,这些技能将 MCP 工具编成证据安全的工作流程: `gsc-weekly-review`, (中文(简体) ), `gsc-indexing-triage`,以及 `gsc-search-opportunities`编辑 **添加到光标** 按钮只安装 MCP 连接; 捆绑的技能是存储器 Cursor 插件包的一部分.

上面的按钮和插件MCP配置是用于Cursor运行在和npm发射器相同的机器上. **光标云代理在孤立的云中运行,所以无法到达 `127.0.0.1` 在你的电脑上.** 对于"云"代理人,部署你自己的可对外接触的"HTTPS"工作人手并添加其 `/mcp` 来自 MCP 控制的 URL 时间 [光标.com/代理](https://cursor.com/agents); Cursor支持HTTP MCP服务器和OAuth在那里. 不要为 Cloud Agent 重用回转 URL .

**GitHub 副驾驶 CLI**

```bash
copilot plugin marketplace add AKzar1el/mcp-gsc
copilot plugin install mcp-gsc@digestseo
```

市场路径使得插件可以通过Copproject的市场工作流程来发现并更新. 直接存储器安装也仍然得到支持 `copilot plugin install AKzar1el/mcp-gsc`。“副驾驶”插件将相同的三个代理技能加本地回路的MCP配置捆绑起来。 在使用插件的 MCP 服务器前启动 npm 启动器; 插件不会为您启动或部署 mcp- gsc .

**双子座CLI**

```bash
gemini extensions install https://github.com/AKzar1el/mcp-gsc
```

双子座 CLI 扩展捆绑已验证的本地回路 MCP 配置外加相同的三种代理技能: `gsc-weekly-review`, (中文(简体) ), `gsc-indexing-triage`,以及 `gsc-search-opportunities`。在使用扩展前启动 npm 发射器;扩展不会为您启动或部署 mcp-gsc .

**基罗**

[![Add to Kiro](https://kiro.dev/images/add-to-kiro.svg)](https://kiro.dev/launch/mcp/add?name=mcp-gsc&config=%7B%22url%22%3A%22http%3A%2F%2F127.0.0.1%3A8080%2Fmcp%22%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D)

在使用安装按钮或副驾驶插件前启动 npm 启动程序 。 完成Google OAuth流量的首次使用.

**聊天游戏** —— ChatGPT 无法直接连接到这个回路 `127.0.0.1` 终点 供私人/当地使用,创建 OpenAI **安全 MCP 隧道**运行 `tunnel-client` 和发射装置在同一台机器上 `http://127.0.0.1:8080/mcp`;在创建 ChatGPT 应用程序时,选择 **隧道** 连接并选择隧道。 隧道设置需要 OpenAI `tunnel_id` 和运行时间 API 密钥; 参见 OpenAI 的 [安全磁共振 隧道指南](https://developers.openai.com/api/docs/guides/secure-mcp-tunnels). 该地道保留了 MCP 服务器的私密性,用于私人/开发者-模式连接,而不是公共插件发行.

或者, 部署您自己的远程 Cloudflare 工人并添加其 HTTPS `/mcp` URL 在开发者模式中作为自定义的 MCP app; 见 [在您的 AI 客户端中连接](https://npmcn.com/package/%40digestseo/mcp-gsc/#readme-connect-in-your-ai-client) 见下文.

自相残杀 [示范背景协议](https://modelcontextprotocol.io/) (MCP)服务器 **谷歌搜索控制台**连接到 Claude.ai, Cursor, ChatGPT 或任何与MCP相容的客户端,并询问您的AI助手您网站的有机搜索性能——印象,点击,顶级询问,索引状态,以及站点映射健康——直接来自您自己的Google账户.

它继续运行 [云花岗工人](https://workers.cloudflare.com/) 和载有 Google OAuth 登入的船舶: 连接您客户端的服务器, 检查用于识别请求的 MCP 客户端和权限的 mcp- gsc 同意页, 然后与 Google 签名并授予请求的 Google 搜索控制台权限 。 没有可以复制的 API 密钥, 也没有服务账户 JSON 管理 .

## 工具

默认( E)`GSC_ACCESS_MODE=readwrite`),这个服务器暴露出23个工具. 仅读分析工具和报告工具被标记为 MCP `readOnlyHint`;下面的写工具可以改变搜索控制台属性,站点映射,或索引状态. 设定 `GSC_ACCESS_MODE=readonly` 只请求搜索控制台只读范围,并曝光不需要写入访问或单独的索引API范围的16个工具.

| 工具 | 访问 | 它会做什么 |
| --- | --- | --- |
| **`server.capabilities`** | 读取 | 列出服务器曝光的每一个工具,并报告本地的Google认证状态. `connected` 表示存在存储的刷新证书; 反应也暴露 `auth_status_basis` 财务报告和审定财务报表 `provider_auth_live_verified: false` 因为这个发现电话没有探测到谷歌 后期的Google工具调用仍然需要重新连接,如果证书过期或被取消. 没有争论. |
| **`sites.list`** | 读取 | 列出连接的 Google 账户可访问的搜索控制台属性(`siteUrl`, (中文(简体) ), `permissionLevel`) (中文(简体) ). |
| **`sites.get`** | 读取 | 获取一个精确的搜索控制台属性以及连接账户的许可级别 . |
| **`analytics.query`** | 读取 | 印象,点击,CTR,和一个日期范围内的平均位置,有尺寸,过滤,安全页码,以及可选择的搜索类型. 过 `dimensions: []` ; Google 的汇总行可能会省略 `keys`。搜索分析并不能保证每个数据行,只能返回上行,因此,穷尽本地的页码并不能证明提供者数据集是详尽无遗的. `data_state: "all"` 可以包括新的初步数据,同时 `final` 返回仅最后确定的数据;回声 `data_state` 加号 `preliminary_data_possible`,和日期/小时分组保存 Google 返回时的不完整数据边界元数据。 搜索外观发现是一个双步工作流程: 组由 `searchAppearance` 仅用于发现 Google 属性返回的准确值,然后在按页面/query/country/device/date/hour分组时过滤到一个单独的查询中返回的值. 对于 `search_type: "discover"` 或者说 `"googleNews"`, (中文(简体) ), `position_supported` 实值 `false`; 这些报告会显示点击、 印象和 CTR 而不显示一般位置, 因此返回行可以省略 `position`,而查询组/过滤则不可用。 搜索控制台的专用Generative AI性能报告不会被当前所记录的搜索分析API作为专用搜索类型或过滤选择器被曝光; `generative_ai_report_isolatable` 因此为 `false`。搜索控制台的新网络多模式 UI 过滤器同样不作为文件记录的搜索分析API选择器被曝光; `multimodal_report_isolatable` 因此为 `false`。 。 。 . |
| **`insights.page_queries`** 编号 : **`insights.query_pages`** | 读取 | 从一个精确的页面钻到它的搜索控制台查询,或者从一个精确的查询到Google为此浮出水面的页面,带有 `row_limit` 编号 : `start_row` 帕吉纳 这些以查询为中心的帮助者支持网络,图像,视频,以及"搜索结果"新闻分页;"发现"和"Google新闻"报告因不披露查询数据而被排除在外. |
| **`urls.inspect`** | 读取 | Google的URL检查报告,指目前在Google索引中已知的一页版本. 这不是现场URL测试;移动可用性输出被贬值. |
| **`urls.inspect_many`** | 读取 | 检查Google的索引版本,在保留输入顺序结果的同时,一个调用中按顺序排列了最多10个URL. 每个URL仍然会消耗一个Google URL检查请求和一个服务器共享检查安全预算的单位;这不会运行活的URL测试. |
| **`sitemaps.list`** 编号 : **`sitemaps.get`** | 读取 | 列出提交的站点地图或检索一个站点地图的细节. `lastSubmitted` 站点映射提交搜索控制台时; `lastDownloaded` 是谷歌上次下载网站地图时。 网站映射文件的修改/部署时间或页面爬行/索引时间戳都不是值. |
| **`insights.quick_wins`** 编号 : **`insights.cannibalization`** 编号 : **`insights.content_decay`** | 读取 | 表面平均位置机会行,查询/页面重叠,并按证据排序的点击下降. 快速取胜的候选人被观测到由聚合搜索控制台平均位置选择的查询/页面行,而不是一个稳定的当前排名的证明,CTR是上下文而非资格过滤. Cannibalization候选总数/份额的范围是观测到的查询/页面行,而不是真正的查询级属性总数;内容-decay结果只比较两个期间返回的页面,不会将单行缺行变为零流量. |
| **`indexing.list_pages`** 编号 : **`analytics.compare`** | 读取 | 分析接收Search Console印象的页面并比较两个时段,可选择使用同一时段的查询类型和查询/页面/国家/设备/搜索-出现过滤器. `analytics.compare` 仅比较两个期间回复中返回的维度键;一个非详尽的搜索分析响应中缺少的密钥不被认为是零度量. 它默认会最终完成搜索分析行 `data_state=final`保护Google省略了..`dataState` 行为; 通过 `all` 明确需要近期初步能力行。 由于其比较合同包括了平均位置,因此不包括"发现"和"谷歌新闻". `indexing.list_pages` 是性能数据,而不是索引覆盖: 缺少的 URL 可能仍然被索引; 使用 `urls.inspect` 编号 : `urls.inspect_many` 用于 URL 级索引状态. |
| **`reports.weekly_digest`** | 读取 | 制作平话7天业绩报告 有移动者,上页,以及一个推荐的行动. 查询移动器只比较两个周刊"搜索分析"结果集中返回的行;由于Google没有保证每个数据行,因此一个限定响应中缺失的查询不作为零处理. |
| **`sites.add`** 编号 : **`sites.delete`** | 写入 | 从连接账户的搜索控制台站点设置中添加或删除一个属性 . `sites.add` 返回时 `ownership_verification_performed: false` 因为所有权验证是一个单独的Google站点验证/搜索控制台工作流程. `sites.delete` 从该账户的"搜索控制台"站点设置中去除属性;它不删除网站本身. |
| **`sitemaps.submit`** 编号 : **`sitemaps.delete`** | 写入 | 提交或删除一个站点地图. |
| **`indexing.status`** | 读取 | 读取谷歌最新成功的索引API `URL_UPDATED` 编号 : `URL_DELETED` 先前提交的URL的通知收据。 这仅仅是通知元数据,而不是索引覆盖,爬行状态,索引完成,或删除完成. 这需要 `GSC_ACCESS_MODE=readwrite` 因为Google的元数据端点使用索引API OAuth范围. |
| **`indexing.request`** | 写入 | 通过Google的索引API请求索引. Google 目前将此API限制在包含 `JobPosting` 结构化数据或含有 `BroadcastEvent` 内部 `VideoObject`它不供一般网页使用。 Google的记录默认是200个发布请求/日/项目由更新和去除共享. 符合条件的内容类型,API授权,配额限制和垃圾邮件政策仍然适用;这一配额不允许提交其他页面类型或超过Google的限制. |
| **`indexing.remove`** | 写入 | 请求a `URL_DELETED` 通知先前符合资格的 API 页面。 在移除前, URL 必须返回 HTTP 404/410 或曝光机器人 `noindex` 元指令 。 Google的收件没有证明删除完成;使用URL检查来获取索引状态的证据. |

搜索分析日历日期( E)`start_date`, (中文(简体) ), `end_date`,并使用比较周期日期)使用Google的太平洋时间日历(Google's Pacific Time Calendum)`America/Los_Angeles`,UTC-8/UTC-7,视省日出时间而定),不是呼叫者的本地时区或UTC. 这也制约了服务器生成/默认搜索分析日期范围.

> **平台属性.** Search Console现在在其UI中支持用于Instagram,TikTok,X等社交/视频账户的平台属性. 谷歌当前搜索控制台 API 文档仍然定义 `siteUrl` 使用 URL 前缀和 `sc-domain:` 网站产权表,不发布平台产权API标识合同. `sites.list` 因此保留了Google的每一个标识符返回,并标记它是否与所记录的API语法相匹配;其他工具故意拒绝无记录的表格而不是发明标识符. 在 Google 文档 API 支持之前, 使用搜索控制台 UI/ 导出平台属性 .

Read-write模式请求Google搜索控制台读取并索引API范围. 只读模式请求 `https://www.googleapis.com/auth/webmasters.readonly` (单位:千美元) `openid` 财务报告和审定财务报表 `email`)而不注册六个写工具或只读工具 `indexing.status` 搜索,因为搜索仍然需要 Google 单独的索引API范围。 读写仍为默认值, 因此现有部署保留其当前行为; 见 [钢筋混凝土](https://npmcn.com/package/%40digestseo/mcp-gsc/SETUP.md) 在连接用户之前选择模式.

大型分析响应在MCP边界被限制,而不是生成,然后被结构化内容限制的客户抛弃. 列表式工具曝光 `start_row` 编号 : `next_start_row` 酌情; 排名分析工具曝光 `limit`, (中文(简体) ), `start_row`,以及 `result_page` 元数据包括 `has_more`, (中文(简体) ), `truncated`,以及 `byte_limit_reached`时继续呼 `has_more` 而不是假设一个答复是完整的.

> **将API的资格和配额指数化.** Google的索引API不是一个通用的页面提交工具——截至此写作,Google自己的文档将其限制在两种内容类型: 页面有 `JobPosting` 结构化数据,以及使用 `BroadcastEvent` 内嵌结构化数据 `VideoObject`之前 `indexing.request`,服务器获取目标URL,并检查静态的JSON-LD,Microdata,以及RDFa标记,其中一种类型;如果两者都不在(或无法取出页面),它返回一个错误,解释URL为何不合格而不是调用索引API. 仅在客户端-JavaScript运行后注入的结构化数据无法被这个被捆绑的预飞确认,因此无法关闭. 在此之前 `indexing.remove`,服务器则确认了 Google 的删除先决条件: URL 必须已经返回 HTTP 404/410 或曝光机器人 `noindex` 元指令 。 更新和删除通知的公布配额相同。 Google当前的文档列出了一个默认的200个发布请求/日/项目. 其2026年10月16日更新删除了已过时的配额申请表,但这并没有授权超过已公布的配额或提交未经支持的内容. 请检查access-date=中的日期值 (帮助) 请检查access-date=中的日期值 (帮助) Google Cloud Console的API访问和当前配额. Google还让每份呈文都接受垃圾邮件检测并警告称,滥用或试图通过多账户或其他方式超过配额可以取消访问. 成功的通知只是承认谷歌收到了它——它不能保证索引或删除完成.

## 你可以问什么

**机构报告工作流程:** [每周只读搜索控制台报告](https://npmcn.com/package/%40digestseo/mcp-gsc/docs/agency-weekly-reporting.md) 通过准确的财产核查、一份限定范围的每周摘要、相应时期的比较、证据检查以及可重复使用的经人审查的客户报告。 它没有编造客户计量标准或自动外联.

一旦连接起来,请问你的助手:

-   _"在过去28天里我点击了20个问题是什么?"_
-   _“例如,Compare印象.com本月对上月的对比——哪一页下降?”_
-   _"Google的索引版本是什么" `https://example.com/pricing` 显示索引状态和上次爬行”_
-   _"哪个高印象的查询/页面行的平均位置在5到15之间? 给我展示那些优化的机会"_
-   _每周给我一份摘要 `sc-domain:example.com` 今天结束。"_
-   _"我的现场地图有错误或警告吗?"_
-   _"使用这个品牌的regex我提供, 大致我的点击作为品牌与非品牌"_
-   _"我的网站在Google Discover vs 常规的网页搜索中表现如何"_

查询 regexes 仅是一个手动近似. Search Console的本地品牌/非品牌过滤器使用Google自己的AI辅助分类(包括语言变体,打字器,以及相關出品/服務),而该本地分类器不作为Search Analytics API过滤器被曝光.

搜索控制台还专门为搜索和发现提供Generative AI性能报告. 当前所记录的"搜索分析"API没有暴露出一个专用的Generative AI搜索类型或过滤选择器,因此这个MCP没有猜测一个. AI Overviews and AI Mode仍然包含在整体网页搜索性能数据中;在Google文档API访问之前,使用搜索控制台UI作为专用的Generative AI报告.

截至2026年9月24日,Search Console在UI中还设有一个网络多模式性能过滤器,用于Lens, Circle to Search,图像上传,Chrome图像搜索等搜索. 当前搜索分析 API 和发现文档仍然只曝光 `web`, (中文(简体) ), `image`, (中文(简体) ), `video`, (中文(简体) ), `news`, (中文(简体) ), `discover`,以及 `googleNews` 搜索类型, 因此此 MCP 不创建 `search_type: "multimodal"` 或猜测a `searchAppearance` 数值。 在Google文档API访问之前,使用"搜索控制台"(Search Console UI)进行孤立的多模式报告.

## 在您的 AI 客户端中连接

一旦您部署过服务器( 请查看 ) **[钢筋混凝土](https://npmcn.com/package/%40digestseo/mcp-gsc/SETUP.md)**,通过粘贴你的工人的 `/mcp` 进入客户端的 URL :

```
https://<your-worker>.workers.dev/mcp
```

-   **克洛德.ai /克洛德桌面** - 继续 **自定义 – 连接器**,单击 **+- 添加自定义连接器**,输入名称并粘贴 `/mcp` URL (中文(简体) ). 保留可选高级 OAuth 客户端 ID/Secret 字段的空白 。 在团队/企业上,所有者或主要所有者必须首先从 **组织设置 – 连接器**;成员然后从自定义 → 连接器连接它. 在第一次连接时克洛德打开了Google的登录流量.
-   **光标** - 添加一个遥控器 **可流取的 HTTP** MCP 服务器指向相同的 `/mcp` URL; Cursor支持远程HTTP MCP服务器的OAuth. 上面的 Cursor 按钮添加目标为本地 npm 发射器的回路端.
-   **聊天游戏** - 启用 **开发者模式**,然后创建自定义 MCP **应用** 从 **设置 – Apps – 创建** (管理人员/业主也可使用) **工作空间设置 → Apps → 创建**) (中文(简体) ). 提供 `/mcp` 端点,选择适用的认证选项, **扫描工具**,然后创建应用程序。 包括写入/修改工具在内的完整的MCP目前可供Business and Enterprise/Edu使用;Pro自定义的MCP访问是只读/只读,所以使用 `GSC_ACCESS_MODE=readonly` 为这条路.

这个 `/mcp` 终端点对客户端相同,但每个主机都有自己的设置和权限流.

## 设置

自我托管意味着带来自己的Google OAuth证书和Cloudflare账户. 完整,可复制的行走在 **[钢筋混凝土](https://npmcn.com/package/%40digestseo/mcp-gsc/SETUP.md)** 包括关于Google的OAuth验证的重要说明,以及7天的刷新收件限制,而您的应用则未验证.

快速形状 :

```bash
git clone https://github.com/AKzar1el/mcp-gsc.git
cd mcp-gsc
npm install
cp wrangler.example.jsonc wrangler.jsonc       # then paste in your KV ids
# set GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET / TOKEN_ENCRYPTION_KEY as secrets
# choose GSC_ACCESS_MODE=readonly in wrangler.jsonc for a read-only deployment
npm run deploy
```

见 **[钢筋混凝土](https://npmcn.com/package/%40digestseo/mcp-gsc/SETUP.md)** 对于每一个步骤的细节.

## 发展

```bash
npm install
npm test              # typecheck + offline unit tests (what CI runs)
npm run dev           # wrangler dev (local)
npm run test:smoke    # structural smoke tests against a deployment
```

欢迎捐款——见 [捐款额](https://npmcn.com/package/%40digestseo/mcp-gsc/CONTRIBUTING.md)。 。 。 .

## 许可证

[麻省理工学院](https://npmcn.com/package/%40digestseo/mcp-gsc/LICENSE) 2026 文摘社.

* * *

_建造和维护 [托米·舍雷吉](https://tomiseregi.si/),后面的建设者 [文摘社](https://digestseo.com/) - 开放源代码SEO工具和搜索能见度软件._

## 常见问题

### @digestseo/mcp-gsc 是什么？

自宿Google搜索控制台MCP服务器用于分析,URL检查,站点地图,索引,以及SEO报告Cloudflare Workers\.

### 如何安装 @digestseo/mcp-gsc？

在项目目录运行 npm install @digestseo/mcp-gsc，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-gsc，可以用 npx mcp-gsc 直接运行。

### @digestseo/mcp-gsc 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/digestseo\_\_mcp-gsc 是否存在。

### @digestseo/mcp-gsc 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @digestseo/mcp-gsc 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js ^22\.18\.0 \|\| \>=24\.11\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @digestseo/mcp-gsc 可以商用吗？

@digestseo/mcp-gsc 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @digestseo/mcp-gsc 的下载量有多少？

根据 npm 官方下载统计，@digestseo/mcp-gsc 在 2026/10/12 – 2026/11/10 这 30 天内被下载 1,994 次，日均约 66 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @digestseo/mcp-gsc 还在维护吗？

最新版本 0\.4\.41 发布于 2026/11/11（3 天前）；至今共发布 43 个版本，其中过去 12 个月发布了 43 个；首次发布于 2026/07/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。