mcpField
T
tiktok-influencer-finder

tiktok-influencer-finder

github.com/gooseworks-ai营销与增长1.3k42 次安装3 天前更新
代码仓库

关于 tiktok-influencer-finder

这是一项通过 Apify 的 Influencer Discovery Agent 按领域查找 TikTok 创作者的命令行技能，适合营销人员按粉丝数、地区和相关度筛选候选账号。

主要功能

  1. 01按描述搜索 TikTok 创作者
  2. 02按粉丝数和匹配分筛选
  3. 03设置关键词与账号搜索上限
  4. 04排序并呈现符合条件的账号

适用场景

  1. 01为细分领域营销活动寻找创作者
  2. 02查找 AI 和科技类评测者
  3. 03按受众规模筛选网红
  4. 04按地区和子领域筛选候选账号

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gooseworks-ai/goose-skills --skill tiktok-influencer-finder

安装后在 Claude Code 中输入/tiktok-influencer-finder确认已加载。

附带文件scripts/find_influencers.pyskill.meta.json

详细介绍

TikTok 网红搜索

使用 Apify 的 Influencer Discovery Agent 搜索符合特定细分领域的 TikTok 网红。

快速开始

需要 requests，以及 GOOSEWORKS_API_KEY 或 APIFY_API_TOKEN 环境变量。

# Basic search
python3 skills/tiktok-influencer-finder/scripts/find_influencers.py \
  --description "fitness coaches for women over 40"

# With follower filters
python3 skills/tiktok-influencer-finder/scripts/find_influencers.py \
  --description "AI and tech reviewers" \
  --min-followers 10000 --max-followers 500000

# Summary table output
python3 skills/tiktok-influencer-finder/scripts/find_influencers.py \
  --description "vegan cooking creators" --output summary

# CSV export
python3 skills/tiktok-influencer-finder/scripts/find_influencers.py \
  --description "sustainable fashion" --output csv

第 1 步：收集条件

运行搜索前，询问用户的筛选条件。收集以下所有信息：

  1. 细分领域／描述：需要哪类网红？（如果提供了 $ARGUMENTS，则使用它；否则询问）
  2. 最低粉丝数：例如 5K、10K、50K
  3. 最高粉丝数：例如 50K、100K、500K
  4. 地区筛选：例如仅限美国、美国 + 加拿大、任何英语国家
  5. 细分领域偏好：在更广泛的领域中，有没有特定的内容方向？

在一个问题中询问全部 5 项条件，以尽量减少来回沟通。提供合理的默认选项，但始终允许用户自定义输入。

第 2 步：运行搜索

编写详细的 --description，结合用户的细分领域、内容风格偏好和目标受众。描述应具体且详尽。

python3 skills/tiktok-influencer-finder/scripts/find_influencers.py \
  --description "fitness coaches targeting women over 40, focus on home workouts and healthy aging" \
  --min-followers 5000 --max-followers 500000 \
  --min-fit 0.6 \
  --output json

此脚本使用 apify~influencer-discovery-agent actor。如果设置了 GOOSEWORKS_API_KEY，脚本会通过 GooseWorks 代理进行请求；如果设置了 APIFY_API_TOKEN，则直接请求 Apify。

第 3 步：筛选结果

收到结果后，按照用户的条件进行筛选：

  • 移除粉丝数低于最低要求的个人资料
  • 移除粉丝数高于最高要求的个人资料
  • 移除不在指定地区的个人资料
  • 移除不符合细分领域要求的个人资料（使用 fit 分数和 fitDescription 判断相关性；通常排除 fit < 0.6 的个人资料）
  • 排序剩余结果：先按匹配度分数降序，再按粉丝数降序

第 4 步：呈现结果

将筛选后的结果以清晰的 Markdown 表格呈现：

| 创作者 | 用户名 | 粉丝数 | 互动率 | 地区 | 内容方向 | 匹配度分数 |

包括：

  • 可点击的 TikTok 个人资料链接
  • 易读格式的粉丝数（例如 46.3K）
  • 以百分比表示的互动率
  • 对其内容方向的简短描述
  • AI 生成的匹配度分数

表格后还应包括：

  • 已分析的个人资料总数与符合条件的个人资料数
  • 如果符合条件的结果很少，说明这一情况，并建议调整条件
  • 提议使用不同的关键词或调整后的条件再次搜索

CLI 参考

标志默认值描述
--description必填描述要查找的网红类型
--keywords5要生成的搜索关键词数量（最多 5 个）
--profiles-per-keyword10每个关键词对应的个人资料数（最多 10 个）
--min-followers无最低粉丝数筛选条件
--max-followers无最高粉丝数筛选条件
--min-fit0.0最低匹配度分数（0.0-1.0）
--outputjson输出格式：json、csv、summary
--token环境变量Apify 令牌（覆盖环境变量）
--timeout300Apify 运行的最长秒数

注意事项

  • 此技能仅搜索 TikTok。如果用户需要其他平台，请告知他们此技能仅支持 TikTok，并推荐其他方案。
  • 当热门帖子带来的互动量远超粉丝数时，互动率可能超过 100%。
  • 根据搜索范围，网红发现 Agent 可能需要 1-3 分钟才能完成搜索。

评论

支持 Markdown