Amazon产品图片采集 Skill

1. 适用范围

本 skill 适合以下任务：

• 电商选品：批量下载 Amazon 搜索结果中的产品主图进行视觉分析。
• 竞品监控：按品牌/品类关键词采集竞品产品图片。
• 数据集构建：为机器学习/图像分类任务收集电商产品图片。
• 市场调研：快速获取某品类的产品图片样本。

不要用本 skill 处理其他电商平台的图片下载。如果用户需求落在上述范围外，直接向用户说明本 skill 不覆盖该场景。

2. 核心工作机制 (BrowserWorker Plugin)

• 插件浏览器操控：本技能通过项目内置 BrowserWorker 插件 daemon 执行浏览器动作，不直接依赖用户机器上的 Chrome、ChromeDriver、Playwright、Selenium、requests 等环境。
• 跨平台端口发现：run.py 会优先读取 BrowserWorker_PORT / MANAI_BROWSER_CONTROL_PORT，其次读取工作区 storage/browser_daemon.lock，最后使用默认端口 12321；daemon 未响应时会尝试从项目内 BrowserWorker 目录自动启动。
• Action 执行方式：通过 BrowserWorker /execute 调用本技能的 scripts/actions/collect_images.py，action 使用 browser.goto、browser.evaluate、browser.scroll、browser.wait_ms 和 browser.request_help 完成页面交互。
• 页面状态检测：action 使用 BrowserWorker 框架级 detect_page_state(domain_hint=...) 判断 login/captcha/region_prompt/blocked/empty_result 等通用状态，不维护商品页专用检测逻辑。
• 人工协助：遇到 Amazon 登录、验证码、地区确认等必须人工处理的页面时，action 会调用 request_help(validate_after=True)，用户继续后由框架二次校验页面状态。

3. 调用参数格式

动作：collect_images (批量下载亚马逊产品图)

• Action: "collect_images"
• Args:
  • keywords: 搜索关键词，多个关键词用换行 \n 分隔（string，必填）
  • image_save_path: 图片存放的本地文件夹路径（string，必填）
  • max_images_per_keyword: 每个关键词最多下载图片数（integer，可选；默认 0 表示不限制，测试时建议传较小值）

调用示例：

{
  "action": "collect_images",
  "action_search_path": "<skill_path>/scripts/actions",
  "args": {
    "keywords": "iphone case\nusb cable",
    "image_save_path": "C:\\Users\\Desktop\\amazon_images",
    "max_images_per_keyword": 20
  }
}

---

4. 不可违反的原则

1. 先确认，后执行：收集完需求后，必须用自然语言复述已识别的筛选和下载条件并等待用户确认；用户确认前不要执行。
2. 严格的参数校验：LLM 在执行 collect_images 之前，必须先对传入参数进行合法性检查，不满足时反馈错误并不执行。
3. 合规低频执行：如果页面跳转或出现验证码/登录过期，通过插件浏览器的人工协助窗口提示用户处理。

5. 标准工作流

Step 1：收集需求

问清这些信息（用户没有要求的使用默认值，不要强行追问）：

• keywords：搜索关键词（必填，多个用 \n 分隔）
• image_save_path：本地图片存放路径（必填）

Step 2：复述并确认

复述用户启用的业务条件，不暴露内部字段名。待用户确认后再继续。

Step 3：执行下载

调用 BrowserWorker 插件接口，传入 action: "collect_images"、action_search_path 及相应参数执行；或直接通过本目录 run.py collect_images 间接调用。

• 登录与异常状态判定：如果接口提示需要登录或验证码，直接让用户在插件浏览器中完成，不要求用户安装或打开本机 Chrome。

Step 4：汇报结果

向用户汇报每个关键词的下载数量与详细统计信息。

---

6. 参数校验规则

参数	必填	类型	校验规则	不满足时的反馈话术
keywords	✅	string	不能为空字符串	"参数 keywords 为必填项，请提供搜索关键词。"
image_save_path	✅	string	不能为空字符串	"参数 image_save_path 为必填项，请提供图片存放路径。"
max_images_per_keyword	❌	integer	非负整数；测试或演示时建议不超过 3	"参数 max_images_per_keyword 必须是非负整数。"