@scorehub/creator-outreach 1.0.3 → 1.0.4
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,12 +31,17 @@ skills:
|
|
|
31
31
|
|
|
32
32
|
### 1. 达人搜索与发现
|
|
33
33
|
在多维筛选条件下，从 TikTok Creator Marketplace 精准搜索达人。
|
|
34
|
-
-
|
|
34
|
+
- **类目筛选（父类目优先，务必遵守）**：
|
|
35
35
|
1. 当用户提到品类/类目关键词（如"美妆"/"3C"/"beauty"/"electronics"）时，**先调用 `get_categories`** 解析为类目 ID。传入 `keyword`（品类名），并根据语言设置 `locale`（中文用 `"zh-CN"`，英文用 `"en-US"`），建议同时传 `category_version: "v2"`。
|
|
36
|
-
2.
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
36
|
+
2. **优先匹配父类目（`is_leaf=false`）**：从返回结果中筛选 `is_leaf=false` 的非叶子类目（即品类大类/父类目）。如果匹配到父类目：
|
|
37
|
+
- 构造 `category` 参数：`[{parent_category_id: "父类目ID"}]` —— **不要传 `child_category_id_list`**。API 会搜索该父类目下所有子类目的达人，覆盖面最广。
|
|
38
|
+
- 如果匹配到多个父类目，用表格展示让用户确认想要筛选哪些（或全部）。
|
|
39
|
+
3. **兜底匹配子类目**：仅当返回结果中**没有任何 `is_leaf=false` 的父类目**时，才降级使用叶子类目：
|
|
40
|
+
- 筛选 `is_leaf=true` 的叶子类目，按 `parent_id` 分组。
|
|
41
|
+
- 构造 `category` 参数：`[{parent_category_id: "父类目ID", child_category_id_list: ["叶子ID1", "叶子ID2"]}]`。
|
|
42
|
+
- 如果匹配到多个子类目，同样用表格展示让用户确认。
|
|
43
|
+
- **核心原则**：父类目覆盖 > 子类目精确。宁愿多搜到一些达人（由后续 GMV/粉丝画像等条件进一步筛选），也不要因为子类目划分过细而漏掉潜在合适的达人。
|
|
44
|
+
- **注意**：绝不要凭空猜测类目 ID。
|
|
40
45
|
- GMV 区间筛选（0-100 / 100-1K / 1K-10K / 10K+）
|
|
41
46
|
- 销量区间筛选
|
|
42
47
|
- 关键词搜索（用户名/昵称匹配）
|
package/package.json
CHANGED
|
@@ -18,10 +18,17 @@
|
|
|
18
18
|
如果用户提到了品类/类目关键词（如"美妆"、"3C"、"beauty"、"electronics"），**必须**先调用 `get_categories` 获取类目 ID，再调用 `search_creators`：
|
|
19
19
|
|
|
20
20
|
1. **`get_categories`** — 传入 `keyword`（品类名关键词），建议同时传 `category_version: "v2"` 和合适的 `locale`（中文用 `"zh-CN"`，英文用 `"en-US"`）
|
|
21
|
-
2. 从返回的 `categories`
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
21
|
+
2. **优先匹配父类目（`is_leaf=false`）** — 从返回的 `categories` 数组中筛选 `is_leaf=false` 的非叶子节点（即品类大类/父类目）。如果匹配到父类目，直接使用父类目 ID：
|
|
22
|
+
- 构造 `category` 参数时 **只传 `parent_category_id`，不传 `child_category_id_list`**：`[{parent_category_id: "父ID"}]`
|
|
23
|
+
- 这样 API 会搜索该父类目下**所有**子类目的达人，覆盖面最广
|
|
24
|
+
- 如果匹配到多个父类目，用**表格展示**让用户确认要筛选哪些
|
|
25
|
+
3. **兜底匹配子类目** — 仅当返回结果中**没有任何 `is_leaf=false` 的父类目**时，才降级使用子类目匹配：
|
|
26
|
+
- 筛选 `is_leaf=true` 的叶子节点，按 `parent_id` 分组
|
|
27
|
+
- 构造 `category` 参数：`[{parent_category_id: "父ID", child_category_id_list: ["叶子ID1", "叶子ID2"]}]`
|
|
28
|
+
- 如果匹配到多个子类目，同样用**表格展示**让用户确认
|
|
29
|
+
4. 将构造好的 `category` 参数传给 `search_creators`
|
|
30
|
+
|
|
31
|
+
> **核心原则**：父类目覆盖 > 子类目精确。宁愿多搜到一些达人（由后续 GMV/粉丝画像等条件进一步筛选），也不要因为子类目划分过细而漏掉潜在合适的达人。
|
|
25
32
|
|
|
26
33
|
调用 MCP 工具 **`search_creators`**，不要写脚本。若已授权可直接调用；未授权时先走 `authorize`。
|
|
27
34
|
|
|
@@ -30,7 +37,7 @@
|
|
|
30
37
|
| 参数 | 说明 |
|
|
31
38
|
|------|------|
|
|
32
39
|
| `keyword` | 用户名/昵称搜索（可选） |
|
|
33
|
-
| `category` |
|
|
40
|
+
| `category` | 品类筛选数组（可选）。支持两种格式：① **父类目模式（推荐优先使用）**：`[{parent_category_id: "父ID"}]`，不传 `child_category_id_list`，搜索该父类目下所有子类目；② **子类目模式（仅兜底使用）**：`[{parent_category_id: "父ID", child_category_id_list: ["叶子ID1"]}]`。多个对象 OR 关系，单个对象内 child_category_id_list AND 关系。类目 ID **必须先通过 `get_categories` 获取**，不要硬编码或猜测。 |
|
|
34
41
|
| `gmv_ranges` | GMV 区间数组，取值见下表（可选） |
|
|
35
42
|
| `page_size` | 每页条数，默认/上限 20 |
|
|
36
43
|
| `page_token` | 翻页令牌，首次不传，用上一页返回的 `next_page_token` 续拉 |
|