八爪鱼亚马逊商品采集器

解决的核心问题

• 亚马逊商品数据采集常面临几个工程痛点：

- 采集流程不可控：临时脚本往往缺乏可恢复性，遇到API限流或任务中断后难以续采，重新运行又易产生重复数据。
- 数据契约不一致：列表、详情、评论分阶段抓取时，字段格式常出现错位，后续分析前需花大量时间清洗。
- 配额与状态管理混乱：免费版/个人版套餐有每周2000条的额度上限，团队版则无此限制，但多数采集方案不会提前告知剩余额度，遇到额度报错时只能从头再来。

技能的核心工作方式

该技能以根编排器为核心，将请求拆分为可独立执行的阶段任务，每个阶段对应专门的内部 Skill：

• 意图路由：根据用户输入识别完整关键词采集、列表、ASIN详情、评论或已有结果导出等场景，按需加载对应subskills/目录下的SKILL.md，避免一次性加载所有内部 Skill。
• 严格契约校验：每次运行前自动读取contracts/mcp-routing.json、请求 schema 及当前模板的inputSchema与sourceTree，以模板字段为唯一标准。
• MCP调用约束：首次调用前必须显示套餐额度提示，调用前检查search_templates、execute_task等核心方法是否可用。若MCP未加载，引导用户启用bazhuayu-amazon-collector连接而非索取明文API Key。
• 阶段化执行与对账：完整关键词流程按list → details → reviews → export顺序执行，每个阶段仅创建一个模板任务，完成后通过contracts/stage-result.schema.json校验结果并更新run-state.json，再由根编排器决定下一阶段。最终需对账任务ID、批次号、CSV行数等指标后才交付文件。

适用边界与注意点

• 额度限制：免费版与个人版通过MCP调用每周最多2000条，遇到额度错误时会保留运行状态而非直接中断，建议检查套餐后稍后恢复。
• 配置前置条件：MCP连接是必要前提，需用户在WorkBuddy安全配置中填写API Key，技能不会在日志或产物中暴露密钥。
• 参数完整性：仅补问最少缺失参数，关键词流程需keyword、quantity、site，ASIN流程需asins、site。