前言¶

做抖音內容時，選題往往卡在「不知道搜什麼、結果散在網頁裏、難和 AI 一起往下拆」。常見做法是手動刷熱榜、複製標題到文檔，再讓模型憑記憶發揮——樣本不可追溯，角度也容易偏。下面介紹 SkillHub 上的 抖音選題分析（@user_825d9e7e/douyin-topic-analysis）：把選題策劃、爆款角度拆解和素材整理寫成 Agent 可執行的 Skill，通過 SocialDataX 的只讀接口拉取抖音搜索與熱榜數據，輸出可復盤的標題、作者、鏈接或內容 ID。

這是什麼¶

抖音選題分析 是社區來源（community）的內容創作類 Skill，當前版本 1.0.9，座標 @user_825d9e7e/douyin-topic-analysis，由發佈者 user_825d9e7e 維護；底層能力來自 socialdatax-skills，在 SkillHub 分類爲 content-creation，並標註 requires_api_key=true。

當用戶需要做抖音選題、短視頻選題策劃、爆款角度拆解、內容方向規劃或選題素材整理時，Agent 會按 SKILL.md 引導：先確認關鍵詞或選題方向，再調用 CLI 或 MCP 取數，最後按 Skill 要求整理樣本與可追問角度。面向內容運營、品牌調研和創作者。

核心功能¶

以下能力均來自已安裝的 Skill 包（v1.0.9）中的 SKILL.md：

1. 關鍵詞搜索：douyin search --keyword <text>，支持排序、發佈時間、時長、內容類型等篩選，並可分頁（--pages、--page-token、--max-items）。
2. 熱榜：douyin hot-search，無需關鍵詞，用於查看當前熱榜排名與熱度信號。
3. 結構化返回：命令輸出 JSON，含 platform、tool、arguments、data；多頁搜索會合併到 data.items，並附帶 page_count、item_count 及下一頁標記。
4. 輸出規範：Skill 要求把「可見證據」與「判斷」分開寫，保留標題、作者、鏈接或 ID、指標與發佈時間；圖文結果使用返回的 images 字段。
5. MCP 可選路徑：與 CLI 對應的工具包括 douyin_search_videos；熱榜對應 douyin_get_hot_search_list（調用時不傳關鍵詞參數）。
6. 安全邊界：只讀；使用環境變量 SOCIALDATAX_API_KEY，不登錄、不發帖、不點贊、不評論，也不讀取本地瀏覽器數據。

運行依賴 Node.js、npm/npx，以及已配置的 SOCIALDATAX_API_KEY。API Key 在 SocialDataX AI 頁面 申請與管理。

安裝與啓用¶

方式一：讓 Agent 按官方指引安裝¶

將下面提示詞發給支持 Skill 的 AI（安裝步驟以 SkillHub 文檔爲準）：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_825d9e7e/douyin-topic-analysis`。

方式二：SkillHub CLI¶

先確認本機已安裝 skillhub（未安裝時可參考 SkillHub 安裝文檔 執行 curl 安裝腳本）。安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。

command -v skillhub && skillhub --version

skillhub install @user_825d9e7e/douyin-topic-analysis --dir ~/.cursor/skills/

常用路徑（摘自 SkillHub 安裝文檔）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

安裝後配置 API Key（變量名固定爲 SOCIALDATAX_API_KEY）：

export SOCIALDATAX_API_KEY="你的密鑰"

Skill 元數據會通過 npm 包 socialdatax-skills 拉取 CLI 能力；具體依賴以 Skill 內 metadata.openclaw.install 爲準。

典型用法¶

1. 按關鍵詞搜樣本（先看一頁）¶

適合「有一個方向，想先看相關標題和賬號」。在能執行 shell 的 Agent 環境中，優先使用 direct CLI：

npx -y socialdatax-skills@latest douyin search \
  --keyword "職場穿搭" --pretty \
  --source-client socialdatax-skills \
  --source-platform skillhub \
  --source-skill douyin-topic-analysis

Skill 建議：若只想先看樣本，先取 1 頁；需要擴大範圍時再使用 --pages 或 --max-items。

2. 帶篩選的搜索¶

例如按點贊排序、只看一週內發佈的視頻：

npx -y socialdatax-skills@latest douyin search \
  --keyword "減脂餐" \
  --sort-type like_count_descending \
  --publish-time-range week \
  --content-type video \
  --pretty \
  --source-client socialdatax-skills \
  --source-platform skillhub \
  --source-skill douyin-topic-analysis

排序可選：general、time_descending、like_count_descending。發佈時間：all、day、week、half_year。時長：all、under_1_minute、one_to_five_minutes、over_5_minutes。內容類型：all、video、image。

3. 查看熱榜¶

用戶要看當前抖音熱榜時，使用熱榜命令（不需要 --keyword）：

npx -y socialdatax-skills@latest douyin hot-search \
  --pretty \
  --source-client socialdatax-skills \
  --source-platform skillhub \
  --source-skill douyin-topic-analysis

4. 在對話裏怎麼用¶

向 Agent 描述真實意圖即可，例如：「幫我做抖音選題，關鍵詞是『新手化妝』，先看 20 條高贊視頻標題和賬號。」Agent 在啓用本 Skill 後應配置 SOCIALDATAX_API_KEY，按 Skill 調用搜索或熱榜，並輸出可復盤列表與下一步可追問的問題（如收窄人羣、補品牌或時間範圍）。

適用場景與注意¶

適合誰：需要把抖音選題調研嵌進 AI 工作流的內容運營、品牌調研和創作者；希望結果帶鏈接、內容 ID 和指標，而不是純模型臆測。

限制與注意：

• 必須自備 SocialDataX API Key；餘額不足（insufficient_balance）時 Skill 要求展示充值鏈接並勿反覆重試。
• 搜索不支持「一次取全量」的 --all；翻頁需原樣傳遞完整的 next_page_token，不能截斷或改寫。
• CLI 退出碼爲 1 且 partial: true 時，表示結果不完整，應按 Skill 中的續頁規則恢復，而非盲目從第一頁重跑。
• 本地需可用的 Node.js/npm；SDK 或網絡問題屬於運行環境問題，Skill 說明不應改用公開網頁搜索替代 SocialDataX 數據。
• SkillHub 頁面統計（截至資料抓取）：評分 100000，下載 8431；標籤標明需要 API Key。實際計費與配額以 SocialDataX 官網爲準。

結尾¶

抖音選題分析 把「搜什麼、怎麼篩、怎麼留證據」寫進 Agent Skill，用 douyin search 與 douyin hot-search 對接只讀數據，適合短視頻選題策劃和爆款角度拆解前的樣本收集。安裝與詳情見 SkillHub：

• 頁面：https://www.skillhub.cn/skills/user_825d9e7e/douyin-topic-analysis
• 座標鏈接：https://api.skillhub.cn/user_825d9e7e/douyin-topic-analysis