用途:该技能用于在亚马逊上进行基于图片的视觉商品搜索。用户提供一张可公开访问的商品图片 URL,即可检索外观相似的在售商品,便于竞品分析、寻找替代货源、识别仿品和发现市场机会。
支持站点:amazon.com(美国,默认)、amazon.co.uk(英国)、amazon.de(德国)、amazon.fr(法国)、amazon.it(意大利)、amazon.es(西班牙)、amazon.co.jp(日本)、amazon.in(印度)。未指定时默认美国站。
主要参数:imageUrl(必填,可公开访问的图片 URL)、amazonDomain(必填,默认 amazon.com)、sort(可选排序)、deliveryZip(可选配送邮编)、countryOrAreaCode(可选跨境配送国家/地区码,不能与 deliveryZip 同用,印度站不支持跨境配送)、aggregateByKeepaData(可选,启用后返回 Keepa 补充数据)。
排序取值:default、price-asc-rank、price-desc-rank、rating-asc-rank、rating-desc-rank、ratings-asc-rank、ratings-desc-rank。若用户要求的排序不在上述列表内,应告知可用选项,不得用其他工具或变通方式替代。
用法:API 端点 POST /amazon/searchByImage;脚本方式:python scripts/amazon_search_by_image.py '<JSON parameters>'。脚本默认将完整 JSON 响应打印到标准输出,可用 jq 或 ConvertFrom-Json 提取字段。
返回与展示:结果包含 ASIN、标题、图片、价格、评分、评论数、品牌,启用 Keepa 后还包括销售排名、月销量、FBA 费用、尺寸等。展示时应以表格呈现,优先图片、标题、ASIN、价格、评分、评论数、品牌;价格需带币种(如 $29.99 USD);有 imageUrl 时内联显示以便视觉比对;告知结果总数;查询失败时提示检查图片 URL 是否有效且可公开访问。
限制:不支持文本关键词搜索、ABA 搜索词分析、评论分析或 listing 优化、无图销量估算、图片编辑或生成。结果不存入数据库,无法进行二次 SQL 处理。需设置 NEXSCOPE_API_KEY 管理额度。如需了解更多参数、响应和错误码,请参考 references/api.md(具体内容暂未提供)。