1688上货助手

1688 多商品上架的自动化痛点

对于在 1688 平台上运营的商家，尤其是需要从供应商处铺货的店铺，手动将大量商品链接逐一上架到自己的店铺是一个耗时且容易出错的过程。这涉及多次复制粘贴、检查链接有效性、配置重复的发货地址和运费模板等。1688上货助手旨在解决这一具体问题：通过自动化工具批量识别商品链接，并调用平台接口完成从链接验证到商品信息填写的上架流程。

技能如何工作：从链接到上架

该技能以对话式交互为核心，通过一系列后台 MCP 工具调用实现自动化。其工作流程清晰，主要分为以下几个关键步骤：

智能授权与账号管理

技能运行的首要前提是获得授权。它采用 sToken 进行鉴权，并遵循严格的安全流程：

• Token 格式校验：必须符合正则规则 ^st[a-zA-Z0-9]{32}$，确保凭证有效性。
• 持久化存储：授权成功后，将 sToken 与关联的用户名安全存储在本地的 sTokens.json 文件中。
• 多账号切换：支持管理多个 1688 账号。执行上货前，用户可通过关键词 查看登录账号 或在选择步骤中，明确指定本次操作使用哪个账号。所有操作均通过 --account 参数明确指向目标账号。

商品链接识别与验证

用户只需粘贴一个或多个商品链接，技能将自动：

1. 提取 URL：使用正则匹配所有以 http:// 或 https:// 开头的链接。
2. 调用识别接口：通过 url_identify MCP 工具批量验证链接。
3. 结果分流：将链接分为「正确链接」和「错误链接」列表展示。只有存在至少一个正确链接时，才会继续后续流程。

可定制的上货模板配置

在提交任务前，技能会拉取当前账号的上货模板（get_copy_rule_config），并清晰展示 5 项核心设置：

• 产品类型：现货品 (copyWay=0) 或工厂品 (copyWay=1)
• 上架设置：销售中、草稿箱或待上架
• 发货地址：从账户地址库中选择
• 运费设置：支持指导模板、普通模板、运费说明或卖家承担
• 价格类型：原价或促销价，并可设置乘法计算规则

任何一项设置为空，都会引导用户逐项填写。配置完成后会保存为模板，下次可复用。这个过程确保了商品上架信息的准确性和一致性。

批量执行与状态反馈

确认模板后，技能调用 copy_by_agent 接口提交批量上货任务。它会将第二步中识别出的成功链接信息（包括 productId、offerSource 等）构建成请求参数。任务提交成功后，会尝试获取上货记录链接并提供给用户，方便在 1688 后台跟踪进度。

适用边界与注意事项

• 强依赖环境：技能运行必须能访问指定的 MCP 服务端点，并正确配置 sTokens.json 中的授权凭证。网络问题或凭证失效将导致流程中断。
• 链接类型限制：仅支持识别标准的 HTTP/HTTPS 链接。非标准格式或包含复杂参数的链接可能无法被正确提取。
• 平台限制：该工具专为 1688 平台设计，其接口调用和业务逻辑均基于该平台的规则，不适用于其他电商平台。
• 操作风险：一键上货会直接影响店铺商品，请在确认模板设置无误且链接内容正确后再执行。建议先在测试环境下熟悉流程。