rank-monitor

/digital-marketing-pro:rank-monitor

脚本位置。 如果你的宿主未设置 ${CLAUDE_PLUGIN_ROOT}，脚本位于此插件的 scripts/ 文件夹中，与 skills/ 文件夹同级。请使用 Python 3.10 或更高版本运行：使用 python；如果找不到 python，则使用 python3（macOS 和许多 Linux 系统）。

用途

设置并管理关键词排名监控；使用 --features 时，还可在同一次运行中跟踪 SERP 特性。跟踪目标关键词在 Google 上的排名，建立基准，检测超过 5 位的下跌，并在排名发生重大变化时生成提醒。在 --features 模式下，还会跟踪每个查询出现了哪些 SERP 特性（AI Overviews、精选摘要、“用户还问了”问题、知识面板、本地包、图片包、视频轮播、购物），以及品牌是否拥有这些特性。这样可以持续了解自然搜索表现，及早发现排名下滑、识别上升趋势，并跟踪日益丰富的搜索结果页特性。

合并后的技能（原为 rank-monitor + serp-tracker）。 SERP 特性跟踪现已成为此技能的 --features 模式。旧的 /digital-marketing-pro:serp-tracker 是指向此处的弃用提示。

数据源（配置前请阅读）

• Google Search Console MCP 是已验证媒体资源的权威排名和展示次数数据源。GSC 会返回每个查询和页面的排名、展示次数、点击次数和 CTR，但不会返回每个查询的完整 SERP 特性布局或 AI Overview 引用列表。请勿声称它能提供这些数据。
• 排名跟踪 MCP（Ahrefs / Semrush / SE Ranking，如果已连接）可补充 GSC 无法查看的关键词和竞争对手排名，并提供各自的 SERP 特性标记。
• SERP 快照文件（可选，来自任意提供方）：如果品牌已从任意 SERP API 或排名跟踪工具导出每个查询的 SERP 结果，请使用 --serp-snapshot <file> 传入导出文件，并先进行验证：

  python "${CLAUDE_PLUGIN_ROOT}/scripts/serp-snapshot.py" --file <export.csv|export.json> --brand-domain <brand domain>
  

  其中的行会提供这些查询的排名、AI Overview 是否出现及其引用内容、“用户还问了”问题，以及精选摘要归属。格式见此文件旁的 serp-snapshot-format.md。脚本只会读取该文件（不联网、不需要 API 密钥，也不运行提供方代码）；如果导出文件格式不正确，脚本会以状态码 1 退出并列出所有有问题的行（请展示错误，且不要使用该文件）。未提供文件时不会有任何变化。
• Moz MCP（mcp-moz）为可选项——使用前请先在 npm 上确认该软件包存在（npm view mcp-moz）；npx 会执行远程代码，因此不要接入未经验证的软件包。如果未连接 Moz，请使用 GSC 加上品牌已有的任意排名跟踪 MCP。
• --features 模式下的 AI Overview 是否出现，只记录 AI Overview 是否出现以及品牌是否被引用（二元 SERP 特性信号）。如需针对 6 个标准 AI 平台进行 AI 可见度评分，请使用 /digital-marketing-pro:geo-monitor / /digital-marketing-pro:aeo-audit（标准 AI 可见度评分规范）；如需获取实际展示次数，请使用 /digital-marketing-pro:gsc-ai-performance。请勿在此处重新实现 AI 可见度评分。

所需输入

用户必须提供（或将收到提示提供）：

• 目标关键词：要监控的关键词列表，可直接提供、从 CSV 或 Google Sheet 导入，或从品牌现有的关键词跟踪列表 ${CLAUDE_PLUGIN_DATA}/{brand}/seo/keywords.json 中提取。关键词应尽可能包含搜索意图分类（信息型、导航型、交易型、商业型）
• 模式：默认为仅排名。传入 --features，还可在同一次运行中为每个查询构建 SERP 功能存在矩阵
• 监控频率：daily 或 weekly — 高优先级核心词、活跃营销活动关键词（以及波动较大的功能集）使用 daily；长尾词和优先级较低的词使用 weekly
• 提醒阈值：触发提醒的排名变化 — 默认为排名下降超过 5 位。可按关键词组自定义（例如，品牌词超过 3 位、核心词超过 5 位、长尾词超过 10 位）。支持设置排名下降和上升阈值
• 竞争对手域名（可选）：针对相同关键词／功能，与品牌一同跟踪的域名 — 最多 10 个
• 设备类型：mobile、desktop 或 both
• 目标国家／地区：要检查排名的 Google 区域设置 — 例如 US、UK、AU、CA、IN

流程

1. 加载品牌背景信息：读取 ~/.claude-marketing/brands/_active-brand.json 获取当前启用的品牌 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌语气、目标市场的合规规则（skills/context-engine/compliance-rules.md）和行业背景信息。另检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 中是否有指南；如果有，加载其中的限制。检查 ~/.claude-marketing/sops/ 中是否有代理机构的标准操作流程。如果没有品牌，请询问：“要先设置品牌吗（/digital-marketing-pro:brand-setup）？”——也可以使用默认设置继续。
2. 记录当前排名基线：查询已连接的排名数据源（GSC MCP，以及任何可用的排名跟踪器 / Moz MCP），获取每个目标关键词的当前排名位置。记录排名位置、排名 URL，以及 GSC 可提供的点击率和展示次数。在 --features 模式下，还要记录该查询包含哪些 SERP 功能（来自排名跟踪器的功能标记、经验证的 SERP 快照文件或人工观察），以及每项功能所属的域名，并注明每个查询的标记来自哪个数据源。对于竞争对手域名，记录它们在相同关键词下的排名位置（以及功能归属）。
3. 配置监控计划：将关键词列表、模式（rankings 或 rankings+features）、监控频率、警报阈值、竞争对手域名、设备类型和目标国家保存到 ${CLAUDE_PLUGIN_DATA}/{brand}/seo/rank-monitor/config.json。使用当前排名位置（以及 --features 模式下的功能矩阵）作为参照，在 ${CLAUDE_PLUGIN_DATA}/{brand}/seo/rank-monitor/baseline.json 中创建或更新基线快照。
4. 每次监控检查时：查询并比较：获取所有受跟踪关键词的当前排名位置。将每个关键词的当前排名位置与基线（监控开始时的初始排名位置）和上次检查结果（最近记录的排名位置）进行比较。计算相较基线的绝对变化、与上次检查相比的变化、滚动 7 天和 30 天的趋势方向，以及所有受跟踪关键词的平均排名位置。在 --features 模式下，将功能矩阵与上一个快照进行比对（新增 / 丢失的功能、归属变化、AI Overview 的出现 / 引用变化）。
5. 检测重大变化：识别触发警报阈值的关键词——排名下降超过配置的阈值、从第 1 页（排名位置 1-10）跌至第 2 页或更后、排名提升超过 5 位（可能快速见效），以及在 --features 模式下，品牌排名 URL 新增或失去的 SERP 功能，还有排名上升到品牌之上或跌至品牌之下的竞争对手排名 / 功能变化。
6. 超出阈值时生成警报：按严重程度对警报分类——minor 表示排名下降 3-5 位（持续监控）；major 表示排名下降 5-10 位（调查内容时效性、技术问题或竞争对手活动）；critical 表示排名下降超过 10 位，或从第 1 页跌至第 2 页（立即调查——检查算法更新、人工处罚、技术错误或内容蚕食）。在 --features 模式下，如果失去已占有的 Featured Snippet 或 AI Overview 引用，严重程度至少应为 major。为每个严重程度提供建议的后续步骤。

SERP 功能跟踪（--features 模式）

设置 --features 后，本次运行还会生成查询与功能的矩阵。跟踪的功能及其解读方式如下：

功能	“拥有”意味着什么	优化信号
AI Overview	显示了 AI Overview，且品牌 URL 是其引用来源之一	仅表示是否被引用的二元信号。如需评估 AI 可见性的得分，请使用 /digital-marketing-pro:geo-monitor
精选摘要	品牌在该查询的搜索结果中占据第 0 位	按适合提取的格式编写内容：段落（40-60 个词）、列表（5-8 项）或表格
People Also Ask	某个品牌 URL 回答了与该查询相关的 PAA 问题	针对 PAA 问题编写常见问题解答风格的 H2/H3 内容
知识面板	品牌实体对应的知识面板显示出来	加强实体信号（Wikidata、GBP、结构化数据）——参见 /digital-marketing-pro:entity-audit
本地商家包	品牌出现在地图三件套中	优化 GBP 和本地架构——参见 /digital-marketing-pro:local-seo
图片 / 视频轮播	品牌素材出现在轮播中	优化替代文本 / 文件名（图片），或标题、描述、文字稿（视频）
购物 / 站点链接	显示了品牌列表	产品架构 / 网站结构

功能机会的得分由可实现性（根据品牌当前排名和内容格式，距离赢得该功能有多近）× 流量影响（根据查询量和功能显著程度估算的点击率影响）计算得出。

输出

结构化排名报告（在 --features 模式下还包含 SERP 功能报告），内容包括：

• 排名快照：所有跟踪关键词的当前位置——排名、排名 URL、设备、国家/地区、日期，以及与基线和上次检查结果的比较，并以方向指标（上升、下降、稳定）表示
• 变化报告：自基线以来和自上次检查以来的排名变化——按降幅从大到小排序，并附带 7 天和 30 天趋势迷你图
• 提醒摘要：需要关注的关键词——按严重程度（严重、重大、轻微）分组，列出具体排名变化、受影响的 URL 和建议的调查步骤
• SERP 功能矩阵 （--features）：查询与功能的网格，显示哪些功能出现、由谁拥有（品牌、竞争对手或其他对象），以及自上次快照以来的变化——包括 AI Overview 是否出现以及品牌是否被引用
• 功能机会列表 （--features）：按优先级排列的品牌尚未拥有、但有望实际争取的功能，并附上具体的内容 / 架构建议
• 竞争对手对比：跟踪的竞争对手域名的相对排名（及功能所有权）变化——谁提升了排名、谁下降了排名、每个关键词的正面对比，以及竞争差距随时间的趋势

提示与注意事项

• GSC 不提供 AI Overview 引用导出数据。 --features 中的 AI Overview 信号基于观察（是否出现 AIO、是否引用了品牌）。请通过 /digital-marketing-pro:gsc-ai-performance 核对实际 AI 展示数据，并通过 /digital-marketing-pro:geo-monitor 查看 AI 可见性得分。
• 排名变化比点击量 / 展示量变化更嘈杂——关键词在第 8 位和第 12 位之间波动，会造成很大的百分比变化，但意义不大。诊断时应更多参考展示量 / 点击量的变化。
• GSC 数据约有 3 天延迟。 提取“当前”数据时，数据窗口的结束日期应设为 3 天前。
• 不要跟踪过多关键词。 有效跟踪 50-150 个高价值关键词，胜过将 2,000 个关键词都当作噪声跟踪。

使用的 Agent

• seo-specialist — 关键词排名和 SERP 功能分析、功能归属判定、排名变化诊断（算法更新、技术问题、竞争对手挤占或内容衰退）、基线设定和趋势计算，以及针对不同严重程度的建议行动
• performance-monitor-agent — 生成提醒并划分严重程度、管理监控计划、检测阈值超限并与滚动窗口进行比较、跟踪趋势并进行 7 天和 30 天方向分析，以及格式化通知

另请参阅

• /digital-marketing-pro:geo-monitor — 对 6 个标准 AI 平台上的 AI 可见度进行评分（AI 可见度评分标准）
• /digital-marketing-pro:gsc-ai-performance — 来自 GSC 的实际 AI Overview / AI Mode 展示次数
• /digital-marketing-pro:seo-drift — 比较两份排名快照并找出变动最大的项目