SuperAPI AI 工具集

ecommerce.amazon-related-asins

数据与分析

查看项目

更新于 10-20 00:12

技能介绍

用途

该技能面向亚马逊卖家,用于给定一个参考 ASIN,挖掘与其处于同一细分市场(niche)的竞争 ASIN,并基于多维度指标筛选和排序,辅助评估竞争格局与机会。目前仅支持美国(US)、日本(JP)、德国(DE)三个站点。

主要能力

  • 竞品发现:根据参考 ASIN 返回同细分市场的竞品列表,分页展示。
  • 指标维度:点击转化率、综合点击转化率、点击量(7 天/30 天/90 天)、销量、价格、FBA 费用、毛利率、评论数、客户评分、90 天趋势数据。
  • 过滤条件:价格与 FBA 费用区间、毛利率区间、评论数与评分类区间、7 天/30 天点击量与点击增长率区间、点击转化率与综合转化率区间、360 天销量区间、上架日期区间、所属细分市场数量、卖家国家(逗号分隔)等,均为可选的最小/最大范围。
  • 排序字段:360 天购买点击量(默认)、评论总数、价格、上架日期、30/90/7 天点击量、点击转化率、综合点击转化率、客户评分、周/月点击增长率、当前价格、FBA 佣金、FBA 运费、毛利率。

使用方式

  • API 端点:POST /jiimore/pageAsinsByAsin,完整参数、响应与错误码见 references/api.md。
  • Python 脚本:python scripts/amazon_related_asins.py '<JSON params>' [--inline]。
  • 必填参数为 asin;countryCode 默认 US,page 默认 1,pageSize 默认 50(范围 10-100),sortField 默认 purchasedClicksT360,sortType 默认 desc。
  • 比率类参数使用 0-1 小数表示 0%-100%(如 0.15 表示 15%);上架日期参数格式为 yyyyMMdd000000。
  • 鉴权:需设置环境变量 NEXSCOPE_API_KEY;若出现 401/402 或余额不足提示,可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 获取 API Key 或充值。

成本与输出策略

  • 该工具消耗 credits。同一会话内相同参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果不应自动更换关键词、分页或邮编重试;产生额外费用的查询前应先告知用户。
  • 默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-jiimore-page-asins-by-asin-<timestamp>.json;当前目录不可写时报错,不写入 /tmp。
  • 响应体 ≤ 8 KB 时保存后完整打印到 stdout;> 8 KB 时仅打印摘要(顶层字段、total/costToken 等计数、最大列表字段长度及前 3 个样本)。加 --inline 可强制完整输出(仍会保存到磁盘)。
  • 建议先看摘要判断是否够用,需要具体字段时再用 jq 或 ConvertFrom-Json 从保存的 JSON 中按需提取。

适用场景

  • 根据参考 ASIN 查找直接竞品或同细分市场相似产品。
  • 按转化率筛选高转化竞品。
  • 发现近期上架且点击增长较快的新进入者。
  • 按价格区间与毛利率筛选竞品。
  • 寻找高点击、低评论的潜在薄弱环节产品。
  • 按卖家国家(如 CN)筛选同细分市场中的中国卖家竞品。
  • 分站点(US/JP/DE)进行竞品分析。

限制

  • 仅支持 US、JP、DE 站点,其他站点代码会被拒绝。
  • 每次查询必须提供参考 ASIN,否则不返回结果。
  • 单页最多 100 条结果。
  • 比率类参数须用 0-1 范围,日期参数须用 yyyyMMdd000000 格式。
  • 不适用于关键词级细分市场分析(应使用 Nexscope Niche Info by Keyword)、单 ASIN 收入或利润估算、ABA 搜索词与关键词研究、广告活动管理与出价优化、评论分析或 listing 优化、供应商采购与物流规划;单 ASIN 详细商品数据应使用 Amazon Product Detail。
  • 展示时应将小数比率转为百分比,突出 ASIN、标题、价格、评分、综合点击转化率、点击量、评论总数与毛利率等关键指标;不主动添加主观业务建议,仅在用户明确要求时提供解读。