SuperAPI AI 工具集

ecommerce.amazon-market-product-detail

办公与效率

查看项目

更新于 10-16 06:50

技能介绍

用途:按 ASIN 通过 Nexscope 查询亚马逊商品详情与历史趋势,帮助卖家分析商品表现、定价策略与竞争定位。趋势数据可回溯至 2021 年。注意其与商品搜索技能的区别:本技能返回单个商品的趋势/时间序列数据;若需按品类、品牌或卖家搜索筛选商品,应使用 Nexscope 商品搜索技能。

主要能力:覆盖基础信息(标题、品牌、ASIN、Listing URL、图片、店铺名、卖点、徽章、停售状态、重量尺寸等)、变体(父 ASIN、变体数量、子 ASIN、变体属性)、价格与利润(售价、优惠券、平台费、FBA 费用明细、FBM 运费、利润额与利润率)、销量(官方月度销量)、排名(BSR、类目树、子类目排名、上架日期、在线天数)、评分(评分、评论数、星级分布)、卖家(Buybox 卖家信息、FBA 状态、卖家数量)、Listing 特征、促销,以及时间序列趋势(BSR、子 BSR、日/月销量、日/月营收、价格、标价、Deal 状态)。

支持站点:US、GB、DE、FR、IN、CA、JP、ES、IT、MX、AE、AU、BR、SA,默认 us;注意使用小写站点代码,英国编码为 gb。

使用方式:API 为 POST /sorftime/amazon/productDetail;脚本命令 python scripts/amazon_market_product_detail.py '<JSON params>' [--inline]。关键参数为 asin 与 marketplace(均必填);默认含近 15 天趋势,仅需基础信息可设 includeTrend: 2 以省成本;指定历史区间用 queryTrendStartDate / queryTrendEndDate(yyyy-MM-dd),费用翻倍;最多一次查询 10 个 ASIN,逗号分隔。需设置 NEXSCOPE_API_KEY 环境变量。脚本默认把完整响应写入工作目录下的日期/会话目录,响应小于等于 8 KB 时打印完整 JSON,超过则打印摘要,--inline 可强制完整输出。该工具消耗积分,同一会话与参数组合默认只调用一次并本地缓存 24 小时;失败或空结果时不要自动更换关键词、分页或邮编重试,需先告知用户额外消耗。

读取提示:建议先看摘要,再用 jq 或 ConvertFrom-Json 按需从保存的 json 提取字段。趋势数组为交错格式:偶数索引是日期,奇数索引是值;销量/营收中 -1 表示无法估算;价格单位为当地货币最小单位(美元为分),-1 表示当日无价格;Deal 趋势 1 表示当日有活动;BSR 趋势按子类目以 [{NodeId, Rank:[日期, 排名, ...]}] 形式给出。展示时建议用清晰表格,说明排名数值越低越好、价格需换算单位、-1 应解释为无法估算而非直接显示,停售时明确告知,失败时依据 msg 说明原因并建议调整条件。

限制:单次最多 10 个 ASIN;查询超过 15 天趋势费用翻倍;结果不支持通过 _dataQuery_executeDynamicQuery 做二次分析;非标准类目(如 Amazon Renewed)销量字段可能返回 -1。不适用于跨品类/品牌搜索筛选、ABA 搜索词排名、广告/PPC 策略、评论内容分析与专利商标检索。