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

分析框架

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

参数速查

| 字段 | 必填 | 取值 / 说明 | | :--- | :--- | :--- | | workflow | 必填 | 数据引擎应用名，以 qhkit workflow list 输出为准 | | （其余字段） | — | 目标站点 / 品类 / 时间范围等，用 qhkit workflow options 查 | | resourceUrl | 选填 | 视频链接反推脚本时填 | | inspireTaskId | 选填 | video-inspire status 查询用 |

环境自举 (Self-Bootstrapping)

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

环境自检：运行 qhkit config show，如已输出脱敏配置即表示就绪。
快速安装：
```
npm i -g @iqinghu/qhkit
```
如国内网络访问 npm 官方源超时，可添加国内镜像：--registry=https://registry.npmmirror.com
获取与配置密钥：
- 访问官方控制台注册并登录：https://www.iqinghu.com/
- 在个人中心 API 密钥管理页复制 Token；
- 执行绑定命令：qhkit config set --token <您的Token> --env prod。

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

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

| 报错 | 含义 | 处理 | | :--- | :--- | :--- | | {"ok":false,"stage":"config"} | 未检测到登录密钥 | 按「环境自举」配置 Token 后重试 | | enough:false | 积分余额不足 | 前往 https://www.iqinghu.com/ 控制台充值或签到领取免费额度 | | stage:"runtime" | 参数不合法 | 用 qhkit <命令> options 核对字段名与取值后重发 | | stage:"submit" | 任务提交失败 | 检查网络与密钥配置后重试 |
幂等提示：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/