前言¶
做抖音投放或內容對標時，常見做法是手工搜賬號、翻星圖、把粉絲數和報價抄進表格。賽道一多、關鍵詞一變，名單就難維護，也很難在同一套維度上比較「誰更值得談合作、誰更像對標賬號」。
下面介紹 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
