Back to Details

rank-tracker

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Rank Tracker

排名追踪工具

Tracks keyword positions, SERP feature ownership, and AI visibility over time.
随时间追踪关键词排名、SERP功能归属以及AI可见度。

Quick Start

快速开始

Set up rank tracking for [domain] targeting these keywords: [keyword list]
Analyze ranking changes for [domain] over the past [time period]
为[域名]设置排名追踪，目标关键词：[关键词列表]
分析[域名]在过去[时间段]内的排名变化

Skill Contract

技能协议

Expected output: a ranking report or delta summary plus the standard handoff summary for 
memory/monitoring/
.
  • Reads: current rankings, prior baselines, target keyword list, market/device, and any user-provided or tool metrics.
  • Writes: a user-facing monitoring deliverable and reusable summary.
  • Promotes: significant changes, confirmed anomalies, follow-up actions, and pending decisions to 
    memory/open-loops.md
    .
  • Done when: every tracked keyword shows current position vs baseline with a labeled delta (or N/A); each position cites its source (tool export / user-provided / estimated); and biggest movers and likely causes are named.
  • Primary next skill: performance-monitor when recurring monitoring should become automated.
预期输出：一份排名报告或变化值摘要，加上
memory/monitoring/
的标准交接摘要。
  • 读取：当前排名、过往基准数据、目标关键词列表、市场/设备信息，以及任何用户提供或工具生成的指标。
  • 写入：面向用户的监控交付物和可复用摘要。
  • 推送：将重大变化、已确认的异常情况、后续行动和待决策事项推送到
    memory/open-loops.md
    。
  • 完成标志：每个被追踪的关键词都显示当前排名与基准的对比，并标注变化值（或N/A）；每个排名都注明其来源（工具导出/用户提供/估算）；指出排名变动最大的关键词及其可能原因。
  • 主要后续技能：当需要将定期监控自动化时，使用performance-monitor。

Handoff Summary

交接摘要

Emit the standard shape from skill-contract.md §Handoff Summary Format.
输出skill-contract.md §交接摘要格式中的标准格式内容。

Data Sources

数据源

All integrations optional (see CONNECTORS.md). With tools, pull rankings from ~~SEO tool, impressions from ~~search console, traffic from ~~analytics, and AI citations from ~~AI monitor. Without tools, ask for positions, volumes, competitor data, and SERP feature status.
Zero-dependency measurement loop (no paid tool needed): never narrate a ranking movement you did not measure — record each check as a snapshot and let the ledger compute the delta. 
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/ledger.py" record <domain> --source rank --data '{"<keyword>": <position>, ...}'
, then 
ledger.py diff <domain> --source rank
for the change since the last check and 
ledger.py trend <domain> --source rank --field "<keyword>"
for the series. Record real Search Console positions when connected, or the positions the user provides at Tier 1. A ranking delta is a week-scale, confounded outcome — attribute it against a control (a holdout keyword/competitor), not against zero; see references/measurement-protocol.md. See scripts/connectors/README.md.
所有集成均为可选（详见CONNECTORS.md）。若使用工具，可从SEO工具获取排名数据，从搜索控制台获取曝光量数据，从分析工具获取流量数据，从AI监控工具获取AI引用数据。若不使用工具，则需询问用户获取排名、搜索量、竞争对手数据以及SERP功能状态。
零依赖测量循环（无需付费工具）：切勿描述未测量过的排名变动——将每次检查记录为快照，由分类账计算变化值。执行
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/ledger.py" record <domain> --source rank --data '{"<keyword>": <position>, ...}'
，然后通过
ledger.py diff <domain> --source rank
查看自上次检查以来的变化，通过
ledger.py trend <domain> --source rank --field "<keyword>"
查看趋势序列。若已连接搜索控制台，则记录真实的搜索控制台排名；否则记录用户提供的Tier 1排名。排名变化值是周度的、受混淆的结果——需对照对照组（保留的关键词/竞争对手）进行归因，而非对照零值；详见references/measurement-protocol.md。更多信息见scripts/connectors/README.md。

Decision Gates

决策节点

Stop and ask the user when:
  • No target keywords are provided and none can be inferred from 
    CLAUDE.md
    or prior monitoring records — offer: (1) supply a keyword list, (2) track the domain's top known terms, (3) cancel.
Continue silently (never stop for):
  • No prior baseline exists — record the current run as the baseline, label all positions as the first snapshot, and proceed (do not invent a "previous" position).
  • Missing optional tool data (SERP features, AI citations) — mark N/A and proceed.
需停止并询问用户的情况：
  • 未提供目标关键词，且无法从
    CLAUDE.md
    或过往监控记录中推断出关键词——提供以下选项：(1) 提供关键词列表，(2) 追踪域名的热门已知关键词，(3) 取消操作。
无需停止（静默处理）的情况：
  • 无过往基准数据——将当前运行记录为基准，标记所有排名为首次快照，继续执行（不得虚构“过往”排名）。
  • 缺失可选工具数据（SERP功能、AI引用）——标记为N/A并继续执行。

Instructions

操作步骤

When a user requests rank tracking or analysis:
  1. Set Up Keyword Tracking — configure domain, market, device, language, update frequency, priorities, and competitor watchlist.
  2. Record Current Rankings — output a position table where every row cites its source (tool export / user-provided / estimated), with position ranges, ranking URLs, feature ownership, and movement vs baseline.
  3. Analyze Ranking Changes — highlight biggest wins, declines, stable terms, new rankings, lost rankings, likely causes, and recovery ideas; each delta labeled against its baseline.
  4. Track SERP Features — compare ownership of snippets, PAA, image/video packs, local packs, and related feature shifts.
  5. Track GEO / AI Visibility — monitor AI Overview presence, citation rate, citation position, and trend; mark each value Measured (from an ~~AI monitor) or N/A if unobserved.
  6. Compare Against Competitors — report share of voice, head-to-head comparisons, and threat levels.
  7. Generate Ranking Report — output overall trend, key wins, concerns, opportunities, SERP feature changes, GEO visibility, and recommendations, with each metric carrying its source tag.
Label every metric Measured (tool/export), User-provided, or Estimated (model inference); never present an estimate as measured; if a required metric is unavailable, mark it N/A — do not invent it.
Reference: See Ranking Analysis Templates for the complete output templates for all seven steps.
当用户请求排名追踪或分析时：
  1. 设置关键词追踪——配置域名、市场、设备、语言、更新频率、优先级以及竞争对手监控列表。
  2. 记录当前排名——输出排名表，每行注明来源（工具导出/用户提供/估算），包含排名范围、排名URL、功能归属以及与基准的变动情况。
  3. 分析排名变化——突出显示排名上升最多、下降最多、稳定的关键词，新增排名、丢失排名的关键词，可能的原因以及恢复建议；每个变化值均标注其对应基准。
  4. 追踪SERP功能——对比摘要、PAA（People Also Ask）、图片/视频包、本地包等功能的归属变化。
  5. 追踪地域/AI可见度——监控AI概览的出现情况、引用率、引用位置及趋势；标记每个值为“已测量”（来自~~AI监控工具）或“N/A”（未观测到）。
  6. 与竞争对手对比——报告声量份额、一对一对比以及威胁等级。
  7. 生成排名报告——输出整体趋势、关键成果、关注点、机会点、SERP功能变化、地域可见度以及建议，每个指标均附带来源标签。
标记每个指标为已测量（工具/导出数据）、用户提供或估算（模型推断）；切勿将估算值作为已测量值呈现；若所需指标不可用，标记为N/A——不得虚构数据。
参考：所有七个步骤的完整输出模板详见排名分析模板。

Example

示例

A ranking report names the biggest winners, biggest drops, and next actions, with each position carrying its source tag and labeled delta against baseline.
一份排名报告会指出排名上升最多、下降最多的关键词以及后续行动，每个排名均附带来源标签和与基准对比的标注变化值。

Rank Change Quick Reference

排名变化快速参考

Response Protocol

响应协议

ChangeTimeframeAction
Drop 1-3 positionsWait 1-2 weeksMonitor — may be normal fluctuation
Drop 3-5 positionsInvestigate within 1 weekCheck technical issues and competitor changes
Drop 5-10 positionsInvestigate immediatelyRun a full diagnostic: technical, content, links
Drop off page 1Emergency responseComprehensive audit + recovery plan
Position gainedDocument and learnIdentify what worked and replicate
Reference: See Tracking Setup Guide for tracking setup, root-cause taxonomy, CTR benchmarks, SERP feature impact, and algorithm-update assessment.
变化情况时间范围行动
下降1-3名等待1-2周监控——可能为正常波动
下降3-5名1周内调查检查技术问题和竞争对手变化
下降5-10名立即调查执行全面诊断：技术、内容、链接
跌出第一页紧急响应全面审计+恢复计划
排名上升记录并总结经验确定有效措施并复制推广
参考：追踪设置、根本原因分类、CTR基准、SERP功能影响以及算法更新评估详见追踪设置指南。

Save Results

保存结果

Ask "Save these results?" If yes, write to 
memory/monitoring/
— see Skill Contract §Save Results Template.
询问“是否保存这些结果？”。若用户同意，写入
memory/monitoring/
——详见技能协议 §结果保存模板。

Reference Materials

参考资料

  • Tracking Setup Guide — Setup rules, feature tracking, and interpretation guidance
  • 追踪设置指南——设置规则、功能追踪及解读指南

Next Best Skill

最佳后续技能

Initial setup (no baseline) → performance-monitor. Subsequent runs (baseline exists) → Terminal. Visited-set rule applies per skill-contract.md.
首次设置（无基准数据）→ performance-monitor。后续运行（已有基准数据）→ Terminal。访问集规则详见skill-contract.md。