妙手ERP-TikTok类目推荐

概述

妙手ERP TikTok类目匹配

推荐 TikTok Shop 类目和属性值。此技能必须独立完成类目推荐任务：收集或请求所需的产品上下文，在凭证可用时查询类目数据，在缺少 API 访问权限时回退到用户提供的产品/类目信息，并返回可供审核或传递给其他工作流的结构化推荐结果。

典型用户请求

• "帮这个 TikTok 商品匹配类目"
• "商品 12345 应该放哪个 TikTok 类目？"
• "给我推荐类目和必填属性"
• "这个标题适合哪个 TK 类目？"
• "帮我看这个商品还缺哪些类目属性"
• "推荐结果确认后帮我写回采集箱"

适用范围

此技能用于：

• 收集缺失的产品、站点、店铺和授权信息。
• 按站点查询 TikTok 类目树。
• 筛选可能的叶子类目候选。
• 查询类目元数据。
• 推荐必填和选填属性。
• 在编辑或发布前解释缺失的信息。
• 即使写回或发布技能未安装，也能输出独立的最终推荐结果。

不要从此技能直接保存产品数据。如果用户需要应用推荐结果且写回技能或连接器可用，则传递已确认的类目和属性数据。如果该技能或连接器不可用，请明确告知用户缺失了什么能力，并仍提供精确的类目/属性结果供用户复制到下一步使用。

安全规则

• 类目和属性输出在用户确认前仅作为推荐结果。
• 不得编造受监管的值、产品认证信息、制造商数据、仓库或欧盟责任人信息。
• 必填属性和选填属性必须分开列示。
• 若缺少站点或店铺 ID，向用户询问或使用店铺列表指引。
• 若缺少妙手开放平台凭证，请要求用户提供或配置，而非直接声明技能不可用。
• 优先推荐叶子类目。若不确定，提供多个候选项并说明理由。
• 不得打印密钥或签名请求头。

输入

产品上下文可来自以下任一来源：

若仅有标题，在需要时请要求用户提供产品描述或关键属性。

API 鉴权

调用妙手ERP开放平台 API 前，请确保客户已授权通过审核的开放平台应用。凭证缺失是可恢复的输入缺口，不是放弃任务的理由。

1. 请客户登录妙手ERP，打开「开放平台」，创建应用，提交审核，审核通过后方可使用。
2. 获取应用凭证：AppKey 和 AppSecret。优先使用本地配置、环境变量或安全主机连接器。若无安全渠道且用户选择在对话中提供凭证，仅请求最少必要的值，不要回显 AppSecret，不要将其包含在最终回复、日志或示例中。
3. 通过以下方式之一配置凭证：
   • 将 resources/config.json.example 复制为 resources/config.json 并填写 app_key 和 app_secret。
   • 或设置环境变量 MIAOSHOU_APP_KEY 和 MIAOSHOU_APP_SECRET。可选：设置 MIAOSHOU_BASE_URL，否则使用 https://openapi-erp.91miaoshou.com。
4. 若客户已开启账号级 IP 白名单，确认运行此技能的机器或主机在该白名单中。白名单由同一妙手账号下所有应用共享。
5. 每个 API 请求必须为 POST 方法，包含 Content-Type: application/json 和签名请求头：x-app-key、x-timestamp、x-sign。

开放平台快速入门中的签名规则：

base_url = https://openapi-erp.91miaoshou.com
sign = HmacSHA256(appSecret, appSecret + path + timestamp + appKey + bodyJson + appSecret)

重要细节：

• path 仅为 API 路径，例如 /open/v1/order/create。签名内容中不要包含域名或查询字符串。
• timestamp 为秒级 Unix 时间戳。请求在 300 秒时钟偏移后过期。
• bodyJson 必须是 POST 请求体中实际发送的 JSON 字符串；仅在无请求体时使用空字符串。
• x-sign 为小写十六进制 HmacSHA256 输出。
• 切勿在最终回复或日志中打印 AppSecret、签名请求头或包含凭证的完整请求。

若鉴权失败，请明确处理以下快速入门错误码：signMissing 表示缺少请求头，signExpired 表示本地时钟或秒级时间戳问题，signInvalid 表示签名/请求体/路径/密钥不匹配，appNotFound 表示 App Key 错误、被禁用或未通过审核，appNoPermission 表示应用缺少接口权限，ipNotInWhitelist 表示调用方 IP 不被允许。

缺失能力处理

当所需能力不可用时，继续提供最佳闭环响应：

标准工作流

1. 收集产品标题、描述、图片/关键词（如有）、站点和店铺 ID。
2. 检查凭证/API 访问是否可用。若不可用，请求缺失的凭证或请用户提供类目/元数据输入。
3. 若提供了 detailId 且 API 可用，优先查询采集箱明细。若无，请用户提供标题、描述、图片/关键词和已知属性。
4. 条件允许时查询该站点的类目树。
5. 使用产品信息筛选最佳叶子类目候选。
6. 条件允许时查询每个候选类目的元数据。
7. 推荐必填属性值和有用的选填值。
8. 标记不确定的值、缺失的用户数据和 API/元数据缺口。
9. 呈现可供编辑前审核的最终推荐结果。

推荐输出

对于每个候选类目，包含：

• 排名。
• 类目路径。
• cid。
• 匹配理由。
• 置信度。
• 必填属性及建议值。
• 值得填写的选填属性。
• 缺失或不确定的值。
• 是否可直接应用。

场景处理

CLI 命令行工具

若内置脚本可用：

python {base_dir}/scripts/tiktok_category_match.py match --detail-id 12345 --mode site --site US --shop-ids 1001
python {base_dir}/scripts/tiktok_category_match.py match --title "women dress" --description "summer floral dress" --site US --shop-ids 1001
python {base_dir}/scripts/tiktok_category_match.py tree --site US
python {base_dir}/scripts/tiktok_category_match.py attributes --site US --cid 12345 --shop-ids 1001

若脚本不可用，通过主机 HTTP 客户端或连接器调用类目树和元数据接口。

业务说明

• 类目选择应优先使用最具体的有效叶子类目。
• 当产品信息不充分时，属性建议应保持保守。
• 不得编造品牌、认证、材质、产地或合规值。
• 若元数据标明某字段为必填，即使无法推荐值也应明确提示。

相关技能

以下技能为可选的后续能力，非类目推荐的前提条件。若某技能缺失，请说明并保持推荐结果可用。

配置

使用 resources/config.json.example 作为本地配置模板。不要分发真实的 resources/config.json。

脚本使用说明

LLM 常见错误：

正确示例：

python {base_dir}/scripts/tiktok_category_match.py match --detail-id 3134788019 --site MX --shop-ids 13302632 --mode site
python {base_dir}/scripts/tiktok_category_match.py match --title "产品标题" --site US --shop-ids 1001,1002