Amazon 商品搜索自动化技能

📖 简介

该技能通过 BrowserAct 的 Amazon 商品搜索 API 模板，提供一站式商品数据采集服务。它直接从 Amazon 搜索结果列表中提取结构化商品信息。只需输入搜索关键词、品牌筛选条件及数量限制，即可获得干净、可直接使用的商品数据。

✨ 特性

1. 无幻觉输出：预设工作流规避 AI 生成式幻觉，确保数据提取稳定且精准。
2. 无需处理验证码：无需应对 reCAPTCHA 或其他验证挑战。
3. 无 IP 地域限制：无需处理区域 IP 限制或地理围栏（geofencing）问题。
4. 执行更快：相比纯 AI 驱动的浏览器自动化方案，任务执行速度显著提升。
5. 成本更低：相比高 Token 消耗的 AI 方案，大幅降低数据获取成本。

🔑 API 密钥配置

运行前，请检查环境变量 BROWSERACT_API_KEY 是否已设置。若未设置，请勿采取其他措施；应主动向用户询问并等待其提供密钥。
Agent 必须明确告知用户：

“由于您尚未配置 BrowserAct API Key，请前往 BrowserAct 控制台获取您的 Key。”

🛠️ 输入参数

调用脚本时，Agent 应根据用户需求灵活配置以下参数：

1. KeyWords（搜索关键词）

   • 类型：string
   • 说明：用户希望在 Amazon 上搜索的关键词。
   • 示例：phone、wireless earbuds、laptop stand

2. Brand（品牌筛选）

   • 类型：string
   • 说明：按商品列表中显示的品牌名称进行筛选。
   • 示例：Apple、Samsung、Sony

3. Maximum_date（最大商品数）

   • 类型：number
   • 说明：在分页搜索结果中最多提取的商品数量。
   • 默认值：50

4. language（界面语言）

   • 类型：string
   • 说明：Amazon 浏览会话所使用的 UI 显示语言。
   • 可选值：en、de、fr、it、es、ja、zh-CN、zh-TW
   • 默认值：en

🚀 使用方式

Agent 应执行以下独立脚本，以实现“一行命令即得结果”：

# 示例调用
python -u ./scripts/amazon_product_search_api.py "Keywords" "Brand" Quantity "language"

⏳ 执行过程监控

由于该任务涉及自动化浏览器操作，执行耗时可能较长（数分钟）。脚本将持续输出带时间戳的状态日志（例如：[14:30:05] Task Status: running）。
Agent 操作指引：

• 等待脚本结果期间，请持续关注终端输出内容。
• 只要终端仍在输出新的状态日志，即表明任务正常运行；请勿误判为死锁或无响应。
• 仅当状态长时间未更新，或脚本停止输出且未返回任何结果时，才应考虑触发重试机制。

📊 数据输出

成功执行后，脚本将解析并直接打印 API 响应中的结果。输出字段包括：

• product_title：商品标题
• product_url：商品详情页 URL
• rating_score：平均星级评分
• review_count：总评论数
• monthly_sales：月销量估算值（如可获取）
• current_price：当前售价
• list_price：原始标价（如可获取）
• delivery_info：配送或履约信息
• shipping_location：发货地或物流来源地
• is_best_seller：是否标记为 Best Seller
• is_available：是否可购买

⚠️ 错误处理与重试机制

若脚本执行过程中发生错误（例如网络波动或任务失败），Agent 应遵循以下逻辑处理：

1. 检查输出内容：

   • 若输出包含"Invalid authorization"，表示 API Key 无效或已过期。不得重试，需引导用户重新核对并提供正确的 API Key。
   • 若输出不包含"Invalid authorization"，但任务仍失败（例如输出以 Error: 开头，或返回空结果），Agent 应自动重试执行一次脚本。

2. 重试次数限制：

   • 自动重试仅限一次。若第二次执行仍失败，则停止重试，并将具体错误信息反馈给用户。

🌟 典型应用场景

1. 市场调研：搜索 Sony 品牌的 “wireless earbuds”，分析当前市场格局。
2. 竞品监控：追踪 Samsung 手机在 Amazon 上的价格与库存状态。
3. 目录发现：在 “laptop stand” 类目下批量采集商品标题与 URL，用于构建新品目录。
4. 本地化分析：使用 ja（日语）语言搜索 Amazon，了解日本地区可售商品情况。
5. Best Seller 追踪：识别特定品牌下被标记为 “Best Seller” 的商品。
6. 价格情报：对比 current_price 与 list_price，监测折扣动态。
7. 销量趋势估算：利用 monthly_sales 数据评估某类商品的市场需求。
8. 物流效率研究：分析不同品牌的 delivery_info 与 shipping_location 字段。
9. 大规模数据抽取：一次性采集最多 100 款商品，构建完整数据集。
10. 商品可售性核查：确认指定品牌商品当前是否处于 is_available 可购状态。