SuperAPI AI 工具集

home-depot-search

通用与其它

查看项目

更新于 10-16 08:46

技能介绍

用途:该技能用于获取 Home Depot 商品搜索结果,通过 Frevana 接口查询商品列表信息。

主要能力:输入关键词 q(必填),可选 country、store、delivery_zip、page、page_size。返回经过 JSON 校验的响应,包含商品结果、筛选、分类、搜索信息与分页等字段。每次成功运行都会把同一份 JSON 保存到本地文件,并原样输出到标准输出,除非用户明确要求转换,否则不应改写返回数据。默认文件路径为 ./out/home-depot-search-<UTC 时间戳>-<进程号>.json,也可用 --output 指定路径。

使用方式:脚本依赖 bash、curl、python3,并需要环境变量 FREVANA_TOKEN,或在本次运行时用 --token 显式覆盖。基本命令为 bash <skill-path>/scripts/search_home_depot.sh --q "patio chairs";--query 是 --q 的别名。可附加参数示例:--country us --store 121 --delivery-zip 10001;分页示例:--page 2 --page-size 40。请求体只包含 q、country、store、delivery_zip、page、page_size,未提供的可选字段会被省略,不应自行编造这些值,也不要传入不支持的字段。

限制:country 仅在用户指定时使用,取值为 us 或 ca;store 仅在用户指定时使用;delivery_zip 仅在用户指定时使用;page 必须为大于等于 1 的整数;page-size 必须为 1 到 40 的整数,Home Depot 返回的商品数量可能与请求数量不同。交互式场景下若缺少 FREVANA_TOKEN 脚本可能提示输入,非交互或智能体流程中应快速失败并提示用户设置令牌。缺少 curl 或 python3 时应停止并提示安装。不应把 Bearer 令牌回显给用户。不要为保存和汇总而重复调用脚本,应复用已保存的 JSON 文件进行后续解析或摘要。