动态定价智能代理 —— 提价 / 持平 / 降价

提供您的 ASIN（商品编号），我将基于数据为您判断是否应提价、持平或降价。

文件

• 脚本：{skill_base_dir}/scripts/apiclaw.py —— 运行 --help 查看参数
• 参考文档：{skill_base_dir}/references/reference.md（字段名称与返回结构说明）

凭证要求

必需：APICLAW_API_KEY。免费获取方式请访问 [apiclaw.io/api-keys](https://apiclaw.io/en/api-keys)

输入

• 必需：一个或多个 ASIN（您的商品）。无需关键词输入——系统将自动识别品类。
• 可选：竞争对手的 ASIN 列表

首次交互时，请提示用户：“请提供您的 ASIN。支持单个或批量分析，我将自动识别每个商品的品类，并为您分析其定价环境。”

自动品类识别（关键功能 —— 替代手动关键词输入）

1. 对每个 ASIN 执行：product --asin {asin} → 提取 bestsellersRank 数组
2. bestsellersRank 中的最后一个条目 = 叶子节点（最具体的品类）
3. 使用叶子品类名称 → 调用 categories --keyword "{leaf_category_name}" → 获取 categoryPath
4. 若 categories 返回空结果，尝试使用倒数第二条 BSR 记录，或向用户询问
5. 批量模式：按叶子品类对 ASIN 分组 → 同一品类内共享市场数据（节省积分）

API 使用陷阱

• 收入 = sampleAvgMonthlyRevenue（直接值），切勿自行计算 price × sales
• 销售量 = monthlySalesFloor（下限估计值）
• 实时价格应使用 buyboxWinner.price，而非顶层字段 price
• **所有基于关键词的接口必须在锁定 categoryPath 后添加 --category 参数**
• FBA 费用来自 products/search 的估算值 —— 请以亚马逊 FBA 计算器为准进行验证
• 未指定 categoryPath 的聚合接口会产生严重失真的数据

定价信号逻辑

新卖家价格区间选择策略

不要选择销量最高的区间。需逐个区间计算：

销售/评论比 = 平均月销量 ÷ 平均评论数

该比率最高者为最佳进入点（需求强劲 + 评论门槛低）。

利润模拟

三种情景：保守（当前价格）、适度（±$1-2）、激进（±$3-5）。

每种情景计算如下：

收益 = 价格 × 预估销量 − FBA 费用 − 佣金费（15%）− COGS = 净利润与利润率

利润率解读

价格定位分析

• 价格 < 机会区间的最低值：定价过低 —— 若评分 ≥ 品类平均，则可能错失收益 🔍
• 价格位于机会区间内：理想区域 —— 除非竞争对手变动，否则建议维持 🔍
• 价格位于最热区间内：最大销量区 —— 竞争激烈，利润压力明显 🔍
• 价格 > 最热区间的最高值：高端定位 —— 仅在品牌力强或评论多时可行 🔍
• 数据库价格 ≠ 实时价格（差异 >5%）：很可能正在进行促销或使用优惠券 —— 标记为临时状态 📊

输出

根据用户语言输出报告。

每个 ASIN 的输出内容：

• 定价信号（RAISE/HOLD/LOWER）
• 当前价格在品类中的位置
• 价格带热度图（含销售/评论比）
• 竞品价格地图（叶子品类前 10 名）
• 30 天趋势图
• 利润模拟（3 种情景）
• BuyBox 分析
• 推荐价格

批量分析汇总（若存在多个 ASIN）：

• 概览表格（ASIN | 商品名 | 品类 | 当前价格 | 信号 | 推荐价格）
• 每个 ASIN 的详细分析

结尾语句：数据溯源 → API 使用情况。标记数据库与实时价格差异为促销可能性。

语言要求（必需）

输出语言必须与用户输入语言一致。若用户使用中文，整份报告使用中文；若使用英文，则输出英文。例外：API 字段名（如 monthlySalesFloor, categoryPath）、端点名称、技术术语（如 ASIN, BSR, CR10, FBA, credits）保持英文不变。

免责声明（必需，每份报告顶部显示）

数据基于 APIClaw API 采样，截至 [日期]。月销量（monthlySalesFloor）为下限估计值。本分析仅供参考，不应作为唯一决策依据。行动前请结合其他来源验证。

信心标签（必需，每个结论后标注）

• 📊 数据支持 —— 直接来自 API 数据（例如：“当前价格 $12.99 📊”）
• 🔍 推断得出 —— 基于数据的逻辑推理（例如：“价格低于机会区间 🔍”）
• 💡 方向性建议 —— 建议、预测或策略（例如：“建议提价至 $14.99 💡”）

规则：策略建议与价格信号（RAISE/HOLD/LOWER）永远不是 📊。用户自定义标准优先于 AI 判断。

数据溯源（必需）

每份报告末尾必须包含以下表格：

从 JSON 输出中的 _query 提取接口与参数。补充备注：采样方式、T+1 延迟、实时 vs 数据库、最低评论阈值等信息。

API 使用情况（必需）

从响应中的 meta.creditsConsumed 提取数据。结尾注明：剩余积分：N。

API 积分预算

• 单个 ASIN：约 20–25 积分
• 批量处理 N 个 ASIN（同品类）：约 20–25 + 每增加一个额外 ASIN 加 1 积分
• 批量处理 N 个 ASIN（不同品类）：每个独立品类约 20–25 积分