技能介绍

要解决什么问题

在妙手 ERP 的采集、认领、编辑、发布链路里，很多操作都需要一个明确的 shopId 作为店铺标识符。但实际工作中，店铺的授权状态、过期时间、站点归属往往并不直观：你以为 TikTok US 店铺还可用，实际授权早已过期；你按 RU 查询 Ozon，接口却不接受这个选择器。等到写操作失败时再回头排查，成本更高。这个技能把「查询已授权店铺并拿到可用标识符」变成一个只读、可重复的小步骤，在执行真正的写操作之前先把店铺选对。

核心能力与工作流程

技能调用妙手 ERP 开放平台的 /open/v1/product/shop/shop/get_shop_list 接口，返回字段覆盖下游流程常用的标识：shopId、shopNick、platform、site、status、gmtExpire、gmtLastAuth、parentShopId、isCb、isCnsc，以及标准化的 CB、CNSC、shopType 字段——例如 Shopee 发布流程需要通过 CB=Y 且 CNSC=Y 来判断全球子店铺。

工作流程大致是：

解析用户请求的平台和站点，每次 API 请求都必须携带 site 参数，不能用空字符串当「全部站点」
对 TikTok、Shopee、Ozon、Temu、MercadoLibre 使用规范中的平台代码，注意保留 tiktokGlobal、pddkjChoice、shopeeGlobal 这类混合大小写写法
请求通过 x-app-key、x-timestamp、x-sign 签名头鉴权，凭证只能从本地配置、环境变量或安全的主机连接器加载
返回结果优先展示可用店铺，过期、禁用、未授权的店铺单独列出，避免被误选为操作目标
对「查询所有店铺」这类广度请求，会遍历全部平台/站点组合并分页汇总，同时报告每一个失败的组合

适用边界

这个技能是纯只读的，不能用来采集源链接、编辑采集箱、认领商品、发布商品或修改店铺授权数据，认领、编辑、发布需要配合对应的关联技能完成。另外需要注意：Ozon 的站点选择器是精确的 OZON，即使用户说的是俄罗斯也不要传 RU；Temu 则要先区分全托管 pddkj 和半托管 pddkjChoice 两种模式。遇到 signInvalid、ipNotInWhitelist 这类错误时，按文档逐项排查即可。