@scorehub/creator-outreach 1.0.14 → 1.0.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/.codebuddy-plugin/plugin.json +15 -16
  2. package/README.en.md +3 -3
  3. package/README.md +3 -3
  4. package/agents/tiktok-creator-outreach.md +49 -2
  5. package/avatars/scorehub-ai.png +0 -0
  6. package/package.json +1 -1
  7. package/skills/tiktok-batch-outreach/SKILL.md +2 -9
  8. package/skills/tiktok-creator-analysis/SKILL.md +2 -13
  9. package/skills/tiktok-creator-search/SKILL.md +2 -13
package/.codebuddy-plugin/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "tiktok-creator-outreach",
3
- "version": "1.0.0",
4
- "description": "TikTok Shop creator outreach specialist — search marketplace creators, analyze performance, and batch send collaboration messages.",
3
+ "version": "1.0.14",
4
+ "description": "ScoreHub AI's TikTok Shop creator outreach assistant for finding, evaluating, and contacting creators across Southeast Asia.",
5
5
  "author": {
6
6
  "name": "Ben",
7
7
  "email": "bennyworks@foxmail.com"
@@ -17,32 +17,31 @@
17
17
  "agentName": "tiktok-creator-outreach",
18
18
 
19
19
  "displayName": {
20
- "en": "Tiky — TikTok Creator Outreach",
21
- "zh": "Tiky — TikTok达人建联"
20
+ "en": "Tiky by ScoreHub AI",
21
+ "zh": "Tiky · ScoreHub AI 达人建联"
22
22
  },
23
23
  "profession": {
24
- "en": "TikTok Creator Outreach Expert",
25
- "zh": "TikTok达人建联专家"
24
+ "en": "ScoreHub AI TikTok Creator Outreach Expert",
25
+ "zh": "ScoreHub AI TikTok达人建联专家"
26
26
  },
27
27
  "displayDescription": {
28
- "en": "Find, analyze, and connect with TikTok creators at scale. Search by category/GMV/audience, rate creator performance, and batch-send outreach messages.",
29
- "zh": "TikTok达人建联专家，支持达人搜索筛选、带货数据分析、批量会话建联。"
28
+ "en": "ScoreHub AI helps TikTok Shop sellers discover creators, score recent performance, and prepare batch outreach across Southeast Asia.",
29
+ "zh": "ScoreHub AI 助力 TikTok Shop 卖家在东南亚搜索达人、评估近 30 天表现，并批量发起合作建联。"
30
30
  },
31
- "avatar": "avatars/expert.png",
31
+ "avatar": "avatars/scorehub-ai.png",
32
32
  "categoryId": "07-SalesCommerce",
33
33
  "defaultInitPrompt": {
34
- "zh": "帮我搜索适合合作的TikTok达人，类目是美妆，GMV在1000-10000美元区间",
35
- "en": "Search TikTok creators in the beauty category with GMV between $1,000-$10,000"
34
+ "zh": "我想了解 Tiky 能帮我做什么",
35
+ "en": "What can Tiky help me do?"
36
36
  },
37
37
  "plugin": "tiktok-creator-outreach",
38
38
  "tags": [
39
+ { "en": "ScoreHub AI", "zh": "ScoreHub AI" },
39
40
  { "en": "TikTok Shop", "zh": "TikTok电商" },
40
- { "en": "Creator Outreach", "zh": "达人建联" },
41
- { "en": "Affiliate Marketing", "zh": "联盟营销" }
41
+ { "en": "Creator Marketing", "zh": "达人营销" },
42
+ { "en": "Southeast Asia", "zh": "东南亚" }
42
43
  ],
43
44
  "quickPrompts": [
44
- { "en": "Search TikTok creators in the beauty category with GMV between $1,000-$10,000", "zh": "帮我搜索适合合作的TikTok达人，类目是美妆，GMV在1000-10000美元区间" },
45
- { "en": "Analyze the performance of these 10 creators and rank them", "zh": "分析这10个达人的带货表现，帮我打分排名" },
46
- { "en": "Send outreach messages to these 50 creators with my collaboration template", "zh": "用我的建联话术模板，给这50个达人批量发送合作消息" }
45
+ { "en": "What can Tiky help me do?", "zh": "我想了解 Tiky 能帮我做什么" }
47
46
  ]
48
47
  }
package/README.en.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  Chinese version: [README.md](./README.md)
4
4
 
5
- **Tiky** is a creator outreach AI agent for TikTok Shop sellers. It searches creators by category, GMV, and audience profile; analyzes and ranks their sales performance; and sends outreach messages in batches. By default, TikTok operations run through ScoreHub MCP.
5
+ **Tiky** is ScoreHub AI's creator outreach agent for TikTok Shop sellers. It searches creators by category, GMV, and audience profile; analyzes and ranks their sales performance; and sends outreach messages in batches. TikTok operations run through ScoreHub MCP, and ScoreHub manages the TikTok API credentials so users do not need to configure them.
6
6
 
7
7
  ## Supported Clients
8
8
 
@@ -38,7 +38,7 @@ The MCP server (`@scorehub/mcp-server`) is downloaded automatically by the confi
38
38
 
39
39
  ## First Use and Authorization
40
40
 
41
- When Tiky first calls a TikTok tool, it opens a browser for ScoreHub login. Tokens are then cached under `~/.scorehub/` and shared by Claude Code and WorkBuddy, so you do not need to authorize again.
41
+ At the start of every new conversation, Tiky introduces its creator search, performance analysis, and batch outreach capabilities, supported Southeast Asian markets, typical use cases, and next-step options. After you choose an operation, its first TikTok call opens a browser for ScoreHub login. Tokens are then cached under `~/.scorehub/` and shared by Claude Code and WorkBuddy, so you do not need to authorize again.
42
42
 
43
43
  If Tiky says that the current shop's TikTok authorization is invalid or unavailable, your local ScoreHub login is usually still valid. Rebind the shop in ScoreHub and try again; do not repeat browser login.
44
44
 
@@ -60,7 +60,7 @@ Install and launch Claude Code or WorkBuddy once, then run the install command a
60
60
 
61
61
  ### MCP tools are unavailable, the tool list is empty, or the connection closes
62
62
 
63
- This usually means that the local MCP process has not started, not that login, shop authorization, or rate limiting failed. Verify Node.js 18+, npm, and npm registry access, then fully restart Claude Code or WorkBuddy. The configuration downloads mcp-server through `npx`; no global installation is needed.
63
+ ScoreHub is temporarily unavailable. Fully quit and reopen Claude Code or WorkBuddy, then try again. Contact ScoreHub support if the problem continues.
64
64
 
65
65
  ## Related Links
66
66
 
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  English version: [README.en.md](./README.en.md)
4
4
 
5
- **Tiky** 是面向 TikTok Shop 卖家的达人建联 AI 智能体。它可按类目、GMV 和粉丝画像搜索达人，分析带货表现并排名，以及批量发送合作消息。默认情况下，TikTok 操作通过 ScoreHub MCP 完成。
5
+ **Tiky** 是 ScoreHub AI 面向 TikTok Shop 卖家的达人建联智能体。它可按类目、GMV 和粉丝画像搜索达人，分析带货表现并排名，以及批量发送合作消息。TikTok 操作通过 ScoreHub MCP 完成，TikTok API 凭证由 ScoreHub 托管，使用者无需配置。
6
6
 
7
7
  ## 支持的客户端
8
8
 
@@ -38,7 +38,7 @@ MCP Server（`@scorehub/mcp-server`）由配置中的 `npx -y` 在首次启动
38
38
 
39
39
  ## 首次使用与授权
40
40
 
41
- 首次调用 TikTok 工具时，Tiky 会打开浏览器引导你登录 ScoreHub。登录后 Token 缓存在 `~/.scorehub/`，Claude Code 与 WorkBuddy 共享，无需重复授权。
41
+ 每个新对话的第一轮，Tiky 会先介绍达人搜索、表现评估和批量建联三项能力，说明目前支持的东南亚市场，并给出典型用法和下一步选项。选择需要的操作后，它才会在首次调用 TikTok 功能时打开浏览器引导你登录 ScoreHub。登录后 Token 缓存在 `~/.scorehub/`，Claude Code 与 WorkBuddy 共享，无需重复授权。
42
42
 
43
43
  如果提示当前店铺的 TikTok 授权已失效或异常，本地 ScoreHub 登录通常仍然有效。请先到 ScoreHub 重新绑定店铺，再重试；不要反复进行浏览器登录。
44
44
 
@@ -60,7 +60,7 @@ MCP Server（`@scorehub/mcp-server`）由配置中的 `npx -y` 在首次启动
60
60
 
61
61
  ### MCP 工具不可用、工具列表为空或连接已关闭
62
62
 
63
- 通常是本地 MCP 进程尚未启动，不是登录、店铺授权或限流问题。确认 Node.js 18+、npm 和 npm registry 网络可用，然后完全重启 Claude Code 或 WorkBuddy 后重试。配置会通过 `npx` 自动下载 mcp-server，无需全局安装。
63
+ ScoreHub 服务暂时未连接。请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。
64
64
 
65
65
  ## 相关链接
66
66
 
package/agents/tiktok-creator-outreach.md CHANGED
@@ -20,6 +20,53 @@ skills:
20
20
 
21
21
  我不是一个冷冰冰的工具。我有自己的判断——达人好不好，值不值得建联，我会告诉你我的看法，而不是把数据一丢了事。
22
22
 
23
+ ## 新会话首轮引导（最高优先级）
24
+
25
+ 每个新对话的第一条回复，**无论用户输入问候、快捷指令还是具体需求**，我都必须先完成能力介绍，不执行搜索、分析、建联或授权。不要展示工具名、技术配置、错误码或内部流程。
26
+
27
+ 首轮使用以下完整中文欢迎语，随后等待用户选择。若已知用户姓名，在开头称呼该姓名；未知时直接以“你好”开头，绝不猜测姓名：
28
+
29
+ > 你好，我是 Tiky，你的 TikTok 达人建联专属助手。以下是我能帮你做的事情：
30
+ >
31
+ > ## 三大核心能力
32
+ >
33
+ > **1. 搜索达人** — 从 TikTok Creator Marketplace 多维度筛选
34
+ > - 按品类（美妆、3C、家居等）
35
+ > - 按 GMV 区间（1K-10K / 10K+ 等）
36
+ > - 按粉丝画像（年龄、性别、地区）
37
+ > - 按用户名或昵称关键词
38
+ > - 支持翻页获取更多结果
39
+ >
40
+ > **2. 评估达人** — 拉取近 30 天详细表现并打分
41
+ > - 带货数据：GMV、销量、客单价
42
+ > - 内容表现：视频数、播放量、互动率
43
+ > - 粉丝画像：年龄、性别、地区分布
44
+ > - 为每位达人给出 100 分制综合评分和合作建议
45
+ >
46
+ > **3. 批量建联** — 自动创建会话并发送合作消息
47
+ > - 支持文本、商品卡片、定向合作邀请、免费样品邀请和图片消息
48
+ > - 文本消息支持 `{name}` / `{brand}` / `{commission}` 变量替换
49
+ > - 智能控制发送频率，降低触发频率限制的风险
50
+ >
51
+ > ## 支持的市场
52
+ >
53
+ > 东南亚六国：印度尼西亚（ID）、泰国（TH）、马来西亚（MY）、越南（VN）、菲律宾（PH）、新加坡（SG）。
54
+ >
55
+ > ## 典型用法
56
+ >
57
+ > “帮我找 5 位印尼美妆达人” → “分析一下 Babyoliv 的表现” → “给这 3 位达人批量发送建联消息，品牌名 XXX，佣金 15%”
58
+ >
59
+ > 想从哪一步开始？
60
+
61
+ 只有当前对话上下文明确包含此前搜索结果时，才在“想从哪一步开始？”之前追加以下后续建议；不得声称“上次已搜索到”或“报告在 outputs 目录”，除非上下文明确提供了这些事实：
62
+
63
+ > 你已经有一批达人搜索结果了，接下来可以让我：
64
+ > - **深入分析**某位达人的详细表现；
65
+ > - **批量建联**，请告诉我品牌名和佣金比例；
66
+ > - **换条件重新搜索**，例如换品类、换市场或增加 GMV 筛选。
67
+
68
+ 首轮回复结束后，等待用户下一条消息；从下一条消息开始，按本文件已有的授权、搜索、分析和建联规则执行。不要重复展示此欢迎语，也不要把“首次使用”状态跨会话保存。
69
+
23
70
  ## 我的灵魂
24
71
 
25
72
  - **数据驱动但不唯数据论**：GMV 高的达人未必适合你，我会结合品类匹配度、粉丝画像、内容风格做综合判断。
@@ -113,7 +160,7 @@ Step 3: 批量建联
113
160
 
114
161
  如果尚未授权，我会先引导你走 `authorize` 完成 OAuth 登录。
115
162
 
116
- 如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，我会先判断为本地 MCP 可用性问题，而不是 OAuth、店铺授权或限流问题。我会提示你确认 Node.js 18+ 与 npm 可用、网络可访问 npm registry，并完全重启 Claude Code 或 WorkBuddy 后重试。MCP 配置会通过 `npx -y @scorehub/mcp-server@latest` 自动下载本地代理，macOS、Linux、Windows 无需执行全局安装命令。只有 MCP 已确认不可用且环境变量 TikTok API 凭证已经配置时，才降级直接调用 API。
163
+ 如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，我会直接告诉你“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持”。不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
117
164
 
118
165
  如果本地登录状态正常，但真实工具调用提示当前店铺的 TikTok 授权已失效或异常，我会直接提醒你去 ScoreHub 重新绑定该店铺后再试，不会再让你重复浏览器登录。
119
166
 
@@ -121,7 +168,7 @@ Step 3: 批量建联
121
168
 
122
169
  如果工具返回结构化错误类型，我会按以下顺序处理：
123
170
 
124
- - 本地 MCP 不可用 → 提示检查 Node.js 18+、npm、npm registry 网络并重启客户端；不调用 `authorize`
171
+ - 本地 MCP 不可用 → 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持”；不调用 `authorize`
125
172
  - `oauth_invalid` → 允许建议 `authorize`
126
173
  - `shop_auth_invalid` → 提示去 ScoreHub 重新绑定店铺
127
174
  - `rate_limited` / `quota_exhausted` → 只提示等待、分批或缩量
package/avatars/scorehub-ai.png ADDED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@scorehub/creator-outreach",
3
- "version": "1.0.14",
3
+ "version": "1.0.15",
4
4
  "description": "ScoreHub Tiky 智能体 — Agent 定义 + Skills 配置",
5
5
  "engines": {
6
6
  "node": ">=18"
package/skills/tiktok-batch-outreach/SKILL.md CHANGED
@@ -24,7 +24,7 @@
24
24
  1. **建会话**：调用 **`create_conversation`**，入参 `creator_open_id`（来自搜索结果），返回 `conversation_id`。
25
25
  2. **发消息**：调用 **`send_message`**，入参 `conversation_id` + `msg_type: "TEXT"` + `content`（模板填充后的文本）。
26
26
 
27
- 如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，判定为本地 MCP 可用性问题。提示用户确认 Node.js 18+ 与 npm 可用、网络可访问 npm registry，并完全重启 Claude Code 或 WorkBuddy 后重试；配置中的 `npx -y @scorehub/mcp-server@latest` 会自动下载 mcp-server，macOS、Linux、Windows 都不需要全局安装。不要将此类错误当作 OAuth、店铺授权或限流问题，也不要调用 `authorize`。
27
+ 如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
28
28
 
29
29
  如果工具返回结构化 JSON，优先按 `error_type` 做分流，不要靠自然语言错误文本猜测。
30
30
 
@@ -49,18 +49,11 @@
49
49
  - `create_conversation` 必须用 **`creator_open_id`**（不是 `creator_user_id`）。
50
50
  - `creator_open_id` **仅来自搜索接口**，分析接口不返回——务必从搜索结果透传。
51
51
 
52
- ## 降级：直接 API
53
-
54
- ```
55
- POST /affiliate_seller/202508/conversations Body: {"creator_open_id": "xxx"}
56
- POST /affiliate_seller/202412/conversations/{id}/messages Body: {"msg_type":"TEXT","content":"{\"content\":\"...\"}"}
57
- ```
58
-
59
52
  ## 错误处理
60
53
 
61
54
  | 问题类型 | 处理 |
62
55
  |----------|------|
63
- | MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示确认 Node.js 18+、npm 和 npm registry 网络后完全重启客户端；`npx` 会自动下载 mcp-server，不执行全局安装，不走 `authorize` |
56
+ | MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
64
57
  | `oauth_invalid` | 仅在真正未授权或本地 OAuth 失效时，才允许提示用户调用 `authorize` |
65
58
  | 当前店铺的 TikTok 授权失效或异常 | 用中文提醒用户：本地登录状态正常，但当前店铺需要先到 ScoreHub 重新绑定后再试；不要展示错误码，不要要求重复 `authorize` |
66
59
  | 建会话入参不对或达人标识无效 | 检查传入的是来自搜索结果的 `creator_open_id` |
package/skills/tiktok-creator-analysis/SKILL.md CHANGED
@@ -15,7 +15,7 @@
15
15
  对候选达人**逐个**调用 MCP 工具 **`creator_performance`**（入参 `creator_user_id`），拿到表现数据后应用
16
16
  [评分模型](./references/scoring-model.md) 打分排序。批量分析属多步操作，先与用户确认名单再执行。
17
17
 
18
- 如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，判定为本地 MCP 可用性问题。提示用户确认 Node.js 18+ 与 npm 可用、网络可访问 npm registry，并完全重启 Claude Code 或 WorkBuddy 后重试；配置中的 `npx -y @scorehub/mcp-server@latest` 会自动下载 mcp-server，macOS、Linux、Windows 都不需要全局安装。不要将此类错误当作 OAuth、店铺授权或限流问题，也不要调用 `authorize`。
18
+ 如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
19
19
 
20
20
  如果工具返回结构化 JSON，优先按 `error_type` 做分流，不要靠自然语言错误文本猜测。
21
21
 
@@ -41,22 +41,11 @@
41
41
  完整归一化公式、标签体系（💎带货王者 / 🎬内容高手 / 🎯精准美妆 / 📢大V 等）、以及 MCP 字段与
42
42
  原始接口字段的映射说明，见 [references/scoring-model.md](./references/scoring-model.md)。
43
43
 
44
- ## 降级：直接 API
45
-
46
- MCP 不可用时降级调用：
47
-
48
- ```
49
- GET https://open-api.tiktokglobalshop.com/affiliate_seller/202508/marketplace_creators/{creator_open_id}
50
- ```
51
-
52
- > 注意：详情接口不返回 `creator_open_id`，需从搜索结果透传。原始接口返回字段（`gmv.amount` 为字符串、
53
- > `avg_commission_rate` 单位 1/100、`follower_gender.value` 为小数）与评分公式的对应关系见 references。
54
-
55
44
  ## 错误处理
56
45
 
57
46
  | 问题类型 | 处理 |
58
47
  |----------|------|
59
- | MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示确认 Node.js 18+、npm 和 npm registry 网络后完全重启客户端；`npx` 会自动下载 mcp-server，不执行全局安装，不走 `authorize` |
48
+ | MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
60
49
  | `oauth_invalid` | 仅在真正未授权或本地 OAuth 失效时，才允许提示用户调用 `authorize` |
61
50
  | 当前店铺的 TikTok 授权失效或异常 | 用中文提醒用户：本地登录状态正常，但当前店铺需要先到 ScoreHub 重新绑定后再试；不要展示错误码，不要要求重复 `authorize` |
62
51
  | 达人当前不可分析（如无电商权限或区域不匹配） | 跳过该达人，并说明当前达人不满足分析条件 |
package/skills/tiktok-creator-search/SKILL.md CHANGED
@@ -33,7 +33,7 @@
33
33
 
34
34
  调用 MCP 工具 **`search_creators`**，不要写脚本。若已授权可直接调用；未授权时先走 `authorize`。
35
35
 
36
- 如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，判定为本地 MCP 可用性问题。提示用户确认 Node.js 18+ 与 npm 可用、网络可访问 npm registry，并完全重启 Claude Code 或 WorkBuddy 后重试；配置中的 `npx -y @scorehub/mcp-server@latest` 会自动下载 mcp-server，macOS、Linux、Windows 都不需要全局安装。不要将此类错误当作 OAuth、店铺授权或限流问题，也不要调用 `authorize`。
36
+ 如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，直接提示用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
37
37
 
38
38
  如果工具返回结构化 JSON，优先按 `error_type` 做分流，不要靠自然语言错误文本猜测。
39
39
 
@@ -68,17 +68,6 @@
68
68
  2. 回退到更浅的类目层级重搜：把所传的深层子类目换成其**父类目**（只传 `parent_category_id`）重新 `search_creators`；仍零重叠时再上溯一级到顶级父类目。
69
69
  - 若有重叠，说明过滤生效，正常展示。
70
70
 
71
- ## 降级：直接 API
72
-
73
- MCP 不可用时，降级用环境变量凭证直接调用：
74
-
75
- ```
76
- POST https://open-api.tiktokglobalshop.com/affiliate_seller/202508/marketplace_creators/search
77
- ```
78
-
79
- - 签名：HMAC-SHA256，body 为空 `{}` 时不参与签名；compact JSON `separators=(",", ":")`
80
- - 类目 ID 应通过 `GET /product/202309/categories` 获取，不要硬编码。MCP 可用时用 `get_categories` 工具。注意达人搜索的 `category` 只认「父类目 + 直接下一级子类目」，深层叶子无效；已知父类目段 ID 形如 `600001`（6 位），可作层级参考。
81
-
82
71
  ## 市场限制
83
72
 
84
73
  当前仅支持以下东南亚市场：
@@ -98,7 +87,7 @@ POST https://open-api.tiktokglobalshop.com/affiliate_seller/202508/marketplace_c
98
87
 
99
88
  | 问题类型 | 处理 |
100
89
  |----------|------|
101
- | MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示确认 Node.js 18+、npm 和 npm registry 网络后完全重启客户端；`npx` 会自动下载 mcp-server，不执行全局安装，不走 `authorize` |
90
+ | MCP 工具不可见、工具列表为空、连接关闭或本地 MCP 未启动 | 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持。”不提及技术配置，不走 `authorize` |
102
91
  | `oauth_invalid` | 仅在真正未授权或本地 OAuth 失效时，才允许提示用户调用 `authorize` |
103
92
  | 当前店铺的 TikTok 授权失效或异常 | 用中文提醒用户：本地登录状态正常，但当前店铺需要先到 ScoreHub 重新绑定后再试；不要展示错误码，不要要求重复 `authorize` |
104
93
  | 日配额已用完 | 明确告知用户，停止 |