缩写
部分 文摘社 一套开源的 SEO 工具.
- 产品 : digitseo.com/gsc-mcp (中文(简体) )
- 工程案例研究: 文摘SEO MCP 套件——AI能见度,搜索控制台,网络验证和趋势智能
- 支助: documentseo.com/ support (英语)
- 隐私 : digitseo.com/ 隐私
自宿发射装置作为 @digestseo/mcp-gsc。对于新的分析/只报告连接,明确以只读模式开始:
GSC_ACCESS_MODE=readonly npx -y @digestseo/mcp-gsc
在 Windows PowerShell 上,使用 $env:GSC_ACCESS_MODE = 'readonly' 接下来是 npx -y @digestseo/mcp-gsc 换句话说 提供您自己的 Google OAuth 和加密设置 钢筋混凝土 在启动任一命令之前.
Npm 发射器只启动回放 可流取的 HTTP 员工在 127.0.0.1 (开口) 8080 它不是一个 stdio MCP 进程。 你可以运行 npx 命令来自任意目录,因为发射器从已安装的软件包中解析其捆绑的工人配置。 启动软件包的客户端应当连接到 http://127.0.0.1:8080/mcp 提供了 Google OAuth 和 符号加密环境变量后 钢筋混凝土。发射装置在开始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 的部署配置, 请遵循 钢筋混凝土。 。 。 .
连接本地发射装置
对于当前已核实的快速连接路径,请提供Google OAuth和符号加密环境变量 钢筋混凝土,然后使用上面适当的只读命令(或故意选择)启动 npm 发射器 readwrite 工作流程的特殊性.
然后将您的 MCP 客户端连接到启动器的回路端 :
http://127.0.0.1:8080/mcp
自办云旗 继续使用工人部署 https://<your-worker>.workers.dev/mcp. Repo目前没有作为快速连接路径广告发布所有者托管的远程,因为其部署的工具合同是发布软件包的后盾.
克劳德代码
claude mcp add --transport http gsc http://127.0.0.1:8080/mcp
OpenAI 代码 CLI / IDE
codex mcp add gsc --url http://127.0.0.1:8080/mcp
Codex CLI和Codex IDE扩展共享MCP配置,因此注册服务器一次就能使两个客户端都能使用相同的本地连接. 在使用连接前启动 npm 启动器; 当需要认证时, Codex 会打开服务器的 OAuth 流量 .
视觉工作室代码( GitHub 副驾驶)
按钮只添加本地可流 HTTP 连接; 它确实 没有 启动 npm 启动器或配置 Google OAuth 。 跟随 钢筋混凝土 启动上面的发射器 同台机器 在连接和签名前作为 VS 代码。 远程 VS 代码环境无法到达您的计算机 127.0.0.1 终点.
光标
当此寄存器被安装为光标插件时, 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/代理; Cursor支持HTTP MCP服务器和OAuth在那里. 不要为 Cloud Agent 重用回转 URL .
GitHub 副驾驶 CLI
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
gemini extensions install https://github.com/AKzar1el/mcp-gsc
双子座 CLI 扩展捆绑已验证的本地回路 MCP 配置外加相同的三种代理技能: gsc-weekly-review, (中文(简体) ), gsc-indexing-triage,以及 gsc-search-opportunities。在使用扩展前启动 npm 发射器;扩展不会为您启动或部署 mcp-gsc .
基罗
在使用安装按钮或副驾驶插件前启动 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 的 安全磁共振 隧道指南. 该地道保留了 MCP 服务器的私密性,用于私人/开发者-模式连接,而不是公共插件发行.
或者, 部署您自己的远程 Cloudflare 工人并添加其 HTTPS /mcp URL 在开发者模式中作为自定义的 MCP app; 见 在您的 AI 客户端中连接 见下文.
自相残杀 示范背景协议 (MCP)服务器 谷歌搜索控制台连接到 Claude.ai, Cursor, ChatGPT 或任何与MCP相容的客户端,并询问您的AI助手您网站的有机搜索性能——印象,点击,顶级询问,索引状态,以及站点映射健康——直接来自您自己的Google账户.
它继续运行 云花岗工人 和载有 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范围。 读写仍为默认值, 因此现有部署保留其当前行为; 见 钢筋混凝土 在连接用户之前选择模式.
大型分析响应在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还让每份呈文都接受垃圾邮件检测并警告称,滥用或试图通过多账户或其他方式超过配额可以取消访问. 成功的通知只是承认谷歌收到了它——它不能保证索引或删除完成.
你可以问什么
机构报告工作流程: 每周只读搜索控制台报告 通过准确的财产核查、一份限定范围的每周摘要、相应时期的比较、证据检查以及可重复使用的经人审查的客户报告。 它没有编造客户计量标准或自动外联.
一旦连接起来,请问你的助手:
- "在过去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 客户端中连接
一旦您部署过服务器( 请查看 ) 钢筋混凝土,通过粘贴你的工人的 /mcp 进入客户端的 URL :
https://<your-worker>.workers.dev/mcp
- 克洛德.ai /克洛德桌面 - 继续 自定义 – 连接器,单击 +- 添加自定义连接器,输入名称并粘贴
/mcpURL (中文(简体) ). 保留可选高级 OAuth 客户端 ID/Secret 字段的空白 。 在团队/企业上,所有者或主要所有者必须首先从 组织设置 – 连接器;成员然后从自定义 → 连接器连接它. 在第一次连接时克洛德打开了Google的登录流量. - 光标 - 添加一个遥控器 可流取的 HTTP MCP 服务器指向相同的
/mcpURL; 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账户. 完整,可复制的行走在 钢筋混凝土 包括关于Google的OAuth验证的重要说明,以及7天的刷新收件限制,而您的应用则未验证.
快速形状 :
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
见 钢筋混凝土 对于每一个步骤的细节.
发展
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
欢迎捐款——见 捐款额。 。 。 .
许可证
麻省理工学院 2026 文摘社.