ahang1598 Amazon Competitor Monitor（最终版）
面向中国亚马逊卖家的竞品动态监控技能。整合 Linkfox 最小工具集，完成采集 → 清洗 → 异常检测 → 文字报告 → 可视化交付的完整闭环。
用户偏好（贯穿始终）：
- 全部中文输出
- 异常描述风格贴近 Linkfox 截图（简洁、前后对比、可行动建议）
- 去重后只保留 5 个核心工具，避免冗余调用
- 可视化优先交互 HTML（ECharts + 深色主题 + 多图联动），其次 Excel / PPT
- 异常检测前必须做数据清洗，降低误报
核心工具集（5 个历史/快照源 + 2 个实时源）
历史与快照数据（5 个核心）
- linkfox-keepa-product-series — 历史价格、BSR、销量估算、评论数趋势、库存
- linkfox-amazon-product-detail — 当前 Listing 快照（标题、图片、五点、A+、价格、BSR、评分、变体）
- linkfox-sif-asin-keywords — 流量关键词 + 自然/广告排名 + 流量占比
- linkfox-sellersprite-competitor-lookup — 竞品发现与监控池扩展
- linkfox-amazon-reviews-list — 评论内容与星级分布
实时前台数据（2 个补充，按需触发）
- linkfox-amazon-search — 模拟亚马逊前台关键词搜索，获取实时自然排名位、广告位（SP/SB）、搜索页价格、徽标（Amazon's Choice / Best Seller）。用于：Step 1 按关键词发现竞品、Step 2 验证 SIF 排名延迟、Step 4 检测关键词排名异常时做前台实况核对
- linkfox-amazon-search-by-image — 以商品图片搜亚马逊，跨 8 站点找视觉相似竞品。用于：Step 1 用户只有图片无 ASIN 时扩展竞品池
需配置
LINKFOXAGENT_API_KEY且已安装对应 Linkfox skills。
完整工作流
输入 ASIN/关键词
↓
1. 初始化监控对象（扩展竞品池）
↓
1.5. 积分消耗预估与预警（必做，见 references/credit-alert-rules.md）
↓
2. 数据采集（每日轻量 / 每周深度）
↓
3. 数据清洗（必做，见 references/data-cleaning.md）
↓
4. 异常检测（references/anomaly-rules.md）
↓
5. 文字报告（references/report-template.md）
↓
6. 可视化（按需：HTML / Excel / PPT，见 references/visualization-guide.md）
↓
7. 快照持久化（供下次增量对比）
1. 初始化监控对象
- 接收 ASIN 列表 / 关键词 / 品牌 / 商品图片
- 仅关键词或品牌时，先调
linkfox-sellersprite-competitor-lookup扩展（Top 10–20） - 有商品图片无 ASIN 时，调
linkfox-amazon-search-by-image以图搜图找相似竞品 - 需要前台实况验证时，调
linkfox-amazon-search按关键词搜索，获取实时排名与广告位 - 默认站点 US，可指定 UK/DE/JP 等
- 单次建议 ≤20 个 ASIN
1.5. 积分消耗预估与预警（强制）
在初始化完成、已知最终 ASIN 列表与监控模式后、正式采集前执行。详见 references/credit-alert-rules.md。
- 按公式计算预计调用次数（每日轻量 = ASIN × 2；每周深度 = ASIN × 4；竞品扩展 +1）
- 分级预警：🟢 ≤20 / 🟡 21–50 / 🟠 51–100 / 🔴 >100
- 🟡 及以上必须向用户展示预估明细表并等待确认后再执行
- 提供优化建议（减 ASIN / 改轻量 / 跳评论 / 跳 SIF / 分批）
- 创建定时任务时需换算日/周累计消耗
2. 数据采集
每日轻量：Keepa series（近 7–30 天）+ product-detail → 算变化率
每周深度：上述 + SIF asin-keywords + reviews-list
实时补充（按需）：linkfox-amazon-search 按关键词抓前台搜索页（排名位、广告位、徽标），弥补 SIF 数据延迟
3. 数据清洗（强制）
在异常检测前执行，详见 references/data-cleaning.md。核心规则：
- 时间窗口对齐
- 评分数大降但评分几乎不变 → 降级为「疑似评论清理/变体合并」
- 销量归零但 BSR 仍在且非断货 → 标记「疑似数据延迟」
- 价格用 Buy Box，并单独记录 Deal 状态变化
- 极值过滤（价格、BSR、评分合理区间）
- 同一指标前后对比禁止跨工具混用
4. 异常检测
规则见 references/anomaly-rules.md。输出优先级：高 / 中 / 低。
高优先级典型场景：
- 评分数 ±30% 或绝对变化大，且评分同步变化
- 价格 ±5% 或 Deal 状态切换
- 销量骤降 50%+ 或归零（已排除断货/延迟）
- BSR 恶化 ≥20%
5. 文字报告
始终输出中文 Markdown：
- 异常清单（「检测到 X 项异常」风格）
- 核心指标对比表
- 关键词流量摘要（深度时）
- 行动建议（立即 / 观察 / 策略参考）
模板：references/report-template.md。
6. 可视化交付
| 格式 | 触发词 | 引擎 / 方式 | 关键能力 |
|---|---|---|---|
| 交互 HTML | 仪表盘、可视化、HTML、交互、深色 | ECharts 5 单文件 | 深色主题、优先级筛选、搜索、价格/BSR/评分数多图联动（axisPointer + dataZoom + 图例同步）、localStorage 安全读写 |
| CSV 数据看板 | CSV、表格、数据导出 | Python csv 模块 | 多表 CSV（异常清单、指标对比、趋势数据、关键词），可直接导入 Excel/Sheets |
| PPT 周报 | PPT、周报、汇报、演示 | ppt-maker skill |
HTML 演示稿，7 页：封面→异常→指标→价格图→评论销量→行动建议→结尾 |
默认策略：
- 只说「监控/异常」→ 仅 Markdown
- 说「可视化/仪表盘」→ 优先生成 ECharts HTML
- 说「CSV」→ 生成多表 CSV
- 说「PPT/周报」→ 调
ppt-maker生成 HTML 演示稿 - 说「全部」→ 三种都生成
颜色语义（三套交付物统一）：
- 高优先级 / 不利 → 红
#E63946 - 中 / 需关注 → 橙
#F4A261 - 低 / 观察 → 黄
#E9C46A - 有利 → 绿
#2A9D8F - 主色 → 深蓝
#1B3A4B+#2E86AB
HTML 实现要点（最终版）：
- ECharts 5 CDN，
echarts.connect连接价格/BSR/评分数三张折线 - dataZoom（inside + slider）三图同步
- 图例
legendselectchanged跨图同步显隐 - 深色主题：
data-theme="dark"+echarts.init(dom, 'dark') - localStorage 用 try/catch 安全封装（兼容沙箱 iframe）
- 评分数图用 markPoint 标最低点；销量柱用圆角
完整字段映射与生成步骤见 references/visualization-guide.md。
7. 状态持久化
每次运行保存快照 JSON（ASIN → 时间戳 + 关键指标 + 历史序列），供下次增量对比与图表数据区使用。
注意事项
- Keepa series 作历史主源，product-detail 作当前快照
- SIF 单 ASIN 循环调用
- 异常描述保持「前后数值 + 百分比 + 可能原因 + 建议」结构
- 可视化数据必须与文字报告一致，先检测再出图
- 输出文件统一放会话目录
linkfox/<YYYY-MM-DD>/<session>/下的data/（数据）与reports/（报告）
触发示例
- 「监控这几个竞品 ASIN」
- 「跑本周竞品异常检测」
- 「做可视化仪表盘」
- 「出 Excel 仪表盘 / PPT 周报」
- 「生成带多图联动的 HTML 仪表盘」
- 「清洗数据后再检测异常」
- 「把这次结果全部可视化」