Amazon Product Search Api Skill — Amazon 产品搜索 API 技能

Amazon 产品搜索自动化技能 介绍 本技能通过 BrowserAct 的 Amazon 产品搜索 API 模板提供一站式产品数据收集服务。它直接从 Amazon 搜索列表中提取结构化的产品结果。只需输入搜索关键词、品牌过滤器和数量限制，即可获取干净、可用的产品数据。

特点 无幻觉：预设工作流避免 AI 生成的幻觉，确保稳定和精确的数据提取。 无验证码问题：无需处理 reCAPTCHA 或其他验证挑战。 无 IP 限制：无需处理区域 IP 限制或地理围栏。 更快的执行：任务执行速度比纯 AI 驱动的浏览器自动化解决方案更快。 成本有效：显著降低数据采集成本，相比之下高令牌消耗的 AI 解决方案。

API Key 设置 在运行之前，检查 BROWSERACT_API_KEY 环境变量。如果未设置，请不要采取其他措施；请询问并等待用户提供。代理必须通知用户：“由于您尚未配置 BrowserAct API Key，请访问 BrowserAct 控制台获取您的 Key。”

输入参数 调用脚本时，代理应根据用户需求灵活地配置以下参数： 关键词（搜索关键词） 类型：字符串 描述：用户想要在 Amazon 上搜索的关键词。 示例：手机、无线耳机、笔记本支架 品牌（品牌过滤器） 类型：字符串 描述：根据列表中的品牌名称过滤产品。 示例：苹果、三星、索尼 最大日期（最大产品数量） 类型：数字 描述：在分页搜索结果中提取的最大产品数量。 默认值：50 语言（UI 语言） 类型：字符串 描述：Amazon 浏览会话的 UI 语言。 选项：en、de、fr、it、es、ja、zh-CN、zh-TW 默认值：en

使用 代理应执行以下独立脚本以实现“一行命令结果”： 示例调用 python -u ./scripts/amazon_product_search_api.py “关键词” “品牌” 数量 “语言”

执行监控 由于此任务涉及自动浏览器操作，因此可能需要一些时间（几分钟）。脚本将持续输出带有时间戳的状态日志（例如 [14:30:05] 任务状态：运行）。代理指令：在等待脚本结果时，请继续监控终端输出。只要终端输出新的状态日志，任务就运行正常；请不要将其误认为是死锁或无响应。只有当状态长时间未改变或脚本停止输出而没有返回结果时，才应考虑触发重试机制。

数据输出 执行成功后，脚本将直接从 API 响应中解析和打印结果。结果包括： product_title：产品名称 product_url：详细页 URL rating_score：平均星级评分 review_count：总评论数 monthly_sales：估计月销售量（如果可用） current_price：当前售价 list_price：原始列表价格（如果可用） delivery_info：交货或履行信息 shipping_location：发货起源或位置 is_best_seller：是否标记为畅销品 is_available：是否可购买

错误处理和重试 如果在脚本执行期间发生错误（例如，网络波动或任务失败），代理应遵循以下逻辑： 检查输出内容：如果输出包含“Invalid authorization”，则意味着 API Key 无效或已过期。请不要重试；请指导用户重新检查并提供正确的 API Key。如果输出不包含“Invalid authorization”但任务失败（例如，输出以 Error: 开头或返回空结果），则代理应自动尝试重新执行脚本一次。重试限制：自动重试仅限一次。如果第二次尝试失败，请停止重试并将特定的错误信息报告给用户。

典型用例 市场研究：搜索“无线耳机”以分析当前市场。 竞争监控：跟踪“三星”手机的价格和可用性。 目录发现：为新产品目录收集产品标题和 URL。 本地化分析：搜索 Amazon 的“ja”（日语）以了解日本地区的产品。 畅销品跟踪：识别特定品牌的畅销品。 价格情报：比较当前价格和列表价格以监控折扣。 销售趋势估计：使用月销售量数据来估计市场需求。 交货效率研究：分析交货信息和发货起源。 大规模数据提取：收集最多 100 个产品以获取综合数据集。 产品可用性检查：验证特定品牌产品是否当前可购买。