Fennec SEO · Agent 工具
让你的 Agent,读懂你的 Search Console 数据。
连接自己的 Google 账号,选择 Search Console 属性,再让 Agent 查询搜索表现、站点地图处理状态和索引信息。
- 只读访问
- Google OAuth 授权
- 远程 HTTP
一个连接,接入你的 GSC 工作流
MCP 服务地址
https://gsc.yusihk.com/mcp 把此地址添加到 Agent 的 MCP 设置中,在客户端提示连接时,通过 Google 完成登录授权。
- 服务名称
- fennec-gsc
- 传输方式
- Streamable HTTP / 远程 HTTP
- 认证方式
- OAuth · 使用 Google 登录
- Google 权限
- webmasters.readonly
无需自行创建 Google Cloud 项目,也无需填写 Google Client ID、Client Secret、API Key 或 Bearer Token。
从连接到一个有依据的回答
- 1
添加服务
选择下方客户端,添加 MCP 地址。
- 2
通过 Google 授权
核对 Google 显示的应用名称和只读权限,再选择账号。
- 3
选择网站属性
让 Agent 列出可访问站点,后续请求使用返回的完整 siteUrl。
01 / CONNECT
连接你常用的 Agent
选择对应应用的配置方式。自定义 MCP 是否可用取决于客户端版本、套餐和工作区设置。登录后,先列出站点来确认连接。
CodexCLI · IDE · 桌面应用
- 在终端执行添加命令,然后启动 OAuth 登录。
- 在浏览器中完成 Google 授权,用 codex mcp list 或 /mcp 查看连接。
- 桌面应用也可在 MCP 设置中添加远程服务,填写上方地址。
codex mcp add fennec-gsc --url https://gsc.yusihk.com/mcp
codex mcp login fennec-gsc
codex mcp list Claude CodeHTTP 服务 · 浏览器授权
- 执行下方命令,添加远程 HTTP 服务。
- 进入 Claude Code,输入 /mcp,选择该服务并按提示完成授权。
- 回到对话,让它列出你可以访问的 Search Console 属性。
claude mcp add --transport http fennec-gsc https://gsc.yusihk.com/mcp Cursor.cursor/mcp.json
- 将条目加入项目的 .cursor/mcp.json;个人通用配置可放在 ~/.cursor/mcp.json。
- 打开 Cursor 的 MCP 设置,连接此服务,并按提示完成浏览器 OAuth 授权。
- 首次提问前,为 Agent 启用此服务的工具。
{
"mcpServers": {
"fennec-gsc": {
"url": "https://gsc.yusihk.com/mcp"
}
}
} 将此服务条目合并到现有配置,保留已配置的其他服务。
官方连接文档VS Code / Copilot.vscode/mcp.json
- 将下方配置加入工作区的 .vscode/mcp.json。
- 使用配置上方的控制项或 MCP 命令启动服务,并按提示完成登录。
- 在 Agent 对话的工具选择器中启用 GSC 工具。
{
"servers": {
"fennec-gsc": {
"type": "http",
"url": "https://gsc.yusihk.com/mcp"
}
}
} 将此服务条目合并到现有配置,保留已配置的其他服务。
官方连接文档Claude网页 · 桌面 · 自定义连接器
- 在账号支持时,打开 Customize → Connectors → Add custom connector。
- 名称可填 Fennec SEO GSC,远程服务地址填 https://gsc.yusihk.com/mcp。
- 选择 OAuth 登录;若需要选择客户端注册方式,使用自动注册。完成 Google 授权后,在对话中启用连接器。组织账号可能需要管理员先添加。
ChatGPT自定义 MCP · 工作区权限
- 打开 ChatGPT 设置中可用的 MCP 或自定义连接器入口。工作区可能需要先开放自定义 MCP。
- 添加名为 Fennec SEO GSC 的远程服务,地址为 https://gsc.yusihk.com/mcp,认证选择 OAuth。
- 保存并连接,完成 Google 授权,再为当前对话启用工具。若账号没有自定义 MCP 入口,可选用上方其他客户端。
02 / TOOLS
五个工具,读取你有权限的网站属性
连接器通过 Google 官方 Search Console API 读取数据,不能编辑属性、提交或删除站点地图、请求索引,也不能修改网站。
gsc_list_sites选择网站属性
列出可访问站点与权限,包括网址前缀属性和网域属性。
gsc_site_overview获取表现概览
针对指定属性和明确的日期范围汇总表现。
gsc_query_search_analytics分析搜索表现
按页面、查询、设备、国家或日期读取点击、展示、CTR 与平均排名。
gsc_list_sitemaps检查站点地图处理状态
读取已提交站点地图的处理信息、警告和错误。
gsc_inspect_url检查 Google 已记录的索引版本
读取索引、抓取和 canonical 信息;此工具不是实时 URL 测试。
03 / ASK
从一个具体问题开始
连接并选站
列出我可以访问的 Search Console 属性,让我选择一个。后续请求都使用它返回的完整 siteUrl。
比较搜索表现
针对我选定的属性,比较最近两个完整 28 天窗口的 final 网页搜索数据。写明日期范围、点击、展示、CTR 和平均排名,区分全站变化与页面级诊断。
寻找值得排查的页面
针对我选定的属性,找出最近完整 28 天有展示但点击较少的页面。提出标题调整建议前,先列出页面与可见查询证据,并说明 Top rows 和缺失行的限制。
核对索引证据
检查我提供的 URL 在选定属性中的已索引版本,报告抓取、索引和 canonical 信息,说明哪些结论还需要实时测试。
由你的账号决定访问范围
登录由 Google 完成。连接器会使用你的授权凭据读取 GSC 数据并返回给 Agent;Agent 应用也会处理返回的数据。可访问范围以你授权的 Google 账号在 Search Console 中的权限为准。
Search Analytics 可能只返回可见 Top rows,而非所有查询;没有返回行不等于没有需求。查询时写明日期与 dataState。URL 检查反映 Google 已记录的版本,读取成功不保证收录或排名。
连接时的常见问题
为什么浏览器打开服务 URL 会返回 401?
MCP 端点需要 OAuth 访问令牌。应在 Agent 的 MCP 设置中添加服务并完成登录;直接在浏览器打开地址不能验证已授权连接。
没有找到某个网站,该查什么?
确认授权的是正确 Google 账号,且该账号已在 Search Console 中拥有对应属性的访问权限。网址前缀和网域属性的 siteUrl 不同。
已经登录,却没有看到工具。
确认客户端已启用服务,并为当前对话启用了相应工具。重新打开或刷新连接状态;部分客户端需要开启新对话才会加载新增工具。
任何 Agent 都能连接吗?
客户端需要支持远程 HTTP MCP 和 OAuth。连接示例依据所链接的客户端官方文档;仍需在你的环境中完成登录并成功调用工具,才能确认该客户端的实际访问。