用途:该技能用于获取 Walmart 商品搜索结果,通过 Frevana 接口返回商品标题、价格、评分、卖家、缩略图、Walmart 分类等信息。
主要能力:支持必填的 query(可用 --q 别名),以及可选的 device、cat_id、page、sort、facet、min_price、max_price。脚本会校验响应为 JSON,保存到本地文件,并将同一 JSON 原样输出到 stdout,不重写或重塑数据,除非用户明确要求转换。
使用方式:需在环境变量中提供 FREVANA_TOKEN,或通过 --token 临时覆盖;依赖 curl、bash、python3。基本命令为 bash <skill-path>/scripts/search_walmart.sh --query "coffee maker"。可加过滤、排序和分页参数,例如 --device mobile --sort price_low --min-price 25 --max-price 100 --page 2;也可用 --cat-id 指定分类,用 --output 指定保存路径。脚本优先读取 FREVANA_TOKEN,交互式 shell 下缺失时可能提示输入,非交互或智能体流程中缺失则快速失败。
适用场景:需要查询 Walmart 商品搜索结果、按价格或评分排序、按分类或价格区间筛选、分页浏览,并希望保留原始 JSON 供后续解析或摘要时使用。
限制:仅 query 为必填,不要自行编造 device、cat_id、page、sort、facet、min_price、max_price 的值。接口仅支持上述字段,不要传入 engine、api_key、output、no_cache、async、zero_trace、walmart_domain、soft_sort、store_id、spelling、nd_en、include_filters 等不支持的字段。page 须为 1 到 100 的整数;sort 仅接受 price_low、price_high、best_seller、best_match、rating_high、new;device 仅接受 desktop、mobile、tablet。不要为保存和摘要重复调用脚本,脚本始终保存并打印同一 JSON。不要向用户回显 Bearer token。若缺少 curl 或 python3,应停止并提示安装。默认保存路径为 ./out/walmart-search-<UTC 时间戳>-<pid>.json。