关于 Untapped Search Console
Untapped Search Console 从 Google Search Console 读取网站的搜索词、页面和表现变化，帮助网站所有者分析搜索流量趋势与机会。数据仅供读取。
主要功能
- 01查看点击量和展示量
- 02按搜索词、页面、国家、设备或日期拆分表现
- 03发现接近搜索结果首页的搜索词
- 04识别有效和不可见的搜索词
- 05比较时间段并发现增减
适用场景
- 01查看某个时间段的搜索点击量和展示量
- 02查找排名第 4 至 20 位但没有点击的搜索词
- 03找出流量上升或下降的页面及搜索词
- 04按设备或国家检查表现
MCP 相关
向 MCP 客户端提供只读 Google 登录、网站属性查询、表现与总量查询、机会分析和时间段比较工具。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。
详细介绍
Untapped Search Console
通过你自己的 Search Console 查看用户用哪些搜索词找到你的网站、哪些搜索词快要进入首页，以及上个月以来的变化。 免费且只读。由 Find Untapped Growth 构建。
工具
| 工具 | 说明 |
|---|---|
google_login / google_login_status / google_logout | 一次只读 Google 登录，所有 Untapped Google 插件共用 |
gsc_sites | 你的 Search Console 媒体资源 |
gsc_totals | 指定时间范围内网站的实际点击次数和展示次数 |
gsc_performance | 按搜索词 / 页面 / 国家 / 设备 / 日期列出数据（最多同时选择 3 项），支持筛选 |
gsc_whats_working | earning（保护）· close（排名第 4–20 位但没有点击，值得投入）· top3_no_clicks（修正标题/摘要）· invisible（排名在第 20 位之后） |
gsc_compare | 比较当前时间范围与上一时间范围：增长、下滑、新增、流失，以及两个时间范围的实际总量 |
默认情况下，时间范围截止于 3 天前，因为 Search Console 最近约 2 天的数据尚未最终确定；如果时间范围截止于今天，数据会显示出虚假的下滑。
安装
- Claude Code：
/plugin install untapped-search-console --marketplace CTF-Max/untapped-plugins（或者在终端中运行：claude plugin marketplace add CTF-Max/untapped-plugins，然后运行claude plugin install untapped-search-console@untapped-plugins）。 - Codex：
codex plugin marketplace add CTF-Max/untapped-plugins，然后运行codex plugin add untapped-search-console@untapped-plugins。 - PATH 中需要有 Python 3.10+，并且名称为
python。仅使用标准库：无需通过pip install安装任何内容。
设置
与 Untapped Index Watch 使用相同的 Google 登录：创建 Google Cloud 桌面应用 OAuth 客户端，并启用 Search Console
API（步骤见 Index Watch 的 README）。
Claude Code：在插件设置中选择该文件（"Google OAuth client file"）。Codex：
运行 setx UNTAPPED_GOOGLE_CLIENT_SECRET "C:\path\to\client_secret.json" 并重启。然后让你的 Agent 运行
google_login。如果已通过 Index Watch 登录，则无需其他操作。
连接范围
仅连接 Google：登录时访问 accounts.google.com 和 oauth2.googleapis.com，获取 Search Console 数据时访问 searchconsole.googleapis.com 和
www.googleapis.com。无遥测。详情见：PRIVACY.md。
限制
- 为保护隐私，Google 会隐藏低频搜索词，因此搜索词数据行的总和不会等于网站总量；
gsc_totals会提供实际总量。 - 排名是多个平均值的平均值，仅供参考趋势。
gsc_compare比较每个时间范围内排名最高的 1,000 行，因此“流失”也可能表示“跌出了前 1,000 名”。
开发
python -m unittest discover -s untapped-search-console/tests # offline, 7 tests
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。