zach-sif-cvr-threshold-analyzer

name	zach-sif-cvr-threshold-analyzer
description	基于领星 ASIN 360 或同类日业务报表，以及用户自己 SIF MCP 导出的日级关键词自然排名 JSON，回测 CVR 与核心词/稳定词自然排名波动的关系，并输出观察线、危险线、广告 CVR 确认线。 使用时机：站外放量、达人投放、联盟投放或内容种草后，需要判断 CVR 低到什么区间会增加自然排名波动风险。 触发词：/zach-sif-cvr-threshold-analyzer
benefits-from	[]
user-invocable	true
allowed-tools	["Read","Write","Edit","Bash","Glob","Grep"]
risk-level	medium

前置建议

本公开版 Skill 是自包含的，不依赖作者的本地工作区、店铺配置或私有数据源。

开始执行前，建议先读取本 Skill 自带材料：

• references/input_schema.md — 领星 ASIN 360 业务报表字段和兼容别名
• references/threshold_method.md — 阈值、命中率、召回率、Lift 的计算口径
• scripts/analyze_cvr_rank_threshold.py — 离线阈值分析脚本
• examples/business-report-sample.csv — 脱敏业务报表示例
• examples/sif-daily-keyword-sample.json — 脱敏 SIF 日级关键词排名缓存示例

定位

这个 Skill 用来回答一个具体问题：

站外放量期间，如果 ASIN 的整体 CVR 或广告 CVR 低于某个区间，是否更容易引发核心词或长期稳定词的自然排名波动？

它不是站外归因工具，也不会替用户修改广告、预算、价格、Coupon 或 Listing。它只把业务报表里的转化数据，与 SIF 日级关键词自然排名数据对齐，给运营一个可盯盘的风险阈值。

输入参数

参数	必须	默认值	说明
业务报告	是	-	.csv / .xlsx / .xlsm，优先使用领星 ASIN 360 日级 ASIN 业务数据
ASIN	是	-	目标 ASIN
SIF 缓存	是	自动查找输出目录内默认缓存名	用户自己的 SIF MCP/tooling 导出的日级关键词 JSON
站点	否	US	用于输出标识
品牌	否	UnknownBrand	只用于输出目录和报告标题
投放开始日期	否	空	用于 pre/post 标记和稳定词筛选
核心关键词	否	SIF 分数自动筛选	推荐人工传入 2-6 个核心大词或型号词
输出目录	否	outputs/zach-sif-cvr-threshold-analyzer/{brand}/	报告与 CSV 输出位置

执行流程

Step 1: 准备业务报表

1. 从领星 ASIN 360 导出目标 ASIN 的日级业务报表，至少包含日期、ASIN、Session、整体 CVR。
2. 如果字段名不同，按 references/input_schema.md 做映射。
3. 如果报表内有多个 ASIN，必须用 --asin 指定单个目标，不要混合分析。

Step 2: 准备 SIF 日级关键词缓存

让用户当前 IDE / Agent 调用用户自己的 SIF MCP，按日期获取目标 ASIN 的关键词流量和自然排名明细，并保存为 JSON。

缓存建议结构：

{
  "source": "user-provided SIF cache",
  "daily": {
    "2026-01-01": {
      "details": [
        {
          "keyword": "example keyword",
          "scoreRatio": 0.02,
          "pchangeReason": {
            "nfInfo": {"change": "10_16"},
            "spInfo": {"change": "1_2"}
          }
        }
      ]
    }
  }
}

脚本只读取本地 JSON，不会直接访问任何作者私有服务。

Step 3: 运行阈值分析

python3 skills/zach-sif-cvr-threshold-analyzer/scripts/analyze_cvr_rank_threshold.py \
  --business-report skills/zach-sif-cvr-threshold-analyzer/examples/business-report-sample.csv \
  --sif-cache skills/zach-sif-cvr-threshold-analyzer/examples/sif-daily-keyword-sample.json \
  --asin B0PUBLIC01 \
  --brand ExampleBrand \
  --site US \
  --launch-date 2026-01-05 \
  --core-keywords "portable espresso maker,travel coffee maker" \
  --analysis-date 2026-01-20

Step 4: 解释排名波动事件

脚本自己定义“排名波动事件”，不是直接读取 SIF 的结论字段：

• 核心词自然位在 0/1/2 天窗口内下滑 5 位以上；
• 或核心词从 P1 掉出；
• 或稳定词篮子中 30% 以上关键词同步下滑。

稳定词篮子从投放前窗口自动筛选：

• 出现天数足够；
• 自然位中位数在 P1 范围内；
• SIF 有稳定流量贡献。

Step 5: 输出三条线

1. 观察线：优先高召回率，宁可早提醒，适合日常盯盘。
2. 危险线：优先高命中率和 Lift，适合暂停或收缩站外放量前复核。
3. 广告 CVR 确认线：只做辅助确认，用来判断广告流量是否也在低效承接。

如果样本不支持某条线，必须写“未找到足够稳健的阈值”，不要强行给伪精确数字。

输出文件清单

默认输出到：

outputs/zach-sif-cvr-threshold-analyzer/{brand}/

文件	格式	命名
主报告	.md	{YYYY-MM-DD}_{site}_{asin}_CVR自然排名阈值分析.md
日级面板	.csv	{YYYY-MM-DD}_{site}_{asin}_CVR排名阈值_日级面板.csv
阈值候选	.csv	{YYYY-MM-DD}_{site}_{asin}_CVR排名阈值_候选阈值.csv
稳定词篮子	.json	{YYYY-MM-DD}_{site}_{asin}_CVR排名阈值_稳定词篮子.json

风险与边界

• 本 Skill 不做：
  • 不直接修改广告预算、出价、否词、价格、Coupon 或 Listing
  • 不上传用户报表
  • 不沉淀真实店铺数据
  • 不把阈值解释成 Amazon 官方算法阈值
• 需要人工复核：
  • 样本少于 21 天
  • 业务报告日期不连续或关键字段缺失
  • SIF 关键日期缺失
  • 观察线 / 危险线给出的动作涉及预算、价格或促销调整
  • 核心关键词没有人工确认
• risk-level = medium：
  • 本 Skill 会给出运营动作建议，但任何预算、价格、投放或页面执行都需要用户确认后手动完成。

完成后

报告完成状态：

• DONE — 业务报告、SIF 缓存、阈值报告和 CSV 面板全部完成
• DONE_WITH_CONCERNS — 已生成，但存在样本较小、SIF 缺日或某条阈值不稳健
• BLOCKED — 核心字段缺失、文件不可读、ASIN 无法确定或 SIF 缓存缺失
• NEEDS_CONTEXT — 需要用户补充 ASIN、业务报告、投放开始日期或核心关键词

告知用户：

1. 分析对象：品牌、ASIN、站点、日期窗口
2. 三条线：观察线、危险线、广告 CVR 确认线
3. 文件路径：主报告、日级面板、候选阈值和稳定词篮子