@scorehub/creator-outreach 1.0.1 → 1.0.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.
|
@@ -31,7 +31,12 @@ skills:
|
|
|
31
31
|
|
|
32
32
|
### 1. 达人搜索与发现
|
|
33
33
|
在多维筛选条件下，从 TikTok Creator Marketplace 精准搜索达人。
|
|
34
|
-
-
|
|
34
|
+
- **类目筛选（两步走，务必遵守）**：
|
|
35
|
+
1. 当用户提到品类/类目关键词（如"美妆"/"3C"/"beauty"/"electronics"）时，**先调用 `get_categories`** 解析为类目 ID。传入 `keyword`（品类名），并根据语言设置 `locale`（中文用 `"zh-CN"`，英文用 `"en-US"`），建议同时传 `category_version: "v2"`。
|
|
36
|
+
2. 从返回结果中筛选 `is_leaf=true` 的叶子类目，按 `parent_id` 分组。
|
|
37
|
+
3. 构造 `category` 参数：`[{parent_category_id: "父类目ID", child_category_id_list: ["叶子ID1", "叶子ID2"]}]`。
|
|
38
|
+
4. 将 `category` 参数传给 `search_creators` 进行达人搜索。
|
|
39
|
+
- **注意**：如果 `get_categories` 返回多个匹配结果，用表格展示让用户确认。绝不要凭空猜测类目 ID。
|
|
35
40
|
- GMV 区间筛选（0-100 / 100-1K / 1K-10K / 10K+）
|
|
36
41
|
- 销量区间筛选
|
|
37
42
|
- 关键词搜索（用户名/昵称匹配）
|
|
@@ -83,11 +88,13 @@ Step 3: 批量建联
|
|
|
83
88
|
4. **失败不沉默**：API 调用失败时我会明确告知原因（错误码+英文原文 message），并提供替代方案。
|
|
84
89
|
5. **数据可追溯**：每次搜索结果、分析报告、建联记录都保留完整，方便你后续回溯。
|
|
85
90
|
6. **不在深夜骚扰达人**：建联消息默认按达人所在时区的工作时间（9:00-21:00）发送，避免深夜打扰。
|
|
91
|
+
7. **类目解析规范**：当用户提到品类名称（如"美妆"/"电子产品"）时，必须先用 `get_categories` 解析为类目 ID，再搜索达人。绝不要凭空猜测类目 ID 或使用硬编码值。如果 `get_categories` 返回多个匹配结果，用表格展示让用户确认具体要筛选哪些类目。
|
|
86
92
|
|
|
87
93
|
## 调用方式
|
|
88
94
|
|
|
89
95
|
优先使用 ScoreHub MCP 工具（本地 MCP Server 已连接）：
|
|
90
96
|
- `search_creators` — 搜索达人
|
|
97
|
+
- `get_categories` — 获取商品类目树，将品类名称（如"美妆"/"电子产品"）转换为类目 ID。**搜索达人前如果用户提到了品类关键词，必须先调用此工具获取类目 ID，禁止凭空猜测**
|
|
91
98
|
- `creator_performance` — 获取达人表现
|
|
92
99
|
- `create_conversation` — 创建达人会话（建联前置，用 `creator_open_id`）
|
|
93
100
|
- `send_message` — 发送建联消息
|
package/install.js
CHANGED
|
@@ -14,7 +14,7 @@ const AGENT_DEST = path.join(AGENTS_DIR, 'tiktok-creator-outreach.md');
|
|
|
14
14
|
const MCP_CONFIG = {
|
|
15
15
|
type: 'stdio',
|
|
16
16
|
command: 'npx',
|
|
17
|
-
args: ['-y', '@scorehub/mcp-server'],
|
|
17
|
+
args: ['-y', '@scorehub/mcp-server@latest'],
|
|
18
18
|
env: {
|
|
19
19
|
SCOREHUB_REMOTE_MCP_URL: 'https://mcp.scorehub.cn',
|
|
20
20
|
},
|
package/package.json
CHANGED
|
@@ -13,6 +13,16 @@
|
|
|
13
13
|
|
|
14
14
|
## 执行方式（MCP 优先）
|
|
15
15
|
|
|
16
|
+
### 类目筛选前置步骤（重要）
|
|
17
|
+
|
|
18
|
+
如果用户提到了品类/类目关键词（如"美妆"、"3C"、"beauty"、"electronics"），**必须**先调用 `get_categories` 获取类目 ID，再调用 `search_creators`：
|
|
19
|
+
|
|
20
|
+
1. **`get_categories`** — 传入 `keyword`（品类名关键词），建议同时传 `category_version: "v2"` 和合适的 `locale`（中文用 `"zh-CN"`，英文用 `"en-US"`）
|
|
21
|
+
2. 从返回的 `categories` 数组中，筛选出 `is_leaf: true` 的叶子节点
|
|
22
|
+
3. 按 `parent_id` 分组叶子节点
|
|
23
|
+
4. 构造 `category` 参数：`[{parent_category_id: "父ID", child_category_id_list: ["叶子ID1", "叶子ID2"]}]`
|
|
24
|
+
5. 传给 `search_creators`
|
|
25
|
+
|
|
16
26
|
调用 MCP 工具 **`search_creators`**，不要写脚本。若已授权可直接调用；未授权时先走 `authorize`。
|
|
17
27
|
|
|
18
28
|
### 入参
|
|
@@ -20,6 +30,7 @@
|
|
|
20
30
|
| 参数 | 说明 |
|
|
21
31
|
|------|------|
|
|
22
32
|
| `keyword` | 用户名/昵称搜索（可选） |
|
|
33
|
+
| `category` | 品类筛选数组（可选）。格式：`[{parent_category_id: "父ID", child_category_id_list: ["叶子ID1"]}]`。多个对象 OR 关系，单个对象内 child_category_id_list AND 关系。类目 ID **必须先通过 `get_categories` 获取**，不要硬编码或猜测。 |
|
|
23
34
|
| `gmv_ranges` | GMV 区间数组，取值见下表（可选） |
|
|
24
35
|
| `page_size` | 每页条数，默认/上限 20 |
|
|
25
36
|
| `page_token` | 翻页令牌，首次不传，用上一页返回的 `next_page_token` 续拉 |
|
|
@@ -41,7 +52,7 @@ POST https://open-api.tiktokglobalshop.com/affiliate_seller/202508/marketplace_c
|
|
|
41
52
|
```
|
|
42
53
|
|
|
43
54
|
- 签名：HMAC-SHA256，body 为空 `{}` 时不参与签名；compact JSON `separators=(",", ":")`
|
|
44
|
-
-
|
|
55
|
+
- 类目 ID 应通过 `GET /product/202309/categories` 获取，不要硬编码。MCP 可用时用 `get_categories` 工具；降级时可参考已知 ID：`1000001`（Beauty & Personal Care）、`600024`（Beauty 子类目）
|
|
45
56
|
|
|
46
57
|
## 错误处理
|
|
47
58
|
|