用途:根据用户提供的 Amazon ASIN 查询单个商品的详情、属性及配送相关信息,数据经 Frevana 获取。
主要能力:输入 asin(必填),可选 amazon_domain、gl、hl、customer_zipcode、force_refresh。脚本会校验响应为 JSON 并原样返回,不重写或重塑数据,除非用户明确要求转换。
使用方式:优先使用脚本而非临时 curl 命令。基本查询:bash <skill-path>/scripts/fetch_product.sh --asin B0BDJ49KVD。配送感知查询可加 --customer-zipcode 10001。完整请求可加 --amazon-domain amazon.com --gl US --hl en --customer-zipcode 10001 --force-refresh false --output ./out/amazon-product-result.json。也可用 --token 覆盖当前运行的令牌。
依赖与令牌:需要环境变量 FREVANA_TOKEN,或显式 --token;需要 curl、bash、python3。交互式 shell 中若缺少令牌,脚本可能提示输入;非交互或智能体流程中应快速失败并提示用户设置 FREVANA_TOKEN 或传 --token。
默认值:amazon_domain 为 amazon.com,gl 为 US,hl 为 en,force_refresh 为 false。
输出:成功时脚本校验响应体为 JSON 并打印到 stdout;使用 --output 时同时写入指定文件。失败时打印响应体或解析错误并以非零状态退出。
限制与注意:必须提供 --asin,若用户只给商品名或 Amazon 链接,应向其索取 ASIN。涉及配送可用性或本地化报价时使用 --customer-zipcode。缺少 curl 或 python3 时应停止并提示安装。不要向用户回显 Bearer 令牌。除非用户要求完整载荷,否则应汇总其关心的关键字段而非直接输出原始 JSON。