用途:通过 Nexscope 查询并分析某个 Amazon ASIN 的流量关键词列表,用于了解该商品由哪些关键词带来流量。
主要能力:支持 ASIN 反向关键词查询;返回流量份额类型(trafficKeywordTypes,如 primary、precise、preciseLongTail)、转化类型(conversionKeywordTypes,如转化强、稳定、流失等)、关键词徽章(badges,如自然搜索词、Amazon Choice 推荐词)、自然排名与广告排名;支持按历史月份查询。
使用方式:API 端点为 POST /sellersprite/traffic/keyword,完整参数与错误码见 references/api.md。脚本调用:python scripts/amazon_traffic_keywords.py '<JSON params>' [--inline]。必填参数为 marketplace(默认 US)与 asin;可选 month(yyyyMM,默认近 30 天)、page(默认 1)、size(默认 50,最大 100)、keyword、badges、trafficKeywordTypes、conversionKeywordTypes、orderField(默认 rankPosition)、orderDesc(默认 false)。需设置 NEXSCOPE_API_KEY 环境变量;认证失败(401/402)或余额不足时,可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 获取 API Key 或充值。
输出策略:脚本默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-sellersprite-traffic-keyword-<timestamp>.json;响应体不超过 8 KB 时打印完整 JSON,超过 8 KB 时仅输出摘要;加 --inline 可强制完整输出。建议先看摘要,再用 jq 或 ConvertFrom-Json 按需提取字段。
限制:每次调用最多 100 条;历史查询需 yyyyMM 格式;同一参数组合默认每会话只调用一次,脚本有 24 小时本地缓存,失败或空结果时不要自动更换关键词、页码或邮编重试;每次调用消耗 15 积分,高频调用前应提醒用户积分成本。展示时优先显示关键词、自然排名、广告排名、流量份额类型与转化类型,并标明查询周期与分页信息。