下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-ko8itrop--miaoshou-erp-shop-query.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @org-ko8itrop/miaoshou-erp-shop-query。从妙手 ERP开放平台查询已授权店铺列表，覆盖TikTok、Ozon、Temu 全托管、Temu 半托管、Shopee、MercadoLibre等跨境电商平台。当用户提到"店铺列表"、"授权店铺"、"查询店铺"、"我的店铺"、"shop list"、"shop ID"、"认领到哪个店铺"、"发布到哪个店铺"，或在认领、平台采集箱编辑、发布流程前需要确认 shopId/站点/平台授权状态时使用。
阅读全文 （展开查看完整说明）
概述
妙手 ERP 店铺查询
查询已授权店铺并返回下游 ERP 流程所需的标识符。
典型用户请求
- "帮我查一下 TikTok US 已授权店铺"
- "Ozon 有哪些可用店铺？"
- "查 Temu 半托管店铺 ID"
- "我有哪些 Shopee Global 店铺可以认领商品？"
- "查 Shopee MY 店铺，准备发布"
- "查美客多 / MercadoLibre 可用店铺"
- "发布前先帮我看一下可用店铺"
- "这个站点应该用哪个 shopId？"
适用范围
本技能为只读操作。用于查询店铺 ID、店铺名称、平台代码、站点代码、授权状态、过期时间以及 global/CB/CNSC 标识。
请勿使用本技能进行以下操作：
- 采集源链接。
- 编辑普通采集箱或平台采集箱商品。
- 认领商品。
- 发布商品。
- 修改店铺授权数据。
在认领、平台采集箱编辑或发布流程中，当店铺选择或店铺有效性不明确时，请先使用本技能。
安全规则
- 不要通过本技能执行写操作。
- 不要要求用户在聊天中粘贴
app_secret、cookies、token、密码或签名请求头。 - 仅从本地
resources/config.json、环境变量或安全的主机连接器加载凭证。 - 不要打印密钥或完整的签名请求头。
- 如果店铺已过期、已禁用、未授权或站点不匹配，在写操作流程中应将其标记为不可用。
- 如果平台或站点不明确，应进行简洁的澄清询问，除非用户明确要求查询所有店铺。
平台代码
请严格使用以下 API 平台代码：
| 平台 | 代码 | 常用站点 |
|---|---|---|
| TikTok Shop | tiktok | ID, VN, TH, MY, PH, BR, MX, ES, FR, GB, US, DE, IT, JP |
| TikTok Global | tiktokGlobal | TIKTOKGLOBAL, TIKTOKGLOBALUS, TIKTOKGLOBALEU |
| Ozon | ozon | OZON（精确查询选择器；请勿使用 RU） |
| Temu 全托管 | pddkj | PDDKJ |
| Temu 半托管 | pddkjChoice | PDDKJCHOICE |
| Shopee | shopee | ID, TW, VN, TH, MY, SG, PH, BR, MX, CL, CO, PL, ES, FR, AR |
| Shopee Global | shopeeGlobal | SHOPEEGLOBAL |
| MercadoLibre | mercadolibre | CBT, UP |
lazada、amazon、shein 等旧版平台代码可能存在于较早安装的技能或历史流程中，但不在当前源技能使用的店铺 API 参考文档中。使用旧版平台代码前请先确认。
请保留混合大小写代码，如 tiktokGlobal、pddkjChoice、shopeeGlobal。
API 授权
在调用妙手 ERP 开放平台 API 之前，请确保用户已授权通过审核的开放平台应用。
- 从本地
resources/config.json、环境变量MIAOSHOU_APP_KEY和MIAOSHOU_APP_SECRET，或安全的主机连接器加载凭证。 - 可选：设置
MIAOSHOU_BASE_URL；默认为https://openapi-erp.91miaoshou.com。 - 如果账号已启用 IP 白名单，请确认调用方主机 IP 已被允许。
- 发送带签名的
POST请求，包含Content-Type: application/json、x-app-key、x-timestamp和x-sign。
签名规则：
sign = HmacSHA256(appSecret, appSecret + path + timestamp + appKey + bodyJson + appSecret)使用精确的 API 路径，而非完整 URL。使用秒级 Unix 时间戳。使用请求体中发送的精确紧凑 JSON 字符串。切勿打印 AppSecret、签名请求头或含凭证的请求数据。
常见授权错误：
| 错误码 | 含义 | 处理方式 |
|---|---|---|
signMissing | 缺少签名请求头 | 检查请求构造 |
signExpired | 时间戳过期或时钟偏移 | 检查系统时间并重新生成 |
signInvalid | 签名/路径/请求体/密钥不匹配 | 检查签名输入项，但不要暴露密钥 |
appNotFound | App Key 无效或应用未通过审核 | 验证应用授权状态 |
appNoPermission | 应用缺少接口权限 | 请用户开启接口权限 |
ipNotInWhitelist | 调用方 IP 被拦截 | 将调用方 IP 添加至白名单 |
标准工作流程
- 解析用户请求的平台和站点。
- 每次 API 请求都必须提供
site参数。请勿使用空字符串作为"全部站点"的占位符。 - 如果用户要求查询所有店铺，需遍历文档中所有平台/站点组合，对每个组合进行分页查询，并汇总成功结果和失败信息。
- 如果特定查询中缺少平台或站点信息，应进行简洁的澄清询问，但对于 Ozon（
site=OZON）等只有一个固定选择器的平台除外。 - 调用
/open/v1/product/shop/shop/get_shop_list。 - 优先展示可用店铺，不可用店铺单独列出。
- 说明下一步需要哪个标识符：
- 平台编辑和发布流程通常使用
shopId。 - 认领流程使用平台代码和普通采集箱详情 ID；不要暗示用户必须提供
serialNumber。
- 平台编辑和发布流程通常使用
- 如果结果集较大，按平台/站点分组并显示页码/每页条数上下文。
- 在原始输出中保留标准化的
CB、CNSC和shopType字段，以便 Shopee 发布流程区分本地店铺和全球子店铺。 - 报告每一个失败的平台/站点/页码查询。切勿将部分广度查询结果作为完整结果呈现。
返回标准
对于每个店铺，应包含以下字段：
| 字段 | 重要性说明 |
|---|---|
shopId | 平台编辑/发布流程的主要店铺标识符 |
shopNick 或店铺名称 | 供用户确认的可读名称 |
platform | 防止跨平台操作错误 |
site / siteName | 防止错误国家或错误模式操作 |
status | 表示店铺是否可用 |
gmtExpire | 帮助识别授权风险 |
gmtLastAuth | 帮助排查授权过期问题 |
parentShopId | 适用于全球店铺或父子店铺结构 |
isCb / isCnsc | 帮助区分跨境/全球店铺模式 |
CB / CNSC / shopType | 标准化的下游路由字段；CB=Y 且 CNSC=Y 表示 Shopee 全球子店铺流程 |
如果连接器返回了 serialNumber 等额外字段，仅当下游 API 明确需要时才展示。不要要求普通用户提供 serialNumber 用于公共采集箱认领。
场景处理
| 场景 | 预期行为 |
|---|---|
| 用户问"有哪些店铺"但未指定平台 | 询问是查询所有常用平台还是特定平台 |
| 用户查询 TikTok US 店铺 | 查询 platform=tiktok, site=US |
| 用户查询 TikTok Global 店铺 | 查询 platform=tiktokGlobal 及对应的全球站点 |
| 用户查询 Temu 店铺 | 询问是全托管 pddkj 还是半托管 pddkjChoice |
| 用户查询 Ozon 店铺 | 查询 platform=ozon, site=OZON。将 OZON 作为精确 API 选择器，即使用户说的是俄罗斯/RU；切勿向此接口发送 site=RU |
| 用户查询 Shopee 本地店铺 | 查询 platform=shopee 及请求的站点，如 MY、TW 或 ID |
| 用户查询 Shopee Global 店铺 | 查询 platform=shopeeGlobal, site=SHOPEEGLOBAL；检查 parentShopId、isCb 和 isCnsc 以支持下游全球流程 |
| 用户准备发布 | 返回 shopId 并提醒发布操作需要在发布技能中单独确认 |
| 用户准备认领 | 返回平台/站点/店铺上下文；将实际认领操作路由到 miaoshou-erp-product-claim |
| 店铺已过期或已禁用 | 不要将其作为目标推荐；明确报告问题 |
| 未找到店铺 | 报告已查询的平台/站点，并建议检查 ERP 授权 |
命令行工具
python {base_dir}/scripts/shop_list.py list --platform tiktok --site US --page 1 --size 100
python {base_dir}/scripts/shop_list.py list --platform ozon --site OZON
python {base_dir}/scripts/shop_list.py list --platform pddkjChoice --site PDDKJCHOICE
python {base_dir}/scripts/shop_list.py list --platform shopee --site MX --page 1 --size 50
python {base_dir}/scripts/shop_list.py list --platform shopeeGlobal --site SHOPEEGLOBAL --page 1 --size 50
python {base_dir}/scripts/shop_list.py list-platform-all --platform tiktok
python {base_dir}/scripts/shop_list.py list-all如果脚本不可用，可通过主机 HTTP 客户端或连接器直接调用接口。当需要精确的请求/响应字段时，请加载 references/api_reference.md。
错误处理
signMissing：检查签名请求头。signExpired：检查系统时间或时间戳秒数。signInvalid：验证签名路径/请求体/配置；不要暴露密钥。appNotFound：验证 App Key 和应用审核状态。appNoPermission：请用户开启店铺列表接口权限。ipNotInWhitelist：调用方 IP 不在账号白名单中。- 空响应：报告可能的服务、网络或白名单问题。
- 空店铺列表：报告已查询的平台/站点，并建议在 ERP 中检查店铺授权。
list-all部分结果：返回成功的店铺以及失败的平台/站点/页码组合。- 分页重复：停止该站点扫描并报告
repeatedPage，而不是无限循环。
关联技能
| 步骤 | 技能 |
|---|---|
| 采集源链接到普通采集箱 | miaoshou-erp-source-import |
| 编辑普通采集箱 | miaoshou-erp-common-collectbox-manage |
| 认领到平台采集箱 | miaoshou-erp-product-claim |
| 编辑 TikTok 采集箱 | miaoshou-erp-tiktok-product-edit |
| 发布 TikTok 商品 | miaoshou-erp-tiktok-product-publish |
| 编辑 Ozon 采集箱 | miaoshou-erp-ozon-product-edit |
| 发布 Ozon 商品 | miaoshou-erp-ozon-product-publish |
| 推荐 Temu 全托管类目 | miaoshou-erp-temu-full-category-recommend |
| 管理 Temu 全托管尺码表 | miaoshou-erp-temu-full-size-chart-manage |
| 规划 Temu 全托管车型适配 | miaoshou-erp-temu-full-vehicle-fitment-manage |
| 管理 Temu 全托管店铺模型 | miaoshou-erp-temu-full-model-manage |
| 编辑 Temu 全托管采集箱 | miaoshou-erp-temu-full-product-edit |
| 发布 Temu 全托管商品 | miaoshou-erp-temu-full-product-publish |
| 推荐 Shopee 类目 | miaoshou-erp-shopee-category-recommend |
| 管理 Shopee 尺码表 | miaoshou-erp-shopee-size-chart-manage |
| 编辑 Shopee 采集箱 | miaoshou-erp-shopee-collectbox-product-edit |
| 管理 Shopee Global 在线商品 | miaoshou-erp-shopee-global-product-manage |
| 发布 Shopee 商品 | miaoshou-erp-shopee-product-publish |
| 推荐 MercadoLibre 类目 | miaoshou-erp-mercadolibre-category-recommend |
| 规划 MercadoLibre 尺码表 | miaoshou-erp-mercadolibre-size-chart-manage |
| 编辑 MercadoLibre 采集箱 | miaoshou-erp-mercadolibre-product-edit |
| 发布 MercadoLibre 商品 | miaoshou-erp-mercadolibre-product-publish |
| 其他平台后续操作 | 使用对应的平台专属编辑/类目/发布技能（如可用） |
配置
使用 resources/config.json.example 作为本地配置模板。请勿分发真实的 resources/config.json。
脚本使用说明
- 脚本名称：
shop_list.py。 - 使用
list子命令；请勿直接将--platform传递给脚本根命令。 - 当已知平台但未知站点时，使用
list-platform-all --platform tiktok；该命令仅扫描指定平台。 - 仅当用户要求进行广度跨平台查询时，才使用
list-all。 list命令需要--site参数；空站点不等于查询全部站点。list-all会扫描所有文档中的站点，自动分页，并在原始输出中返回{shops, failures}。- 对于大量结果，使用
--page和--size进行分页。 - 在最终 API 调用中保留混合大小写的平台代码。
