用途:该技能用于通过 Frevana 检索 Google Shopping 商品列表,返回商品标题、价格、评分、来源商家等本地化结果。
主要能力:接收查询词 q(必填),可选 google_domain、gl、hl、start、device、sort_by。脚本会校验响应为 JSON,将其保存到本地文件,并把同一 JSON 原样输出到 stdout,不重写或重塑数据,除非用户明确要求转换。
使用方式:需在环境变量中提供 FREVANA_TOKEN,或本次运行用 --token 覆盖;依赖 curl、bash、python3。优先使用脚本而非临时 curl 命令。基本用法:bash <skill-path>/scripts/search_google_shopping.sh --q "wireless earbuds"。--query 是 --q 的别名。可加 --google-domain google.com --gl US --hl en;分页、设备与排序:--start 20 --device mobile --sort-by 1;指定输出文件:--output ./out/google-shopping-search-result.json。默认文件路径为 ./out/google-shopping-search-<UTC 时间戳>-<pid>.json。
限制:仅 q 必填,用户未提供时不要自行编造 google_domain、gl、hl、start、device、sort_by。--device 仅支持 desktop、mobile、tablet;--sort-by 1 为价格从低到高,2 为价格从高到低。非交互或智能体流程中若缺少 token 应快速失败并提示设置 FREVANA_TOKEN 或传 --token。缺少 curl 或 python3 时应停止并提示安装。不要回显 Bearer token。不要为保存和汇总而重复调用脚本,应使用已保存的 JSON 做后续解析或摘要。失败时脚本打印响应体或解析错误并以非零退出。