amazon-search

Amazon Search

通过 Frevana 搜索 Amazon 商品列表。

用途

此技能用于查找 Amazon 搜索结果。

输入：

• query 或 node 之一
• 可选的 amazon_domain
• 可选的 language
• 可选的 delivery_zip
• 可选的 shipping_location
• 可选的 sort_by
• 可选的 rh
• 可选的 device
• 可选的 no_cache
• 可选的 async
• 可选的 zero_trace
• 可选的 page
• 可选的 output；默认为 ./out/amazon-search-<timestamp>-<pid>.json

输出：

• 经过验证的 Amazon 搜索结果 JSON 响应

此技能会验证响应是否为 JSON，并原样返回。除非用户明确要求转换，否则不要重写或调整返回的数据。

此技能所需内容

• query 或 node 之一
• 可选的 amazon_domain
• 可选的 language
• 可选的 delivery_zip
• 可选的 shipping_location
• 可选的 sort_by
• 可选的 rh
• 可选的 device
• 可选的 no_cache
• 可选的 async
• 可选的 zero_trace
• 可选的 page
• 环境变量中的 FREVANA_TOKEN，或为当前运行显式指定 --token 覆盖值
• curl
• bash
• python3

执行顺序

按此流程操作，让请求保持简单可靠：

1. 确认用户恰好提供了 query 或 node 其中之一。
2. 优先使用脚本，而非临时编写的 curl 命令。
3. 让脚本先读取 FREVANA_TOKEN。
4. 在交互式 shell 中，如果缺少 FREVANA_TOKEN，脚本可以提示输入。
5. 在非交互式或 Agent 工作流中，如果缺少令牌，应立即失败，并告知用户设置 FREVANA_TOKEN 或显式传入 --token。
6. 默认将经过验证的响应 JSON 保存到 ./out/amazon-search-<timestamp>-<pid>.json，也可以保存到用户通过 --output 提供的路径。
7. 返回经过验证的响应 JSON；如果用户不需要完整内容，则总结最相关的商品列表。

命令

基本搜索

bash <skill-path>/scripts/search_amazon.sh \
  --query "wireless mouse"

搜索并指定页码和配送邮编

bash <skill-path>/scripts/search_amazon.sh \
  --query "wireless mouse" \
  --delivery-zip 10001 \
  --page 2

按类别节点搜索

bash <skill-path>/scripts/search_amazon.sh \
  --node 283155 \
  --amazon-domain amazon.com \
  --language en_US

搜索并指定排序、设备和配送地点

bash <skill-path>/scripts/search_amazon.sh \
  --query "wireless mouse" \
  --shipping-location "Seattle,Washington,United States" \
  --sort-by price-asc-rank \
  --device mobile

将响应 JSON 保存到文件

bash <skill-path>/scripts/search_amazon.sh \
  --query "wireless mouse" \
  --delivery-zip 10001 \
  --page 1 \
  --output ./out/amazon-search-result.json

为当前运行覆盖令牌

bash <skill-path>/scripts/search_amazon.sh \
  --query "wireless mouse" \
  --token "your bearer token"

请求映射

脚本会按如下方式将 CLI 选项映射到请求正文：

{
  "query": "wireless mouse",
  "amazon_domain": "amazon.com",
  "language": "en_US",
  "delivery_zip": "10001",
  "shipping_location": "Seattle,Washington,United States",
  "sort_by": "price-asc-rank",
  "rh": "n:283155,p_76:1249146011",
  "device": "mobile",
  "no_cache": true,
  "async": false,
  "zero_trace": false,
  "page": 1
}

规则：

• 恰好提供 query 或 node 其中之一
• 未提供时，page 默认为 1
• delivery_zip 可以与 shipping_location 一起使用；端点会优先采用 delivery_zip
• 脚本仅将本地的 --output 用作保存路径，不会发送请求字段 output

响应结构

API 返回 JSON。此技能会验证响应是否为 JSON，并原样返回。

输出

• 成功：脚本会验证响应正文是否为 JSON，并将其打印到 stdout
• 默认情况下，同一份 JSON 会保存到 ./out/amazon-search-<timestamp>-<pid>.json
• 使用 --output 时，同一份 JSON 会写入指定的文件路径
• 失败：脚本会打印响应正文或解析错误，并以非零状态退出

备注

• 必须且只能指定 --query 或 --node 中的一项
• 不要同时传入 --query 和 --node
• 用户需要针对特定市场的 Amazon 域名时，使用 --amazon-domain
• 端点需要覆盖 Amazon 语言设置时，使用 --language
• 当前 amazon_domain 和 language 枚举快照请参阅 references/enums.md
• 用户要求查看更多结果或获取超出第一页的更多选项时，使用 --page
• 本地化优惠的可用性或配送信息很重要时，使用 --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
• 如果缺少 curl，请停止并告知用户安装 curl
• 如果缺少 python3，请停止并告知用户安装 python3
• 不要向用户回显 Bearer 令牌
• 总结用户实际关心的商品列表，不要直接倾倒原始 JSON，除非用户要求完整负载

示例提示词

中文

• “搜索 Amazon 上的 wireless mouse”
• “帮我查一下 wireless mouse，第 2 页，ZIP 是 10001”
• “按类目节点 283155 查 Amazon 搜索结果”
• “查 wireless mouse，按价格从低到高，移动端结果”
• “查 Amazon 搜索结果并把原始 JSON 保存到文件里”

English

• “Search Amazon for wireless mouse”
• “Show me page 2 of Amazon search results for wireless mouse with ZIP 10001”
• “Search Amazon category node 283155”
• “Search Amazon for wireless mouse on mobile sorted by price low to high”
• “Search Amazon for this keyword and save the raw JSON to a file”