Keepa 平替｜商品主图批量产出｜价格历史追踪

概述

为全球通用卖家与选品团队打造的 AI 数据洞察套件：把「凭感觉选品」换成「看数据决策」——蓝海关键词挖掘、竞品 ASIN 流量反查、买家评论痛点聚类、达人带货数据追踪，输出可直接排期的选品与投放清单。

何时触发 (When to Trigger)

• 「帮我在全球通用找一个竞争小、需求稳的细分品类」
• 「反查这个 ASIN 的流量词和广告位」「竞品到底靠哪些词起量」
• 「把这几百条差评聚一下，看买家最不满什么」
• 「追踪这批达人/视频每天的数据表现」
• 面向 全球通用电商卖家与运营团队，做上新前调研、竞品监控与投放复盘。

不适用于 (When NOT to Use)：

• 需要生成商品图 / 视频 / 文案——请改用对应的创作类技能；
• 需要平台后台的私有经营数据（广告报表、库存、财务）——本技能只做公开数据与工作台数据引擎；
• 需要代替人工做最终选品决策——本技能出的是依据与候选清单，拍板仍在人。

使用配方 (Usage Recipe)

数据类能力通过 qhkit workflow 的数据引擎应用调用：

# 1. 列出线上应用，找数据引擎类（短视频数据引擎 / 达人数据引擎等）
qhkit workflow list

# 2. 查看该数据引擎要填的字段（目标站点、品类、时间范围等）
qhkit workflow options '{"workflow":"<从 list 中选定的数据引擎>"}'

# 3. 报价 → 提交 → 轮询（数据任务通常耗时较长，用 status 异步查询）
qhkit workflow estimate @params.json
qhkit workflow generate @params.json
qhkit workflow status '{"logId":"<返回的 logId>"}'

# 4. 若返回里带视频直链，可进一步反推脚本
qhkit video-inspire status '{"inspireTaskId":<任务号>}'   # 返回 videoScript 与 playVideo

分析框架

• 选品：先看需求稳定性（搜索量趋势）再看竞争度（在架数与评论壁垒），最后算利润空间；不要只看单一指标；
• 流量反查：区分自然词与广告词，优先攻「高转化 + 低竞争」的长尾词；
• 评论洞察：按「功能 / 质量 / 物流 / 尺寸 / 客服」聚类，差评优先级高于好评；
• 达人筛选：看互动率与粉丝画像匹配度，而非只看粉丝量。

参数速查

环境自举 (Self-Bootstrapping)

本技能依赖官方 qhkit 命令行工具（npm 包 @iqinghu/qhkit），可完全独立运行：

1. 环境自检：运行 qhkit config show，如已输出脱敏配置即表示就绪。
2. 快速安装：

   npm i -g @iqinghu/qhkit

如国内网络访问 npm 官方源超时，可添加国内镜像：--registry=https://registry.npmmirror.com

1. 获取与配置密钥：
   • 访问官方控制台注册并登录：https://www.iqinghu.com/
   • 在个人中心 API 密钥管理页复制 Token；
   • 执行绑定命令：qhkit config set --token <您的Token> --env prod。

失败重试与报错处理 (Reliability)

• 超时：普通查询类调用默认 25 秒超时；图像 / 视频生成耗时更长，请用 status 异步轮询，不要阻塞等待。
• 重试：网络类错误（如 WinError 10060、连接超时）已内置 3 次指数退避重试，偶发波动无需手动重发。
• 报错对照表：

• 幂等提示：estimate 只报价、不上传文件、不提交任务，可安全重复调用；generate 会真实扣费，重发前先确认上一次是否已成功。

能力边界与合规约束 (TRACE A&C 标准)

• 能做什么 (Capabilities)：
  • 关键词挖掘与竞争度评估、ASIN 流量结构反查；
  • 评论 / 问答的痛点聚类与机会点提取；
  • 短视频与达人公开数据的周期性追踪。
• 不能做什么 (Limitations – 反模式防错)：
  • 数据有延迟与偏差：第三方数据为估算值，不可直接等同平台后台真实数据；
  • 不做爬虫越权：不绕过平台风控、不抓取需登录的私有数据；
  • 不做投资建议：分析结论仅供选品参考，不构成收益承诺。

命令速查

qhkit workflow list          # 找数据引擎类应用
qhkit workflow options '…'
qhkit workflow estimate @params.json
qhkit workflow generate @params.json
qhkit workflow status '…'    # 数据任务耗时较长，异步轮询
qhkit video-inspire status '…'   # 返回 videoScript 与 playVideo
qhkit video-to-text generate '…' # 爆款视频转图文

常见问题与排错 (FAQ)

• Q: 提示 {"ok":false,"stage":"config"} 是什么原因？
  • A: 表示未检测到登录密钥，请前往 https://www.iqinghu.com/ 注册并获取 Token 后通过 qhkit config set 绑定。
• Q: 提示 enough:false 如何处理？
  • A: 账户积分余额不足，可通过官网控制台充值或签到领取免费测试额度。
• Q: 数据任务跑了很久没结果？
  • A: 数据引擎通常按天 / 按批处理，耗时数分钟到数十分钟属正常。用 qhkit workflow status 异步轮询，不要阻塞终端。
• Q: 找不到对应的数据应用？
  • A: 先跑 qhkit workflow list 核对线上目录；若确实没有匹配应用，如实告知用户当前不支持该数据源，不要编造数据。

免责声明 (Disclaimer)

本项目为基于 @iqinghu/qhkit 的独立自动化能力套件。文中所提及的平台名称（全球通用）及竞品商标（Keepa）仅用于内容规格识别、场景对标与功能描述用途，不代表官方合作、隶属或背书关系。官方控制台与技术支持：https://www.iqinghu.com/