本技能用于通过 Nexscope 产品请求 API 按 ASIN 获取亚马逊商品的列表数据,面向亚马逊卖家和分析人员。
主要能力 给定一个或多个 ASIN 及目标站点,可返回商品的综合信息,包括价格(含本地货币)、标题、Item Highlights(itemHighlights,可用时)、主图、上架日期、材质、重量、尺寸、销售排名、当前月度销量、FBA 费用、评分、评论数、类目树等。当 history 设为 1 时,还包含最长 12 个月的月度销量历史,以及 30/90/180 天平均销售排名;设为 0 时仅返回当前商品信息。
使用方式 调用参数中 domain 为必填的数字站点 ID(如 1 表示 Amazon.com 美国站,2 英国,3 德国,4 法国,5 日本,6 加拿大,8 意大利,9 西班牙,10 印度,11 墨西哥,12 巴西;用户未指定时默认 1);asin 为必填,多个 ASIN 用逗号分隔,单次最多 5 个且字符串总长不超过 300 字符;history 可选,默认 0。API 端点为 POST /keepa/productRequest,也可使用 Python 脚本 scripts/amazon_product_history.py '<JSON params>' [--inline]。需设置 NEXSCOPE_API_KEY 环境变量;若出现 401/402 或余额不足,可通过官方帮助页获取 API Key 或充值。
输出与数据读取 脚本默认将完整响应写入工作目录下 nexsco pe/<日期>/<会话>/data/ 的 JSON 文件(会话取自 SESSION_ID 环境变量),响应体不超过 8 KB 时打印完整 JSON,超过时仅打印摘要;加 --inline 可强制完整输出。建议先看摘要,再用 jq 或 ConvertFrom-Json 按需从本地文件提取字段。同一会话中相同参数组合默认只调用一次,并有 24 小时本地缓存;失败或空结果不应自动更换关键词、分页或邮编重试,产生额外费用的查询应先告知用户。
展示建议 用结构化表格分组展示相关字段(尺寸一组、销售数据一组);价格始终附货币;有历史数据时用表格或趋势描述展示 12 个月销量走势;重量单位为克,尺寸为毫米,可适当换算为更直观单位;值为 0 或 -1 表示数据不可用,应标注 N/A 或省略;有 imageUrl 时展示商品图;itemHighlights 应与标题分开显示,缺失或为空时标注不可用,不得从标题、卖点或描述重建。
适用场景 适用于单 ASIN 查询、批量 ASIN 对比、价格与月度销量查询、销售趋势分析、类目与物理规格查询、FBA 费用查询、上架日期与配送方式核对等。
限制 不返回完整商品描述或评论内容;itemHighlights 并非每个 ASIN 都有;单次最多 5 个 ASIN;历史数据需显式开启;lastUpdate 字段表示数据最后刷新时间。不适用于关键词分析、生成 listing 文案、广告/PPC 数据、卖家账户或店铺级分析、无具体 ASIN 的商品调研,以及价格历史或 Buy Box 历史曲线(仅提供当前与平均排名数据)。