用途:基于 SellerSprite 市场研究数据,按类目/节点筛选和排序亚马逊细分市场,用于市场调研与选品参考。
主要能力:按类目节点路径或类目关键词定位市场;评估市场规模(月均销量、月均销售额、商品数等);分析竞争结构(商品/品牌/卖家集中度、亚马逊自营占比、FBA/FBM 占比、A+ 内容占比);查看新品机会(新品数量、新品占比、新品均价/评分/销量);支持排序与分页,每页最多 200 条。
使用方式:API 端点 POST /sellersprite/market/research;脚本命令 python scripts/amazon_market_research.py '<JSON params>' [--inline]。必填参数 marketplace(默认 US),可选参数包括 month、nodeIdPath、departmentKeyword、page/size、orderField/orderDesc 及各类 min/max 数值阈值。集中度等比例类输入须用 0~1 小数(如 0.4 表示 40%),不要传整数 40。需设置环境变量 NEXSCOPE_API_KEY。
输出策略:脚本默认将完整响应写入 <cwd>/nexscope/<日期>/<会话>/data/ 下的 JSON 文件;响应 ≤8KB 时打印完整 JSON,>8KB 时仅打印摘要;加 --inline 可强制完整输出。建议先看摘要,需要具体字段时用 jq 或 ConvertFrom-Json 从保存文件按需提取。
限制:调用消耗积分,同一会话同一参数组合默认只调用一次,脚本有 24 小时本地缓存;失败或结果为空时不要自动换关键词、翻页或换邮编重试,继续搜索前须先告知用户会产生额外消耗。历史月份范围受第三方限制(通常近 24 个月)。数值比例字段若响应中带 (%) 标记,其量纲可能与输入不同,以响应值为准。商品数、评分、毛利率等字段单位详见 references/api.md。具体收费价格、完整参数与错误码请查阅 references/api.md,资料未完整提供。