SuperAPI AI 工具集

amazon-search

通用与其它

查看项目

更新于 10-15 21:42

技能介绍

用途:该技能用于获取 Amazon 商品搜索结果,适合关键词搜索、商品发现、翻页查看后续结果以及需要考虑配送信息的搜索场景。

主要能力:支持以 query 或 node 之一作为检索条件;可选参数包括 amazon_domain、language、delivery_zip、shipping_location、sort_by、rh、device、no_cache、async、zero_trace、page 和 output。返回经过 JSON 校验的 Amazon 搜索结果,默认保存到 ./out/amazon-search-<timestamp>-<pid>.json。

使用方式:需在环境变量中提供 FREVANA_TOKEN,或通过 --token 显式传入;依赖 curl、bash、python3。优先使用脚本而非临时 curl 命令。基本用法:bash <skill-path>/scripts/search_amazon.sh --query "wireless mouse";带页码与配送邮编:加 --delivery-zip 10001 --page 2;按类目节点:--node 283155 --amazon-domain amazon.com --language en_US;排序与设备:--sort-by price-asc-rank --device mobile;指定输出文件:--output ./out/amazon-search-result.json。

规则与限制:query 与 node 必须且只能提供一个;page 未提供时默认为 1;delivery_zip 与 shipping_location 同时使用时优先 delivery_zip;sort_by 仅支持 review-rank、price-asc-rank、price-desc-rank、date-desc-rank、relevanceblender;device 仅支持 desktop、mobile;no_cache、async、zero_trace 仅接受 true 或 false。脚本不会把本地 --output 作为请求字段发送。缺少 curl 或 python3 时应停止并提示安装。不要回显 Bearer token。除非用户要求完整数据,否则建议汇总相关商品而非直接输出原始 JSON。amazon_domain 与 language 的枚举值可参考 references/enums.md。