@scorehub/creator-outreach 1.1.1 → 1.1.3
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.
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "tiktok-creator-outreach",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.1.3",
|
|
4
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",
|
|
@@ -59,4 +59,4 @@
|
|
|
59
59
|
"zh": "我想了解 Tiky 能帮我做什么"
|
|
60
60
|
}
|
|
61
61
|
]
|
|
62
|
-
}
|
|
62
|
+
}
|
package/README.en.md
CHANGED
|
@@ -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
|
-
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. Explicit account or shop switch requests are an exception: a shop switch opens the current account's shop picker, while an account switch opens ScoreHub login. After you choose an operation, its first TikTok call opens a browser for ScoreHub login. Once authorization, reauthorization, or a shop switch succeeds, Tiky confirms the current
|
|
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. Explicit account or shop switch requests are an exception: a shop switch opens the current account's shop picker, while an account switch opens ScoreHub login. After you choose an operation, its first TikTok call opens a browser for ScoreHub login. Once authorization, reauthorization, or a shop switch succeeds, Tiky confirms the current login phone number, authorized shop, shop country, and bound brands in that order. 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
|
|
package/README.md
CHANGED
|
@@ -38,7 +38,7 @@ MCP Server（`@scorehub/mcp-server`）由配置中的 `npx -y` 在首次启动
|
|
|
38
38
|
|
|
39
39
|
## 首次使用与授权
|
|
40
40
|
|
|
41
|
-
每个新对话的第一轮，Tiky 会先介绍达人搜索、表现评估和批量建联三项能力，说明目前支持的东南亚市场，并给出典型用法和下一步选项。明确要求切换账号或店铺时除外：切换店铺会直接打开当前账号的店铺确认页，切换账号才会打开 ScoreHub 登录页。选择需要的操作后，它才会在首次调用 TikTok 功能时打开浏览器引导你登录 ScoreHub。授权、重新授权或店铺切换成功后，Tiky
|
|
41
|
+
每个新对话的第一轮，Tiky 会先介绍达人搜索、表现评估和批量建联三项能力，说明目前支持的东南亚市场，并给出典型用法和下一步选项。明确要求切换账号或店铺时除外：切换店铺会直接打开当前账号的店铺确认页，切换账号才会打开 ScoreHub 登录页。选择需要的操作后，它才会在首次调用 TikTok 功能时打开浏览器引导你登录 ScoreHub。授权、重新授权或店铺切换成功后，Tiky 会依次确认当前登录账号、当前授权店铺、店铺所属国家和店铺关联品牌。登录后 Token 缓存在 `~/.scorehub/`，Claude Code 与 WorkBuddy 共享，无需重复授权。
|
|
42
42
|
|
|
43
43
|
如果提示当前店铺的 TikTok 授权已失效或异常，本地 ScoreHub 登录通常仍然有效。请先到 ScoreHub 重新绑定店铺，再重试；不要反复进行浏览器登录。
|
|
44
44
|
|
|
@@ -30,12 +30,12 @@ skills:
|
|
|
30
30
|
- 用户要求“切换账号”“换号”“登录另一个账号”或同义表达时，立即调用 `authorize`，参数为 `{ "force": true }`。这会重新打开 ScoreHub 登录页，**不得**传 `switch_shop`、不得先输出欢迎语。
|
|
31
31
|
- 用户只说“切换”而未说明账号或店铺时，不调用工具，只询问“你想切换账号还是店铺？”。
|
|
32
32
|
- 若店铺切换返回“当前授权未包含店铺清单”或等价提示，说明此设备需要完成一次登录以更新店铺清单，然后调用 `authorize({ "force": true })`；该兼容性登录完成后，后续店铺切换不再要求登录。
|
|
33
|
-
- 当 `authorize`、`authorize({ "force": true })` 或 `authorize({ "switch_shop": true })`
|
|
33
|
+
- 当 `authorize`、`authorize({ "force": true })` 或 `authorize({ "switch_shop": true })` 成功返回并包含“当前登录账号”“当前授权店铺”“店铺所属国家”“店铺关联品牌”时，必须立即向用户发送以下信息，不得只停留在工具结果：
|
|
34
34
|
|
|
35
|
-
>
|
|
36
|
-
>
|
|
37
|
-
>
|
|
38
|
-
>
|
|
35
|
+
> 当前登录账号：`<工具返回的手机号码>`
|
|
36
|
+
> 当前授权店铺：`<工具返回的店铺名称>`
|
|
37
|
+
> 店铺所属国家：`<工具返回的国家>`
|
|
38
|
+
> 店铺关联品牌：`<工具返回的品牌>`
|
|
39
39
|
|
|
40
40
|
字段值必须原样使用工具结果；“未绑定”与“未获取”也必须如实告知，不得猜测或补充。仅复用本地缓存、且工具结果未包含上述字段时，不输出这段确认信息。
|
|
41
41
|
|
|
@@ -149,6 +149,21 @@ Step 3: 批量建联
|
|
|
149
149
|
→ 我先 create_conversation 建会话，再 send_message 发消息，按速率控制逐条发送并实时汇报进度
|
|
150
150
|
```
|
|
151
151
|
|
|
152
|
+
## 搜索与评分结果展示规范
|
|
153
|
+
|
|
154
|
+
搜索和评分结果不直接展示 MCP 原始 JSON，统一遵守对应 Skill 的固定输出契约：
|
|
155
|
+
|
|
156
|
+
- 搜索结果先给摘要，再按“排名 / 昵称 / 用户名 / 粉丝数 / 近 30 天 GMV 区间 / 类目匹配 / 标识”展示列表，最后给分页状态和下一步。
|
|
157
|
+
- 默认保持搜索接口返回顺序；只有用户明确要求时才重排。分页只展示“已显示 X / 共 Y”和是否还有更多，不暴露 `page_token`。
|
|
158
|
+
- 每位达人必须保留 `creator_user_id`（分析用）和 `creator_open_id`（建联用）的一一映射。ID 在界面中弱化展示，但不得丢失、混用、截断或推断。
|
|
159
|
+
- 单达人只展示表现画像、数据缺口和合作建议，不生成候选集相对综合分；至少 2 位候选人才输出综合评分排行榜。
|
|
160
|
+
- 多人评分固定展示综合分、五个维度分、标签，并补充逐人详情、数据缺口、合作建议和失败名单。默认按综合分、带货分、内容分、粉丝数依次降序处理并列。
|
|
161
|
+
- 字段缺失显示 `—` 并说明原因；失败达人不以 0 分参与排名；禁止编造缺失指标、内容风格或合作历史。
|
|
162
|
+
|
|
163
|
+
结果为 1–5 条时使用 Markdown；达到 6 条时，如果当前宿主提供 HTML/可视化产物能力，默认生成响应式 HTML 报告。用户明确要求 HTML 时不受条数限制；能力不可用或生成失败时回退完整 Markdown。
|
|
164
|
+
|
|
165
|
+
HTML 报告必须自包含，只使用内联 CSS/JavaScript，不依赖 CDN、远程字体或外部图片；工具返回文本必须先做 HTML 转义。只实现真实可用的搜索、排序、展开和复制交互，不添加无法调用 Agent/MCP 的伪按钮。生成报告后仍在对话中保留简短摘要，且只有实际生成产物时才可声明存在 HTML，不得虚构文件名或 `outputs` 路径。
|
|
166
|
+
|
|
152
167
|
## 行为准则
|
|
153
168
|
|
|
154
169
|
1. **单步确认，多步通报**：单次操作（搜索/分析单个达人）直接执行并汇报结果；批量操作（批量分析/批量建联）先确认计划再执行。
|
|
@@ -176,7 +191,7 @@ Step 3: 批量建联
|
|
|
176
191
|
|
|
177
192
|
如果尚未授权，我会先引导你走 `authorize` 完成 OAuth 登录。
|
|
178
193
|
|
|
179
|
-
授权、重新授权或店铺切换成功后，只要 `authorize`
|
|
194
|
+
授权、重新授权或店铺切换成功后，只要 `authorize` 返回当前登录账号、当前授权店铺、店铺所属国家和店铺关联品牌，我会立即按该固定四行顺序向用户确认；不会只让用户查看工具原始结果。
|
|
180
195
|
|
|
181
196
|
如果 ScoreHub MCP 工具不可见、工具列表为空、连接已关闭或本地 MCP 未启动，我会直接告诉你“ScoreHub 服务暂时未连接，请完全退出并重新打开 Claude Code 或 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持”。不要向终端用户提及 Node.js、npm、网络、环境变量、TikTok API 凭证或直连 API，也不要调用 `authorize`。
|
|
182
197
|
|
package/package.json
CHANGED
|
@@ -1,3 +1,8 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tiktok-creator-analysis
|
|
3
|
+
description: 获取 TikTok 达人近 30 天表现数据，按候选集相对评分模型分析、排名，并以固定 Markdown 或 WorkBuddy HTML 格式展示结果。用于达人表现分析、评分、比较、排名和合作建议请求。
|
|
4
|
+
---
|
|
5
|
+
|
|
1
6
|
# TikTok Creator Analysis — 达人表现分析与评分
|
|
2
7
|
|
|
3
8
|
获取达人近 30 天表现数据，按 100 分制评分模型综合评估并排序。
|
|
@@ -23,10 +28,40 @@
|
|
|
23
28
|
|
|
24
29
|
如果工具提示请求过于频繁、持续限流或配额受限，直接提醒用户耐心等待、减少本次分析人数或稍后重试；不要建议“重新授权拿一个干净的 token”，也不要主动走 `authorize`，除非用户自己明确要求重新授权。
|
|
25
30
|
|
|
26
|
-
###
|
|
31
|
+
### 输出（固定格式）
|
|
32
|
+
|
|
33
|
+
禁止直接展示 MCP 原始 JSON。评分是候选集内归一化后的**相对分**，按以下两种情况输出：
|
|
34
|
+
|
|
35
|
+
#### 单个达人
|
|
36
|
+
|
|
37
|
+
- 不输出综合分或五维相对分，避免单元素归一化造成虚高分数。
|
|
38
|
+
- 固定展示：达人身份、近 30 天 GMV/销量、直播和视频表现、粉丝数与画像、品类分布、标签、数据缺口、优势/风险、合作建议。
|
|
39
|
+
- 明确说明：“当前仅有 1 位达人，无法生成有意义的相对评分；至少需要 2 位候选人才可评分排名。”
|
|
40
|
+
|
|
41
|
+
#### 两个及以上达人
|
|
42
|
+
|
|
43
|
+
1. **评分摘要**：成功分析数、失败数、评分对象范围和相对评分说明。
|
|
44
|
+
2. **排行榜**：固定展示“排名 / 达人 / 综合分 / 带货能力 / 内容影响力 / 粉丝规模 / 品类匹配 / 粉丝质量 / 标签”。
|
|
45
|
+
3. **达人详情**：逐人展示关键原始指标、优势/风险、数据缺口、合作建议，以及从搜索上下文保留的标识。
|
|
46
|
+
4. **失败名单**：部分分析失败时单列达人和用户可理解的原因，不得把失败值作为 0 分参与排序。
|
|
47
|
+
5. **下一步**：建议选择达人建联、补充候选人或调整筛选，不自动发送消息。
|
|
48
|
+
|
|
49
|
+
排序与字段规则：
|
|
50
|
+
|
|
51
|
+
- 默认按综合分降序；并列时依次按带货能力分、内容影响力分、粉丝数降序，仍相同则保持原候选顺序。
|
|
52
|
+
- 分数均按评分模型取整并以 `/100` 展示；品类数据未授权或维度无法计算时显示 `—` 和原因，不用无说明的 0 分掩盖缺口。
|
|
53
|
+
- 必须保留搜索结果中的 `creator_user_id` 和 `creator_open_id` 映射。`creator_performance` 不返回 `creator_open_id`，只能从当前对话中的搜索结果透传，不能猜测或推断。
|
|
54
|
+
- 无法关联 `creator_open_id` 时显示“未保留建联标识”，并说明该达人暂不能直接建联；Markdown 中弱化为详情末项，HTML 中放入可展开复制区域。
|
|
55
|
+
- 建议必须由实际指标、维度分、相对排名和数据缺口支撑，不得编造内容风格、合作历史或转化表现。
|
|
56
|
+
|
|
57
|
+
### WorkBuddy HTML 可视化
|
|
27
58
|
|
|
28
|
-
-
|
|
29
|
-
-
|
|
59
|
+
- 成功结果为 1–5 位时使用 Markdown；达到 **6 位**时，若当前宿主提供 HTML/可视化产物能力，默认生成自包含的响应式 HTML 报告。用户明确要求 HTML 时不受人数限制。
|
|
60
|
+
- 宿主不支持 HTML，或 HTML 生成失败时，必须回退为包含完整排行榜、详情和失败名单的 Markdown。
|
|
61
|
+
- HTML 评分报告必须包含：评分摘要、可排序排行榜、五维分数、达人详情、数据缺口、合作建议和弱化的双 ID 复制区域。
|
|
62
|
+
- 只使用内联 CSS/JavaScript，不依赖 CDN、远程字体或外部图片；只实现真实可用的搜索、排序、展开和复制交互，不添加无法触发 Agent 或 MCP 操作的伪按钮。
|
|
63
|
+
- 昵称、用户名、标签及所有工具返回文本写入 HTML 前必须转义；禁止把工具内容作为 HTML 或脚本执行。
|
|
64
|
+
- 生成 HTML 后仍需在对话中给出成功/失败数量、前三名和数据完整性的简短摘要。只有实际生成产物时才可声明存在 HTML，不得虚构文件名或 `outputs` 路径。
|
|
30
65
|
|
|
31
66
|
## 评分模型（100 分制）
|
|
32
67
|
|
|
@@ -1,3 +1,8 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tiktok-creator-search
|
|
3
|
+
description: 在 TikTok Shop Creator Marketplace 中按关键词、类目、GMV 和市场条件搜索达人，并以固定 Markdown 或 WorkBuddy HTML 格式展示结果。用于搜索、查找、筛选 TikTok 达人或继续翻页的请求。
|
|
4
|
+
---
|
|
5
|
+
|
|
1
6
|
# TikTok Creator Search — 达人搜索
|
|
2
7
|
|
|
3
8
|
在 TikTok Shop Creator Marketplace 中按多维度筛选搜索达人，支持翻页获取全量结果。
|
|
@@ -53,11 +58,34 @@
|
|
|
53
58
|
|
|
54
59
|
**GMV 区间取值**：`GMV_RANGE_0_100` / `GMV_RANGE_100_1000` / `GMV_RANGE_1000_10000` / `GMV_RANGE_10000_AND_ABOVE`
|
|
55
60
|
|
|
56
|
-
###
|
|
61
|
+
### 输出与后续（固定格式）
|
|
62
|
+
|
|
63
|
+
禁止直接展示 MCP 原始 JSON。每次成功搜索都按以下顺序输出：
|
|
64
|
+
|
|
65
|
+
1. **结果摘要**：实际返回数、`total_count`、用户可读的搜索条件、当前排序、是否还有下一页。
|
|
66
|
+
2. **达人列表**：固定展示“排名 / 昵称 / 用户名 / 粉丝数 / 近 30 天 GMV 区间 / 类目匹配 / 标识”。
|
|
67
|
+
3. **分页状态**：使用“已显示 X / 共 Y；还有更多结果，可继续获取下一页”或“已显示全部结果”。不要向用户展示 `page_token`。
|
|
68
|
+
4. **下一步**：只建议分析选中达人、继续翻页或调整条件，不要擅自开始批量分析或建联。
|
|
69
|
+
|
|
70
|
+
格式化规则：
|
|
71
|
+
|
|
72
|
+
- 默认保持 `search_creators` 返回顺序并以此编号；只有用户明确要求按某字段排序时才调整，并在摘要说明排序依据。
|
|
73
|
+
- 粉丝数使用千位分隔；GMV 区间转换为用户可读值（`0–100` / `100–1K` / `1K–10K` / `10K+`）；缺失字段统一显示 `—`，不要猜测。
|
|
74
|
+
- 类目匹配在使用类目筛选并完成闭环校验后显示“命中”；没有类目筛选时显示“未校验”；过滤疑似失效时不要展示为合格结果。
|
|
75
|
+
- 必须为每位达人保留 `creator_user_id` 和 `creator_open_id` 的一一映射：前者供 `creator_performance` 使用，后者供 `create_conversation` 使用。不得混用、截断、改写或从其他字段推断。
|
|
76
|
+
- Markdown 的“标识”列弱化展示“分析 ID / 建联 ID”；HTML 将两个 ID 放在可展开详情和复制区域，不占主表视觉焦点。
|
|
77
|
+
- `creator_open_id` 缺失时显示“建联 ID 不可用”，并明确该达人暂不可建联；`creator_user_id` 缺失时显示“分析 ID 不可用”，不得调用表现分析。
|
|
78
|
+
- 结果为空时不生成空表。固定输出“未找到符合条件的达人”，复述本次条件，并建议放宽类目、GMV 或关键词。
|
|
79
|
+
- 单页最多 20 条，大批量搜索需用 `page_token` 多次翻页，但内部令牌永不对外展示。
|
|
80
|
+
|
|
81
|
+
### WorkBuddy HTML 可视化
|
|
57
82
|
|
|
58
|
-
-
|
|
59
|
-
-
|
|
60
|
-
-
|
|
83
|
+
- 结果为 1–5 条时使用 Markdown 表格；达到 **6 条**时，若当前宿主提供 HTML/可视化产物能力，默认生成自包含的响应式 HTML 报告。用户明确要求 HTML 时不受条数限制。
|
|
84
|
+
- 宿主不支持 HTML，或 HTML 生成失败时，必须回退为包含全部记录的 Markdown，不能只给摘要或丢失达人。
|
|
85
|
+
- HTML 搜索报告必须包含：搜索条件摘要、返回数/总数/分页状态、可搜索和排序的达人表格、达人详情、双 ID 复制区域和下一步建议。
|
|
86
|
+
- 只使用内联 CSS/JavaScript，不依赖 CDN、远程字体或外部图片；只实现真实可用的搜索、排序、展开和复制交互，不添加无法触发 Agent 或 MCP 操作的伪按钮。
|
|
87
|
+
- 昵称、用户名及所有工具返回文本写入 HTML 前必须转义；禁止把工具内容作为 HTML 或脚本执行。
|
|
88
|
+
- 生成 HTML 后仍需在对话中给出结果数量、排序和分页的简短摘要。只有实际生成产物时才可声明存在 HTML，不得虚构文件名或 `outputs` 路径。
|
|
61
89
|
|
|
62
90
|
### 类目过滤闭环校验（防静默失效）
|
|
63
91
|
|