妙手ERP货源采集导入

解决的问题

跨平台采购时，货源链接来自 1688、AliExpress、淘宝、天猫、拼多多等不同站点。把商品导入妙手 ERP 公共采集箱时，常见的是复制粘贴容易出错、链接有效性难判断、采集后的商品 ID 与来源对应关系不清晰，导致后续查询、编辑或认领到 TikTok 时链路断裂。

核心能力

• 按用户提供的完整商品详情 URL 发起采集，写入妙手 ERP 公共采集箱。
• 支持批量提取和去重，保持原始顺序，避免重复提交。
• 调用 fetch_item API，请求字段为 collectLinks，返回 sourceItemIdAndDetailIdMap，明确哪个来源商品对应哪个采集箱 detailId。
• 使用 scripts/source_collect.py 完成 URL 解析、验证、签名和 API 提交；通过 --urls 传入链接，--json 输出机器可读结果。

标准工作流程

1. 从用户请求中提取 URL，去重并保持顺序。
2. 验证 URL 格式并识别来源域名，判断是否为商品详情页。
3. 展示链接数量和来源域名，请用户确认采集计划。
4. 确认后调用 API 或运行脚本，提交到公共采集箱。
5. 返回并展示 sourceItemIdAndDetailIdMap。
6. 询问用户是否需要继续查询、编辑或认领。

边界与注意点

• 本技能只负责采集到公共采集箱，不编辑商品内容，也不直接认领或发布。
• 仅接受完整商品详情 URL；搜索页、分类页、店铺页、短链接和含义不明的 URL 需先澄清。
• URL 验证会保留 spm 等跟踪参数，但拒绝明显非详情页；1688 场景下 offerId / offerid 均识别。
• 输入包含有效和无效混合链接时，默认不提交，需用户选择修复或跳过；只有明确选择跳过后才可加 --ignore-invalid。
• API 授权需要妙手 ERP 开放平台应用审核通过，凭证通过本地 resources/config.json、环境变量或主机连接器提供，不要在聊天中粘贴密钥或 Cookie。
• 每个 API 请求使用 POST，携带 x-app-key、x-timestamp、x-sign 签名头；签名内容包含路径、秒级时间戳和精确 JSON body，不要打印 AppSecret 或完整签名请求。