SuperAPI AI 工具集

ecommerce-amazon-keyword-summary

营销与增长

查看项目

更新于 10-16 06:50

技能介绍

用途:按指定关键词查询亚马逊商品流量来源结构,回答“谁在该关键词下瓜分流量、通过哪些渠道”。

主要能力:返回某关键词下出现的 ASIN 列表及其关键词级流量曝光拆分与商品级跨渠道流量组合。覆盖渠道包括自然搜索、SP 商品广告、SB 品牌广告、SBV 视频广告、SP 推荐位(Trending now/Seen on social media/Customers frequently viewed/4 stars and above)、Amazon's Choice、编辑推荐 ER、Top Rated TR。注意区分字段族:无前缀字段(如 naturalSearchExposureScore)为商品跨全部关键词总曝光,keyword 前缀字段(如 keywordNaturalExposureScore)为仅该关键词曝光,二者不可混用。

用法:接口为 POST /sif/keywordSummary,脚本调用为 python scripts/amazon_keyword_summary.py '<JSON params>' [--inline]。必填参数 searchKeyword(建议用目标站点语言,上限1000字符);可选 country(默认 US)、asins、condition、last7d(默认 true)、startDate/endDate、sortBy、pageNum、pageSize(10–100)、desc。支持13个站点 US/UK/DE/CA/JP/FR/ES/IT/MX/AU/AE/BR/SA。condition 每次仅能填一个值(如 nfPosition、isSpAd、acAd、isBrandAd、isPPCAd、isSearchRecommend 或 totalPeriod.in 等计数类)。脚本默认将完整响应写入工作目录 nexscope/<日期>/<session>/data/ 下并加24小时本地缓存;小于等于8KB打印完整 JSON,超过则打印摘要,可用 --inline 强制全量输出。

适用场景:关键词流量来源拆分、自然/付费占比分析、SP 广告竞争、推荐位与 AC/ER/TR 分析、竞品关键词流量对比、自定义时间窗口分析、单 ASIN 流量构成总结。

限制:每次仅支持一个 condition 筛选;仅覆盖上述13个站点(IN/NL/SE/PL/TR/SG 已不可用);每页最多100条;该端点不返回整 ASIN 元数据、跨渠道关键词计数或变体聚合;历史排名趋势、广告竞价优化、评论/listing、销量估算等不在范围内。工具消耗额度,同一会话与参数默认只调用一次,失败或空结果不应自动换词重试,需先告知用户额外消耗。需设置 NEXSCOPE_API_KEY 环境变量,缺失或过期可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值。