amazon-product-api-skill

Amazon 商品搜索技能

📖 简介

此技能使用 BrowserAct 的 Amazon 商品 API 模板，从 Amazon 搜索结果中提取结构化商品列表。它提供标题、ASIN、价格、评分和商品规格等详细信息，让您无需手动收集数据，即可高效开展市场研究和商品监控。

✨ 功能

1. 杜绝幻觉：预设工作流可避免 AI 生成式幻觉，确保数据提取稳定、精准。
2. 无需处理验证码问题：无需处理 reCAPTCHA 或其他验证挑战。
3. 无 IP 限制：无需处理地区 IP 限制或地理围栏。
4. 执行更快：与纯 AI 驱动的浏览器自动化方案相比，任务执行速度更快。
5. 经济高效：与消耗大量 Token 的 AI 方案相比，可显著降低数据获取成本。

🔑 API 密钥设置

运行前，请检查 BROWSERACT_API_KEY 环境变量。如果未设置，不要采取其他措施；应询问用户并等待其提供。 Agent 必须告知用户：

"由于您尚未配置 BrowserAct API Key，请访问 BrowserAct 控制台 获取您的 Key。"

🛠️ 输入参数

Agent 应根据用户需求配置以下参数：

1. KeyWords

   • 类型：string
   • 说明：用于在 Amazon 上搜索商品的关键词。
   • 必填：是
   • 示例：laptop、wireless earbuds

2. Brand

   • 类型：string
   • 说明：按品牌名称筛选商品。
   • 默认值：Apple
   • 示例：Dell、Samsung

3. Maximum_number_of_page_turns

   • 类型：number
   • 说明：要翻阅的搜索结果页数。
   • 默认值：1

4. language

   • 类型：string
   • 说明：Amazon 浏览会话的界面语言。
   • 默认值：en
   • 示例：zh-CN、de

🚀 用法

Agent 应使用以下独立脚本实现“一行命令获取结果”：

# Example Usage
python -u ./scripts/amazon_product_api.py "keywords" "brand" pages "language"

⏳ 执行监控

由于此任务涉及自动化浏览器操作，可能需要一些时间（几分钟）。脚本会持续输出带时间戳的状态日志（例如：[14:30:05] Task Status: running）。 Agent 操作说明：

• 等待脚本结果时，请持续监控终端输出。
• 只要终端持续输出新的状态日志，任务就运行正常；不要误以为任务陷入死锁或无响应。
• 只有在状态长时间没有变化，或脚本停止输出且未返回结果时，才应考虑触发重试机制。

📊 数据输出

成功后，脚本会解析并打印 API 响应中的结构化商品数据，包括：

• product_title：商品完整标题。
• asin：Amazon 标准识别号。
• product_url：Amazon 商品页面的 URL。
• brand：品牌名称。
• price_current_amount：当前价格。
• price_original_amount：原价（如适用）。
• rating_average：平均星级评分。
• rating_count：评分总数。
• featured：“Best Seller”或“Amazon's Choice”等徽章。
• color、material、style：商品属性（如有）。

⚠️ 错误处理与重试

如果脚本执行期间发生错误（例如网络波动或任务失败），Agent 应遵循以下逻辑：

1. 检查输出内容：

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

2. 重试次数限制：

   • 自动重试仅限一次。如果第二次尝试失败，请停止重试，并向用户报告具体错误信息。

🌟 典型用例

1. 市场调研：搜索特定产品类别，分析热门品牌和定价。
2. 竞品监控：跟踪特定竞争品牌的商品列表和价格变化。
3. 产品目录补充：提取 ASIN 和规格等结构化详情，以创建或更新产品数据库。
4. 评分分析：查找特定关键词下的高评分商品，以识别市场领先者。
5. 本地化调研：以不同语言搜索 Amazon，分析国际市场。
6. 价格跟踪：监控当前价格和原价，以识别折扣趋势。
7. 品牌表现：评估特定品牌在多个页面的搜索结果中的曝光情况。
8. 属性提取：收集一系列商品的材质或颜色等技术规格。
9. 潜在客户开发：识别热门商品及其制造商，以开展业务拓展。
10. 自动化数据馈送：定期将 Amazon 搜索结果导入外部 BI 工具或仪表板。