Agent Skills
返回列表
妙手ERP Shopee产品发布

妙手ERP Shopee产品发布

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-ko8itrop/miaoshou-erp-shopee-product-publish。

技能介绍

这个技能解决什么问题

Shopee 的商品上架并不只是把一条记录推过去。编辑完成的产品在真正发布时,仍然可能遇到店铺类型不匹配、发布路由不清楚、必填字段不全、任务提交成功但平台并未上架等风险。这类问题一旦在多店铺环境中发生,排查成本会迅速上升。

妙手ERP-Shopee产品发布 负责处理的是 Shopee 发布环节本身:它不参与产品内容的重新编辑,而是在产品数据已编辑并预览审批通过后,检查发布前置条件、构建发布计划,并按普通采集箱发布或 Shopee 全球发布的不同链路提交任务。

核心能力

  • 发布就绪检查:在提交前核验 detailIds、shopIds、shopeeGlobalItemIds等关键参数,以及类目、标题、图片、重量、描述、品牌、物流、预售设置、价格、库存等详情字段是否完整。
  • 发布计划构建:展示目标产品与发布店铺,并明确发布类型及风险提示。
  • 两种发布路径:普通店铺可使用 publish-collectbox 提交采集箱任务;Shopee 全球发布则使用 shopeeGlobalItemIds、shopIds 以及可选的 isUseShopeeGlobalSetting。
  • CB/CNSC 路由处理:CB/CNSC 子店铺不是直接本地发布,而是先发布至全球母店铺,再通过 publish-global 将全球商品发布到子店铺。
  • 阻断式执行:就绪检查失败时,技能停止执行,并将缺失信息路由回产品编辑、类目、尺码表、SKU 或内容处理环节。
  • 任务状态区分:普通发布返回的是 result/code,全球发布返回的是 moveCollectTaskDetailIds,二者都只是任务提交或任务 ID,不能直接理解为最终上架成功。

标准工作流程

  1. 通过 miaoshou-erp-shop-query 查询目标店铺元数据,判断它是普通店铺还是 CB/CNSC 子店铺:

- CB=N、CNSC=N → 普通店铺。
- CB=Y、CNSC=Y → CB/CNSC 子店铺,需要接入全球母店铺链路。

  1. 普通店铺执行 publish-collectbox,将采集箱 detailIds 发布到本地店铺 ID。
  2. CB/CNSC 子店铺先执行 publish-collectbox,此时 shopIds 必须设置为全球母店铺 ID。
  3. 再通过 miaoshou-erp-shopee-global-product-manage 确认商品已在全球母店铺上线,并获取 globalItemId。
  4. 最后使用 shopeeGlobalItemIds=[globalItemId] 和 shopIds=[子店铺ID] 执行 publish-global。

适用边界与注意点

这个技能只负责发布执行,不做产品编辑,不自动补全缺失字段,也不认领通用采集箱产品。编辑问题应交由 miaoshou-erp-shopee-collectbox-product-edit 等技能处理;店铺查询也只能通过 miaoshou-erp-shop-query 完成。

三个容易踩坑的地方需要特别留意:

  • 仅任务提交成功,不等于上架成功。普通发布响应只返回 result/code,全球发布响应只返回 moveCollectTaskDetailIds。在后续通过在线商品查询确认之前,不能声称最终上架状态。
  • shopId 只在发布时生效。在 save_site_detail_data 中设置 shopId,并不会把商品绑定到该店铺。
  • API 认证方式固定。妙手 JCOP 请求使用 HMAC-SHA256 签名,凭据从 resources/config.json 或 MIAOSHOU_APP_KEY、MIAOSHOU_APP_SECRET 获取,不使用 Bearer token。

脚本默认会先预览签名请求体;只有在凭据已配置、预览审批通过、用户已确认后才应添加 --execute --confirm 执行。一次完整的发布请求,其生命周期为:就绪检查 → 发布计划 → 用户确认 → 签名请求 → 任务响应 → 任务状态报告。

使用场景

  • 采集箱产品编辑与预览已通过,需要按店铺类型提交普通发布任务并核对参数与阻断字段。
  • 在CB/CNSC子店铺上架前,需要先发布到全球母店铺,再拿globalItemId执行全球发布。
  • 店铺既有普通店又有子店铺时,需要分别确认母店与子店关系,避免把shopId当作绑定依据。
  • 发布后只有任务ID或result/code时,需要继续查询线上商品状态,不能直接宣称上架成功。

适合人员

  • 需要把已审批商品提交到Shopee店铺的运营工程师,关注发布类型与店铺路由是否正确。
  • 需要排查发布失败并回填类目、尺码表或认证字段的数据工程师,关注阻断项与上游技能边界。
  • 需要确认任务提交不等于最终上架的电商系统维护者,关注任务状态与线上确认流程。
  • 需要组织发布审批与执行分离的团队负责人,关注预览、确认令牌与签名配置。