用途
该技能用于按任意细分领域或主题发现并排名 TikTok 创作者。它通过抓取相关话题标签和用户主页,返回包含粉丝数、互动率和可用于达人外联的联系资料在内的排名列表。
主要能力
- 按细分领域或主题查找 TikTok 创作者
- 抓取相关话题标签和用户主页
- 返回排名列表,包含粉丝数、互动率和可用于外联的资料
- 支持按关键词搜索帖子,排序方式可选 RELEVANCE、MOST_LIKED、DATE_POSTED
- 支持按 ISO 3166-1 alpha-2 国家代码进行地区筛选
- 可选使用 tiktok-profile-scraper 补充互动率和视频表现等更详细的资料
使用方式
前置条件
- 设置 APIFY_TOKEN 环境变量
- 可选:安装 Apify MCP 服务器
输入参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| startUrls | array | 可选 | [] | TikTok URL——用户主页、话题标签、音乐页面、搜索、地点 |
| keywords | array | 可选 | [] | 用于查找帖子的搜索关键词/词条 |
| sortType | string | 可选 | RELEVANCE | 关键词结果排序:RELEVANCE、MOST_LIKED、DATE_POSTED |
| location | string | 可选 | — | 用于地区筛选的 ISO 3166-1 alpha-2 国家代码(如 US、GB) |
| maxItems | number | 可选 | 不限 | 单次运行返回的最大帖子数 |
| includeSearchKeywords | boolean | 可选 | false | 为每个帖子添加匹配的搜索关键词字段 |
| customMapFunction | string | 可选 | — | 用于转换每个输出对象的 JavaScript 函数 |
工作流程
- 明确参数:向用户询问细分领域/主题、最大粉丝数、最小粉丝数(可选)、创作者数量(默认 50)、语言/地区(可选)。
- 构建话题标签列表:为该细分领域生成 5-8 个相关话题标签。
- 运行 tiktok-scraper:推荐使用 run_actor.js(自动处理等待、输出和文件保存)。
# 快速回答(在聊天中打印表格)
node scripts/run_actor.js \
--actor "apidojo~tiktok-scraper" \
--input '{"param": "value"}'
# 保存为 CSV
node scripts/run_actor.js \
--actor "apidojo~tiktok-scraper" \
--input '{"param": "value"}' \
--output YYYY-MM-DD_results.csv --format csv
# 保存为 JSON
node scripts/run_actor.js \
--actor "apidojo~tiktok-scraper" \
--input '{"param": "value"}' \
--output YYYY-MM-DD_results.json --format json
APIFY_TOKEN 必须设置在环境变量或 .env 文件中。
如果 Apify MCP 可用:
- 工具:apify:run-actor
- Actor:"apidojo~tiktok-scraper"
- 输入:
{
"keywords": ["[hashtag1]", "[hashtag2]", "[hashtag3]"],
"shouldDownloadCovers": false
}
如果 Apify MCP 不可用:
curl -X POST \
"https://api.apify.com/v2/acts/apidojo~tiktok-scraper/runs?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"keywords": ["[hashtag1]", "[hashtag2]"],
"shouldDownloadCovers": false
}'
保存 RUN_ID。等待状态为 SUCCEEDED。
- 获取并去重创作者:
curl "https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?token=$APIFY_TOKEN"
从结果中提取唯一的 authorMeta.id 值。去重——同一创作者常出现在多个话题标签下。按 authorMeta.fans(粉丝数)排序。
可选补充:如果用户需要更详细的主页资料,用排名靠前的创作者用户名运行 apidojo/tiktok-profile-scraper,以获取互动率和视频表现。
- 应用筛选并排名:应用用户的粉丝范围筛选。计算简单互动分:
engagement_score = (avg_likes + avg_comments) / follower_count * 100
在粉丝范围内按互动分排名。
输出格式
# TikTok Creator Discovery: [NICHE] Niche
Found: [N] creators | Follower range: [MIN]–[MAX] | Date: [DATE]
| # | Username | Followers | Avg Views | Eng. Rate | Niche Tags | Profile |
|---|----------|-----------|-----------|-----------|------------|---------|
| 1 | @[name] | [N] | [N] | [X.X%] | [tags] | [url] |
| 2 | @[name] | [N] | [N] | [X.X%] | [tags] | [url] |
## Top Picks for Outreach
1. **@[name]** — [N] followers, [X.X%] engagement, posts primarily about [topic]
2. **@[name]** — [N] followers, [X.X%] engagement, posts primarily about [topic]
3. **@[name]** — [N] followers, [X.X%] engagement, posts primarily about [topic]
## Notes
- Engagement rate > 5% is considered high for this follower range
- [N] creators filtered out (outside follower range)
- Data freshness: ~24h from TikTok public API
适用场景
- 按细分领域或主题寻找 TikTok 达人
- 达人外联前的候选名单筛选与排名
- 按粉丝范围和互动率筛选微影响者
限制
- 需要设置 APIFY_TOKEN 环境变量
- 结果过少时:增加更多话题标签或移除粉丝筛选
- 结果全是大账号时:细分领域话题标签容易浮现超级影响者,可尝试子细分话题标签(如用 #homegymtok 代替 #fitness)
- 粉丝数可能过时:Apify 缓存的 TikTok 数据通常为 24-48 小时前
- 数据新鲜度:距 TikTok 公共 API 约 24 小时
- 互动率 > 5% 在该粉丝范围内被视为高
触发条件
当用户要求:查找 TikTok 影响者等场景时触发。