SuperAPI AI 工具集

performance-monitor

营销与增长

查看项目

更新于 10-15 11:29

技能介绍

用途

Performance Monitor 是一个监控技能,包含两种模式,用于 SEO 与 GEO 性能的回顾性报告与前瞻性告警。

  • report 模式:构建面向利益相关者的多指标快照,覆盖已经发生的情况(流量、排名、GEO/AI、权威度、外链、内容),并将环比变化转化为按优先级排序的建议。
  • alert 模式:配置前瞻性的阈值与异常通知,使排名、流量、技术健康度、外链、竞争对手位置或 AI 引用出现下降时,在人工发现之前触发告警。

根据意图选择模式:过去时报告 → report;将来时“告诉我何时” → alert。未明确说明时,根据动词时态推断。

主要能力

report 模式覆盖以下部分:报告参数定义、执行摘要、自然流量、关键词排名、GEO/AI 表现、域名权威度(CITE)、内容质量(CORE-EEAT)、外链、内容表现、建议、完整报告汇编。每个指标需标注来源、时间、窗口和目标,并与上一周期或对照进行比较。

alert 模式覆盖:告警类别定义(排名、流量、技术、外链、竞争对手、GEO/AI、品牌)、按类别配置告警规则(触发条件、阈值、告警名称、优先级)、告警响应计划(Critical/High/Medium/Low 对应响应时间与后续动作)、告警投递设置(渠道、路由、冷却时间、维护窗口、升级路径)、告警摘要输出。

范围边界:该技能不计算 CORE-EEAT 内容评分或其否决项(T04/C01/R10),该门由 content-quality-auditor 负责;不计算 CITE 域名评分或其否决项(T03/T05/T09),该门由 domain-authority-auditor 负责。本技能仅在相关门已产出分数时报告这些分数并监控其变化,本身从不评分。逐条排名位置变化属于 rank-tracker。

使用方式

最短有效调用:performance-monitor <domain>(模式自动推断)。

report 模式示例:

  • Create an SEO performance report for [domain] for [time period]
  • Generate an executive summary of SEO performance for [month/quarter]
  • Create a GEO visibility report for [domain]

alert 模式示例:

  • Set up SEO monitoring alerts for [domain]
  • Create ranking drop alerts for my top 20 keywords
  • Alert me when AI citations for [domain] drop

输出:report 返回指标表 → 变化内容 → 原因 → 下一步行动仪表板,每个数字均带来源标签;alert 返回告警配置摘要,包含命名触发器、阈值、优先级和投递路由。两者均输出可供 memory/monitoring/ 使用的交接摘要。

所有集成均为可选。Tier 1(无密钥)适用于两种模式;带密钥的工具为可选的 Tier 2/3。无工具时,report 模式需向用户索取分析导出、Search Console 数据、排名数据和 KPI;alert 模式需索取基线、关键关键词、投递偏好和历史数据。

零依赖测量循环(两种模式):每个报告的变化或触发的告警都应来自计算出的差值,而非目测估计。存储每期 KPI 并让 ledger 计算变动:

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/ledger.py" record <domain> --source monitor --data '{"sessions": ..., "clicks": ..., ...}'

然后使用 ledger.py diff <domain> --source monitor 获取周期差值,使用 ledger.py trend <domain> --source monitor --field <kpi> 获取趋势线。每个数字标注为 Measured / User-provided / Estimated,并将结果变动归因于对照而非最新变更。

适用场景

  • 需要生成月度、季度或自定义周期的 SEO 性能报告,面向高管、营销、技术或客户受众。
  • 需要为关键指标(排名、流量、技术健康度、外链、竞争对手、GEO/AI、品牌)设置持续监控与告警。
  • 需要将已产出的 CITE 或 CORE-EEAT 分数纳入报告并监控其变化。
  • 需要在变更后通过固定回读窗口和对照来验证效果,区分 Promote / Keep-testing / Rollback / Unproven。

限制

  • 不计算 CORE-EEAT 或 CITE 评分,也不执行其否决项;这些由对应的审计门负责。
  • 逐条排名位置变化由 rank-tracker 负责,本技能不重新计算。
  • 报告需要周期对比,对比周期是必需的而非可选的;无法确定时需向用户询问。
  • alert 模式需要基线或正常波动参考,否则阈值将是任意的;无基线时需向用户询问或使用默认值并标注为 Estimated。
  • 缺失的指标应标注为 N/A 或“Not yet evaluated”,不得编造。
  • 观察到的变化与合理解释需分开,未经证实的解释不得报告为确认原因。
  • 保存结果前需询问用户,写入 memory/monitoring/,文件名为 YYYY-MM-DD-<topic>.md。

告警阈值快速参考

指标 警告 严重 频率
自然流量 -15% WoW -30% WoW 每日
关键词位置 下降 >3 位 下降 >5 位 每日
索引页面 变化 -5% 变化 -20% 每周
抓取错误 每日新增 >10 每日新增 >50 每日
Core Web Vitals "Needs Improvement" "Poor" 每周
外链丢失 1 周内 >5% 1 周内 >15% 每周
AI 引用丢失 任何关键查询 >20% 查询 每周
安全问题 任何检测到 任何检测到 每日

陡降触发器(始终开启):如果自然流量或聚合关键词排名低于其滚动基线(默认:同一星期几区间的过去 28 天中位数)超过 30%,无论类别如何均触发 Critical 告警。使用滚动中位数而非单一前一日,以避免单个噪声数据点触发。基线需标注 Measured / User-provided / Estimated。

对照回读

报告的变化或触发的告警只有在固定回读窗口内胜过对照时才构成证据。回读窗口需提前按变更类型选择(内容刷新 7/14/28/56 天;新内容 14/28/56/90;技术修复每日 ×7 然后 28;AEO/GEO 呈现每周),窗口内不应对噪声做出反应。触发的告警开启回读窗口,而非即时结论——需确认下降持续后再宣布事件。

必需回读字段:页面/内容/变更引用 + 哈希 · 当前 head · 测量合约引用/哈希 · 负责人 · 基线/候选/对照窗口 · 证据引用 · 主要 + 次要指标 · 决策 · 注意事项 · 下一补丁 · 下次回读日期 · 适用索引回执。

决策标记:Promote(主要指标超过门槛胜过对照)、Keep-testing(有趋势但尚未显著)、Rollback(以相同门槛落败)、Unproven(其他情况)。报告差值对对照,而非原始差值。

下一步技能

按模式条件,然后终止:

  • report 之后 — 变更需要持续监控 → 以 alert 模式运行本技能。权威度部分标记为“Not yet evaluated” → domain-authority-auditor;内容质量 → content-quality-auditor。无后续动作的一次性报告 → 终止。
  • alert 之后 — 请求报告节奏 → 以 report 模式运行本技能。独立告警设置 → 终止。

终止规则:适用 visited-set 和 max-depth: 3 规则。不要重新进入本链中已运行的模式(report→alert→report 为 visited-set 停止);如果路由不明确,呈现选项并停止,而非自动跟随。