Untapped Index Watch

Untapped Index Watch

你的网站中的每个页面都已收录到 Google 索引中吗？与上次相比有哪些变化？免费且只读，使用你自己的 Search Console。由 Find Untapped Growth 构建。

工具

工具	功能
google_login / google_login_status / google_logout	登录 Google 一次（只读 Search Console）；所有 Untapped Google 插件共用此登录
gsc_sites	你的 Search Console 资源
index_check	检查站点地图中的每个 URL（或一个 URL 列表）：已收录 / 未收录 / 未知、通俗易懂的标记、每种问题通常意味着什么以及如何处理，还有自上次检查以来已从索引中移除或新收录的页面
index_history	查看每个站点的历史检查记录（每次运行的数量），或某个 URL 的历史记录；数据在本地存储

标记：已从索引中移除 · 未收录（附 Google 给出的原因）· 被页面自身的 noindex 阻止 · 被 robots.txt 阻止 · Google 无法抓取 · Google 选择了其他规范网址 · 规范网址已更改 · 超过 45 天未抓取。 检查失败时会报告为 UNKNOWN，绝不会标记为“未收录”。

安装

• Claude Code： /plugin install untapped-index-watch --marketplace CTF-Max/untapped-plugins （或者在终端中运行：claude plugin marketplace add CTF-Max/untapped-plugins，然后运行 claude plugin install untapped-index-watch@untapped-plugins）。
• Codex： 运行 codex plugin marketplace add CTF-Max/untapped-plugins，然后运行 codex plugin add untapped-index-watch@untapped-plugins。
• PATH 中需要有 Python 3.10+，命令名为 python。仅使用标准库：无需通过 pip install 安装任何内容。

设置（一次性，大约 5 分钟）

1. 打开 Google Cloud 控制台 → 创建项目 → 启用 Google Search Console API。
2. 打开 OAuth 同意屏幕 → 选择 External → 将自己添加为测试用户。
3. 打开凭据 → 创建 OAuth 客户端 ID → 选择 Desktop app → 下载 JSON 文件。
4. 将插件指向该文件：
   • Claude Code： 启用插件时，在插件设置中选择该文件（“Google OAuth client file”） （之后可通过 /plugin → untapped-index-watch → configure 操作）。
   • Codex： 设置变量，然后重启 Codex：

     setx UNTAPPED_GOOGLE_CLIENT_SECRET "C:\path\to\client_secret.json"
     

5. 让你的 Agent 运行 google_login；在浏览器中批准只读访问权限。

设置 / 变量	默认值
Google OAuth 客户端文件 / UNTAPPED_GOOGLE_CLIENT_SECRET	（必填）你的 Desktop-app OAuth 客户端 JSON 文件的路径
UNTAPPED_GOOGLE_HOME	~/.untapped-plugins/google — 已保存的登录信息（共享）
UNTAPPED_INDEX_HOME	~/.untapped-plugins/index-watch — 检查历史记录

连接到哪些服务

仅连接 Google：登录时访问 accounts.google.com 和 oauth2.googleapis.com，使用 Search Console 时访问 searchconsole.googleapis.com 和 www.googleapis.com，并访问你自己网站的站点地图。不收集遥测数据。详情见：PRIVACY.md。

限制

• Google 允许每个资源每天检查 2,000 个 URL（每分钟 600 个）；默认检查 50 个 URL。
• 请求编入索引 没有 API：需要在 Search Console 中手动点击。
• 检查报告的是 Google 最近已知的状态，最近发生的更改可能要过几天才会反映出来。

开发

python -m unittest discover -s untapped-index-watch/tests   # offline, 13 tests