用途:模拟真实用户在亚马逊前台搜索,返回实时搜索结果页(SERP)数据,用于查看某关键词下实际展示的商品列表及其位置、价格、评分等。与ABA数据不同,ABA是聚合的历史搜索词分析,本工具返回当前真实前台结果。
主要能力:返回商品位置、价格、评分、评论数、品牌、配送信息、赞助标记等;支持按关键词检索、指定站点、类目节点、语言、排序、页码、配送邮编模拟和设备类型。默认排序relevanceblender,另有价格升降序、平均评分、最新上架、畅销榜等排序。支持约20多个亚马逊站点,默认amazon.com。每页约20条结果。
使用方式:API端点POST /amazon/search;脚本命令python scripts/amazon_search.py '<JSON params>' [--inline]。关键词应使用目标站点语言。结果默认写入<当前目录>/nexscope/<日期>/<会话>/data/nexscope-amazon-search-<时间戳>.json;响应≤8KB打印完整JSON,>8KB仅打印摘要;加--inline强制完整输出。建议先看摘要,再用jq等提取字段。
限制:返回实时数据而非历史数据,历史搜索词分析请用ABA;工具消耗credits,同一会话加参数组合默认仅调用一次,脚本有24h本地缓存,失败或空结果时不要自动换关键词、页码或邮编重试,额外查询需先询问用户。需设置NEXSCOPE_API_KEY环境变量;401/402或余额不足时按提示充值。分页每页约20条。数据展示需清晰、标注赞助商品、使用正确货币符号,并说明位置反映实际搜索排名。