amazon-asin-lookup-api-skill

Amazon ASIN 查询技能

📖 简介

此技能使用 BrowserAct 的 Amazon ASIN 查询 API 模板，帮助你轻松从 Amazon 获取全面的商品信息。只需提供 ASIN，即可将包括标题、价格、评分、品牌和详细描述在内的结构化数据直接提取到你的应用中，无需手动抓取。

✨ 功能

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

🔑 API Key 设置

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

"由于你尚未配置 BrowserAct API Key，请访问 BrowserAct Console 获取 Key。"

🛠️ 输入参数

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

1. ASIN（Amazon 标准识别号）
   • 类型：string
   • 说明：Amazon 商品的唯一标识符。
   • 必填：是
   • 示例：B07TS6R1SF

🚀 用法

Agent 应执行以下脚本，通过一条命令获取结果：

# Example Usage
python -u ./scripts/amazon_asin_lookup_api.py "ASIN_VALUE"

⏳ 执行监控

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

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

📊 数据输出

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

• product_title：商品的完整标题。
• ASIN：提供的 ASIN。
• product_url：Amazon 商品页面的 URL。
• brand：品牌名称。
• price_current_amount：当前价格。
• price_original_amount：原价（如适用）。
• price_discount_amount：折扣金额（如适用）。
• rating_average：平均星级评分。
• rating_count：评分总数。
• featured：徽章，例如“Amazon's Choice”。
• color：颜色款式（如适用）。
• compatible_devices：兼容设备列表（如适用）。
• product_description：商品完整描述。
• special_features：突出特点。
• style：风格属性（如适用）。
• material：所用材料（如适用）。

⚠️ 错误处理与重试

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

1. 检查输出内容：

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

2. 重试次数限制：

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

🌟 典型用例

1. 商品数据补充：检索一组 ASIN 的完整详情，用于更新电商数据库。
2. 价格比较：查询指定 ASIN 对应的亚马逊当前价格，并与其他零售商进行比较。
3. 评论监控：跟踪重点商品的平均评分和评论数量变化。
4. 库存检查：自动验证亚马逊上指定商品当前是否有货。
5. 品牌分析：识别 ASIN 对应商品的品牌和制造商。
6. 详细规格：获取材质、款式和颜色信息，用于目录管理。
7. 功能亮点提取：提取“特色功能”和详细描述，用于营销文案。
8. 兼容性验证：检查电子产品或配件的“兼容设备”。
9. 市场调研：分析指定商品 ID 对应的“亚马逊之选”等特色徽章。
10. URL 解析：将一组 ASIN 转换为完整的亚马逊商品页面 URL。