当需要追踪关键词排名、SERP 位置和 AI…

适用于按关键词、地区/语言/设备/引擎追踪排名变化、SERP 功能、GEO/AI 可见性和竞品对比。

适用场景

解决思路

1. 设置关键词追踪：配置 domain、market/locale、device、language、engine、update frequency、priorities、competitor watchlist 和 stable page refs；应用 SEO/GEO Evidence and Cycle Control Profile（../performance-monitor/references/evidence-and-cycle-control.md）。
2. 记录当前排名：输出位置表，每行标注来源（tool export / user-provided / estimated），并包含位置范围、ranking URLs、SERP 功能归属、相对基线的变化。
3. 分析排名变化：突出最大提升、下降、稳定词、新增排名、丢失排名、可能原因和恢复思路；每个 delta 都标注相对基线。
4. 跟踪 SERP 功能：比较 snippets、PAA、image/video packs、local packs 及相关功能变化归属。
5. 跟踪 GEO/AI 可见性：监控 AI Overview 出现、citation rate、citation position 和趋势；每个值标为 Measured（来自 ~~AI monitor）或未观察到时 N/A。
6. 对比竞争对手：报告 share of voice、正面比较和威胁级别。
7. 生成排名报告：输出总体趋势、关键提升、担忧、机会、SERP 功能变化、GEO 可见性和建议；每个指标带来源标签。
8. 指标标签：对每个指标标 Measured、User-provided、Calculated、Estimated、Proxy 或 Unknown；绝不把估算或代理值呈现为实测；适用但缺失的指标标 Unknown 并给原因；过期或 locale/language/device/engine 不匹配的位置标 NEEDS_REFRESH，而不是当前排名；N/A 只用于真正不适用的字段。
9. 执行零依赖测量循环：不要叙述未测量过的排名变化；每次检查用命令记录快照：`python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/ledger.py" record <domain> --source rank --data '{"<keyword>": <position>, ...}'`。
10. 用命令查看变化与序列：`ledger.py diff <domain> --source rank` 查看自上次检查以来的变化；`ledger.py trend <domain> --source rank --field "<keyword>"` 查看序列。
11. 连接工具时拉数据：从 ~~SEO tool 拉排名，从 ~~search console 拉展示量，从 ~~analytics 拉流量，从 ~~AI monitor 拉 AI 引用；没有工具时向用户索取位置、搜索量、竞品数据和 SERP 功能状态。
12. 有 Search Console 连接时记录真实 Search Console 位置；否则在 Tier 1 记录用户提供的位置。
13. 归因排名 delta：把它视为 week-scale、confounded outcome，使用 control（holdout keyword/competitor）进行归因，而不是对照零；参考 references/measurement-protocol.md。
14. 决策：没有目标关键词且无法从 CLAUDE.md 或先前监控记录推断时，停止并询问用户；提供选项：(1) 提供 keyword list，(2) 追踪 domain 的 top known terms，(3) 取消。
15. 无先前基线时静默继续：把当前运行记录为 baseline，将所有位置标为 first snapshot，并继续；不要编造 previous position。
16. 缺失可选工具数据（SERP features、AI citations）时标 N/A 并继续。
17. 按排名变化响应协议处理：下降 1-3 个位置等待 1-2 周并监控，可能为正常波动；下降 3-5 个位置在 1 周内调查技术问题和竞争对手变化；下降 5-10 个位置立即调查，运行技术、内容、链接全诊断；跌出第 1 页紧急响应，做全面审计 + recovery plan；排名提升则记录并学习，找出有效做法并复制。
18. 保存结果：询问 "Save these results?"；若同意，写入 memory/monitoring/。
19. 输出预期：生成排名报告或 delta summary，以及用于 memory/monitoring/ 的标准 handoff summary。
20. 读取输入：current rankings、prior baselines、target keyword list、locale/language/device/engine、snapshot/source refs、observation times/windows、stable page/content bindings、用户提供或工具指标。
21. 写入输出：面向用户的 monitoring deliverable 和可复用 summary。
22. 提升事项：将 significant changes、confirmed anomalies、follow-up actions、pending decisions 写入 memory/open-loops.md。
23. 完成条件：每个 tracked keyword 都显示 current、context-matched position vs baseline 且带 labeled delta，或标 Unknown/NEEDS_REFRESH 并给原因；每个 observation 引用 source ref、observed time、window、locale/language/device/engine、evidence label、ranking page ref；冲突保持可见；命名 biggest movers 和 likely causes。
24. 下一步技能：周期性监控应自动化时转到 performance-monitor；初始设置无 baseline 转到 performance-monitor；后续运行有 baseline 转到 Terminal；visited-set rule 适用。

适用边界 · 注意事项

• 不适用于多指标 stakeholder reports 或设置 alerts；这些应使用 performance-monitor 的 report 或 alert 模式。
• 不适用于需要把 recurring monitoring 自动化时；应转到 performance-monitor。
• 没有目标关键词且无法从 CLAUDE.md 或先前监控记录推断时，不应直接开始；先让用户提供 keyword list、追踪 domain 的 top known terms 或取消。