KOLens
全部文章
·KOLens 团队工作流海外达人发现MCP精准定位

精准 handle 工作流端到端教程：国家筛 + 品牌过滤 + 批量入库 + 相似创作者

Hashtag 搜索适合撒大网。精准定位需要不同的机器：先把噪音滤掉、粘种子名单、批量入库、从一位已知好达人横向扩展。四块拼图本周全部上线。

四块拼图

PR-A 国家 + 品牌筛选。PR-B TikTok 关键词发现走 MCP。PR-C handle 批量 入库。PR-D「相似创作者」横向扩展。同一周全部 上线，所以端到端流程今天就能跑，不是「即将」。

截图反馈暴露的问题

真实操作员反馈（Mira，美国高端童车赛道）：hashtag 发现返回 了 1000 条混杂视频——品牌账号在发自己的 AD 库存、小批发商、 加上零星几个真创作者散布在六七个国家。country 字段 在多数行上是 null。没办法筛「只看美国真实创作者」。

三个结构性修复上线，外加第四个让整条流程都能通过 MCP 调用。

逐步走一遍

  1. 1
    关键词撒大网（PR-B）
    从 Claude.ai 或任意 MCP 客户端：
    • 调 scrape_tiktok_by_keyword，传 keyword: 'stroller review'、max_videos: 200
    • 返回 job_id；JobScheduler 轮询循环会执行
    • 5-15 分钟后，约 50-150 个 author 落到你的 DB

    这是给 TikTok 配齐了 scrape_instagram_by_hashtag / scrape_youtube_by_keyword 等的对应工具—— 把「TikTok 是唯一没有 MCP 发现工具的平台」这个缺口补上。

  2. 2
    筛到真实美国创作者（PR-A）
    在网页 UI 的 /kols 上：
    • 国家下拉 →「US」
    • 打开「隐藏品牌 / 店铺账号」开关

    底层逻辑：筛选匹配 DBAuthor.country 或 DBAuthor.country_inferred（大小写不敏感）， 并排除 is_seller_like = true。1000 条混杂 原始数据变成 40-80 位可行动的美国创作者。

    回填注意：migration 015 之后存量 author 需要分类一次。 反复跑 POST /admin/classify-authors-pending?limit=500 直到 scanned 降到 0。

  3. 3
    挑一个种子 → 从他横向扩展（PR-D）
    找一位明显合适的达人。从 Claude：
    • find_similar_creators(seed_username, limit=20)
    • 返回 20 个候选，每行附打分维度
    • 排序公式：10·co_mention + 3·same_category + 1·shared_hashtag

    共提及规则——种子最近 50 条视频里的 @ 提及。一位种子 真合作过的创作者，在排序里比「随机同品类匹配」高 10 倍。

  4. 4
    批量入库短名单（PR-C）
    从相似列表里挑 10-15 位。两种方式：
    • 从 Claude： bulk_enrich_kols({handles: [...], max_videos_per_handle: 30})
    • 从网页：粘进 /kols/import

    每个 handle 一个 DBSearchJob。一次 Supabase round-trip 完成预扣。每个 handle 触发一个异步 worker；状态通过 既有的 /jobs/{id} 路由轮询。可选的 target_list_id 会把成功查询到的 author 自动 加进一个 KOL 名单。

  5. 5
    按品牌画像打分
    打开任意一份刚入库的 dossier。星级会自动渲染，因为你的 workspace 品牌画像已经设过。Creator Overview 给出一行推荐； 对最有希望的几位点 Deep Analysis 进入 5-credit 档，含 outreach 策略 + 议价备注。
  6. 6
    生成 outreach 并发送
    在 dossier 头部点「Cold outreach templates」。弹窗里要么 显示缓存草稿（免费），要么生成一份（1 credit）。邮件签名 从 workspaces.email_signature 填入——永远不会 出现「Your Name」/「Brand」这种占位符。

在 Claude 里——同样的流程一句 prompt 跑完

因为四块拼图都已通过 MCP 工具暴露，操作员可以在一次 Claude 会话里驱动整条工作流：

「帮我找 20 位跟 @paky_test 相似、且不是品牌账号的美国 创作者。把前 10 位入库。加进我的「US skincare seeds」名单。」

Claude 会调 find_similar_creators → list_kols（带国家+卖家筛选）→ bulk_enrich_kols，然后告诉你它在轮询哪些 job_id。端到端约 4 分钟，对比之前 30+ 分钟的手动复制粘贴 handle。

操作员部署清单

  1. 在 /admin/migrations 应用 migration 015
  2. 清空分类器积压： POST /admin/classify-authors-pending?limit=500 直到 scanned=0
  3. 填好 workspace 品牌画像，星级就会自动亮起
  4. 在同一个设置页填好发件人身份（姓名 + 品牌 + 签名）， outreach 草稿就能直接签名

这次 PR 包里没有的

  • 跨平台提及图（种子的 IG bio 里引用一个 TikTok handle）—— 需要在 DBContact 上加一列已解析引用
  • 受众重叠信号（种子的粉丝里也关注 X 的）——需要调用一个 我们当前还没接的 Influencers Club / Modash 受众重叠 API
  • dossier 页上 find_similar_creators 的 UI——数据形态已就绪， 按钮代码就是一两行，等操作员想要这个快捷方式时再加

准备好了?

立即试用 —— 注册即送 50 credits。

在 /kols/import 跑一次批量入库

常见问题

国家分类器没用 LLM，是怎么工作的？
三条规则，确定性，每个 author 约 50ms：(1) DBAuthor.country 如果已经设置就用它，按 ISO-2 标准化；(2) bio 关键词匹配，如 'USA' / 'NYC' / 'Los Angeles' / 'Tokyo' / 东京 这种——覆盖 15+ 国家；(3) audience_data.top_countries 中多数派 ≥40%。结果落到 country_inferred + country_source，UI 可以展示来源。
什么会被归类为「卖家账号」？
bio 关键词命中（DM to order / shop now / use code / official store / wholesale）OR 最近 20 条视频里 sponsored-or-AD 比例 >60%（最少 5 条视频样本）。筛选里默认 OFF，所以「隐藏卖家」是 opt-in。
handle 批量入库是预扣吗？
是。整批费用 = handle 数 × ceil(max_videos / 50)。在 worker 启动前用一次 Supabase round-trip 完成扣费。硬失败路径（Apify 4xx / 5xx）按单 handle 退预扣。
similar_creators 是按什么信号排的？
权重：10 × co_mention_count + 3 × (same_category 且粉丝量在 0.5x-2x 带内) + 1 × shared_hashtag_count。共提及压过同品类是有意设计——出现在种子的视频 @ 标签里，比「同品类、相近规模」是强得多的信号。
要用国家筛选，得回填 10 万个 author 吗？
目前是的。应用 migration 015，然后 POST /admin/classify-authors-pending?limit=500 反复跑，直到 scanned=0。无 LLM 成本、确定性、约 1 秒 / 200 行。回填完之后，新抓取会自动分类。

继续阅读

精准 handle 工作流端到端教程：国家筛 + 品牌过滤 + 批量入库 + 相似创作者 · KOLens | KOLens