SuperAPI AI 工具集

linkfox-keepa-product-detail

数据与分析

查看项目

更新于 10-16 00:00

技能介绍

用途:这是一个通过 Keepa 商品请求 API 获取亚马逊商品结构化详情的技能,面向亚马逊卖家与分析师,可按一个或多个 ASIN 在多个亚马逊站点查询商品数据。

主要能力:返回价格、标题、主图、上架日期、材质、重量、尺寸、销售排名、当前及最多 12 个月月销量、30/90/180 天平均排名、FBA 费用、评分、评论数、类目树等。响应不含商品描述与评论内容。

使用方式:单次请求最多 100 个 ASIN,用逗号分隔,asin 参数总长度不超过 3000 字符。domain 为数字站点 ID(1=美国,2=英国,3=德国,4=法国,5=日本,6=加拿大,8=意大利,9=西班牙,10=印度,11=墨西哥,12=巴西),未指定时默认 1。history 设为 1 时包含近 12 个月月销与平均排名等历史数据,设为 0(默认)只返回当前信息。示例:{"asin": "B0088PUEPK", "domain": "1"};{"asin": "B0088PUEPK", "domain": "1", "history": 1};{"asin": "B0088PUEPK,B00U26V4VQ,B07M68S376", "domain": "3", "history": 1}。工具调用 LinkFox 工具网关 API,可参考 references/api.md,或直接执行 scripts/keepa_product_detail.py。

展示规则:价格需带币种;历史数据可按表展示 12 个月销售趋势并描述增长、下降或稳定;尺寸毫米值可换算为更直观单位,重量单位为克;值为 0 或 -1 表示数据不可用,应标注 N/A 或省略;有 imageUrl 时展示商品图;批量结果先给汇总表。

限制:不返回商品描述与评论内容;单次最多 100 个 ASIN;asin 字符串上限 3000 字符;历史月销仅在 history=1 时返回;lastUpdate 表示数据刷新时间。不适用于搜索词与关键词分析、评论或文案、广告/PPC 数据、卖家账户或店铺级分析、无具体 ASIN 的商品调研、价格历史图表或 Buy Box 历史。

处理大响应:可将响应持久化到磁盘后按需读取字段,命令为 python scripts/response_io.py run --script scripts/keepa_product_detail.py --out-dir <DIR> '<params>' 与 python scripts/response_io.py read <file> --fields "<paths>"(或 --path "<JMESPath>")。输出目录应位于 git 工作树之外,响应可能含个人信息、价格或认证敏感数据,请勿提交,任务完成后清理。预览仅为截断的架构与示例,字段级判断需读取持久化文件。