前言¶
做抖音投放或内容对标时，常见做法是手工搜账号、翻星图、把粉丝数和报价抄进表格。赛道一多、关键词一变，名单就难维护，也很难在同一套维度上比较「谁更值得谈合作、谁更像对标账号」。
下面介绍 SkillHub 社区技能「抖音最具商业价值 KOL（对标账号）」（坐标 @user_bf931e31/douyin-kol-search，当前版本 1.0.3）。它把「按关键词 / 内容标签找 KOL、整理对标与合作线索」封装成 Agent 可读的 SKILL.md，并附带调用 AI Skills API 的 Python runner，适合在 Cursor、Claude Code、Codex 等支持 Skills 的环境里启用。
这是什么¶
一句话定位： 基于你提供的搜索关键词（及可选内容分类等参数），调用 AI Skills 侧能力，返回抖音创作者 / KOL 候选列表及商业价值相关字段，用于合作筛选与对标研究。
维护与来源： SkillHub 分类为 business-ops，来源为社区（发布者 user_bf931e31）。SkillHub 页面显示评分 100000、下载约 2476 次、安装 5 次；技能元数据标记 requires_api_key=true，运行前需配置 API Key。
解决的问题： 在「找值得合作的达人」「找同赛道对标 / 竞品账号」「按赛道缩小候选范围」等场景下，减少手工检索与零散笔记，把筛选条件和结果结构固定下来，便于 Agent 执行或脚本复现。
核心功能¶
结合官方 SKILL.md，已核实的能力包括：
- 关键词搜索 KOL：通过
keyword检索与业务相关的抖音达人（如美妆、美食、地域 + 品类组合等）。 - 内容标签筛选：通过
contentTag按赛道过滤（如美食对应tag-48）；标签枚举以技能内参数表为准。 - 分页：
page控制结果页码，默认从 1 开始。 - 结构化返回：结果中包含达人昵称、地域、粉丝量、互动率、转化 / 传播 / 星图类指数、预期播放、报价区间、内容标签等字段（具体以 API 实际返回为准）；文档中附有 JSON 示例结构。
- 交付导向的输出说明：技能明确交付「达人候选列表」「商业价值线索」「对标账号参考」，并给出结果过窄时放宽条件的建议。
- 双路径使用：在 Agent 中按技能说明对话触发；或通过技能包内
scripts/run.py直接请求 AI Skills API。
技能说明中示例还包含 followerRange（如 "10-100" 表示粉丝量级区间），可与关键词、内容标签组合使用；完整参数结构见包内 references/form-schema.json。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
先检查本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装文档执行完整安装或仅安装 CLI：
# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装本技能到当前 Agent 的 skills 目录¶
SkillHub 要求安装时使用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install @user_bf931e31/douyin-kol-search --dir <你的 Agent skills 目录>
常用路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/ - Claude Code：
~/.claude/skills/
也可将下面提示词发给 AI，让其按官方流程安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_bf931e31/douyin-kol-search`。
安装完成后，按你所用客户端要求重启或刷新 Skills 加载（以各客户端文档为准）。
3. 配置 AI Skills API（runner 或导出调用必填）¶
技能 front matter 要求环境变量 AISKILLS_API_KEY：在 AI Skills 官网 获取 API Key，用于运行导出的技能调用。
SKILL.md 中「运行前准备」还列出：
| 变量 | 说明 |
|---|---|
AISKILLS_API_KEY |
必填，认证调用 |
AISKILLS_BASE_URL |
默认 https://ai-skills.ai |
AISKILLS_TENANT_ID |
默认 default |
在技能包目录下导出示例：
export AISKILLS_API_KEY="你的_API_Key"
export AISKILLS_BASE_URL="https://ai-skills.ai"
典型用法¶
在 Agent 里使用¶
安装并配置 Key 后，在对话中说明业务目标（例如「找深圳烧烤酒吧赛道的对标账号」），并附上关键词、希望的赛道标签或粉丝量级。Agent 读取 SKILL.md 后，会按技能定义的参数与交付物组织查询与整理。
用 Python runner 直接调用¶
进入已安装技能目录（路径因 --dir 而异），在配置好 AISKILLS_API_KEY 后执行：
按赛道和粉丝范围筛选：
python3 scripts/run.py --params '{"keyword":"深圳烧烤酒吧","contentTag":"tag-48","followerRange":"10-100"}'
只按关键词搜达人：
python3 scripts/run.py --params '{"keyword":"深圳烧烤酒吧"}'
只按分类搜达人：
python3 scripts/run.py --params '{"contentTag":"tag-48"}'
form-schema.json 将 keyword 标为必填字段；若仅传 contentTag，是否与你的账号权限和 API 行为一致，请以实际调用结果为准。筛选过窄时，技能文档建议放宽粉丝量或关键词后再比较。
返回为 JSON；官方示例在 success 为 true 时包含 data.items 达人列表及 pagination、searchStrategy 等字段，便于判断是否触发降级筛选。
适用场景与注意¶
适合谁
- 内容创作者：找同赛道对标账号、学习内容结构。
- 运营与营销：按关键词和赛道拉合作达人 short list。
- 品牌方：在谈价前先看粉丝规模、互动与指数类字段，辅助优先级排序。
限制与注意
- 依赖 API Key 与计费：技能标记需 API Key，调用走 AI Skills 平台；用量与费用以 ai-skills.ai 说明为准。
- 数据与合规：结果用于研究与合作初筛，正式签约、报价与平台规则仍以抖音及星图等官方渠道为准。
- 参数与结果一致性：文档示例中的
followerRange、返回字段名以当前版本SKILL.md与 API 为准；升级技能后建议重新查看references/form-schema.json。 - 筛选策略：返回中的
searchStrategy（如usedFallback、droppedFilters）表示可能放宽了部分条件，解读名单时需一并查看。
结尾¶
「抖音最具商业价值 KOL（对标账号）」把「关键词 + 赛道标签找抖音达人、输出对标与合作线索」做成可安装的 Agent Skill，并保留 scripts/run.py 便于脚本化复现。若你已在用 Cursor、Claude Code 或 Codex 的 Skills 工作流，可按上文安装到对应 skills 目录并配置 AISKILLS_API_KEY 后试用。
- SkillHub 页面：https://www.skillhub.cn/skills/user_bf931e31/douyin-kol-search
- 技能 API 入口：https://api.skillhub.cn/user_bf931e31/douyin-kol-search
- 安装说明：https://skillhub.cn/install/skillhub.md
