APIClaw — 亚马逊每日市场雷达

一键设置，无需值守；关键变动即时告警；响应语言与用户输入一致。

文件

凭证

必需：环境变量 APICLAW_API_KEY。可于 apiclaw.io/api-keys 免费获取。

输入（首次运行）

请在**单条消息中**提供以下全部信息：✅ my_asins（1–10 个）｜💡 competitor_asins（最多 20 个）｜📌 alert_preferences。可选：keyword、category。若未提供 category，则系统将根据首个被追踪的 ASIN 自动识别。

API 使用注意事项（至关重要）

1. 品类自动识别：categoryPath 将基于被追踪 ASIN 自动推断。若输出中 category_source 为 inferred_from_search，须向用户确认
2. 所有基于 keyword 的端点均必须显式指定 --category；仅针对 ASIN 的端点则无需
3. 直接使用 API 字段值：revenue = sampleAvgMonthlyRevenue（切勿用 price × sales 估算），sales = monthlySalesFloor，concentration = sampleTop10BrandSalesRate
4. reviews/analysis：需至少 50 条以上评论方可调用
5. 缺失 categoryPath 的聚合分析：数据严重失真

执行流程

1. daily-radar --asins "asin1,asin2,..." [--keyword X] [--category Y]（复合模式，自动从 ASIN 推断品类）
2. 与 {skill_base_dir}/data/last-run.json 比对以检测变化（首次运行仅建立基线，不触发告警）
3. 生成按告警级别排序的简报 → 快照保存至 {skill_base_dir}/data/last-run.json

告警规则

变化检测逻辑

• 价格变动 >5% → 🔴
• BSR 变动 >20% → 🟡
• Top 20 中出现新 ASIN（相较上次运行）→ 🟡

增长信号验证：

• 📊 持续性信号：连续 7 天以上方向一致
• 🔍 初步信号：连续 2–3 天出现变化
• 💡 单日脉冲：可能源于促销或补货

变化解读指南

按告警级别推荐行动

• 🔴 RED：需立即响应 —— 核查库存状态，必要时同步调价，排查质量问题 💡
• 🟡 YELLOW：建议持续观察 3–5 日再决策 —— 可能仅为短期波动 💡
• 🟢 GREEN：属机会窗口 —— 建议在 1–2 周内行动，抢占先机（避免竞品察觉）💡

输出规范

首次运行：输出“基线已建立” —— 仅含 KPI 仪表盘（当前快照），无任何告警。

后续运行：告警摘要 → RED 告警 → YELLOW 告警 → GREEN 机会 → KPI 仪表盘（今日 vs 昨日）→ 竞品动态 → 市场趋势 → 行动项 → 数据溯源 → API 使用统计。

语言（强制要求）

输出语言必须与用户输入语言完全一致。用户使用中文提问，则整份报告须为中文；用户使用英文提问，则输出全英文。例外：API 字段名（如 monthlySalesFloor、categoryPath）、端点名、技术术语（如 ASIN、BSR、CR10、FBA、credits）一律保留英文原文。

免责声明（强制，置于每份报告最上方）

本数据基于 APIClaw API 截止于 [date] 的抽样结果。月销量（monthlySalesFloor）为下限估计值。本分析仅供参阅，不可作为商业决策的唯一依据。执行任何操作前，请务必通过其他渠道交叉验证。

置信度标签（强制，每个结论均须标注）

• 📊 数据支撑型 —— 直接源自 API 返回数据（例如：“CR10 = 54.8% 📊”）
• 🔍 逻辑推断型 —— 基于数据进行合理推理（例如：“品牌集中度中等 🔍”）
• 💡 方向建议型 —— 属策略建议、预测或行动指引（例如：“建议切入 $10–15 价格带 💡”）

规则：策略类建议绝不可标为 📊；异常值（如增长 >200%）一律标记为 💡；用户自定义标准优先于 AI 判断。

样本偏差说明：“数据基于销量 Top [N] 商品抽样；小众新品可能存在覆盖不足。”

数据溯源（强制）

每份报告末尾须附如下表格：

端点及参数请从 JSON 输出中的 _query 字段提取。备注栏需注明：抽样方式、T+1 延迟、实时接口 vs 数据库查询、最低评论数门槛等。

API 使用统计（强制）

每条响应中的 meta.creditsConsumed 字段提取积分消耗。结尾须注明：Credits remaining: N。

API 预算：约 15–30 积分

实时查询 × ASIN 数量（5–15）＋历史数据（1–2）＋市场/品牌分析（3）＋商品详情（1）＋价格监控（2）＋品类分析（1）＋评论分析（1–3）。