前言¶
做抖音方向的內容調研時，常見做法是手動刷 App、截圖或抄鏈接，再整理成表格。關鍵詞一換、時間範圍一縮，就要重複一輪。若希望把「查熱榜、按詞搜作品、區分視頻與圖文」交給 coding Agent 在對話裏完成，需要一套可讀寫的 Skill 約定，以及能返回結構化結果的接口。
下面介紹 SkillHub 上的 抖音數據分析 SocialDataX 視頻搜索（座標 @user_825d9e7e/socialdatax-douyin-search，當前版本 1.0.3）。它由社區發佈者 user_825d9e7e 維護，數據能力來自 SocialDataX 社媒數據助手，分類爲 data-analysis，頁面標註 requires_api_key=true。
這是什麼¶
一句話定位：在 Agent 中通過 SocialDataX 讀取抖音主站熱榜，並按關鍵詞檢索作品（含圖文），用於數據分析、內容調研與趨勢觀察。
與「只教模型泛泛談抖音運營」不同，該 Skill 在 SKILL.md 中寫明優先走 socialdatax-skills 命令行或已配置的 MCP 工具，輸出 JSON，便於後續彙總與對比。Skill 聲明爲只讀：不讀本地瀏覽器數據、不保存 API Key、不執行登錄或互動類操作。
核心功能¶
以下能力均來自官方簡介與包內 SKILL.md，僅覆蓋本 Skill 聲明的範圍。
- 抖音熱榜：調用主站熱榜列表，無需查詢參數。
- 作品 / 關鍵詞搜索：按
--keyword檢索作品，支持分頁與多種篩選。 - 圖文搜索：通過
--content-type image等參數限定內容類型；結果中的images字段用於圖文類條目。 - 檢索維度（可選）：排序（綜合 / 最新 / 點贊）、發佈時間範圍、時長區間、內容類型（全部 / 視頻 / 圖文）。
若 Agent 環境已接入 SocialDataX MCP，Skill 還指向對應工具名：douyin_get_hot_search_list（熱榜）、douyin_search_videos（關鍵詞搜索，含分頁與篩選字段）。
安裝與啓用¶
前置條件¶
- 本機需有 Node.js 與 npm（Skill 元數據
requires.bins要求）。 - 數據調用需環境變量
SOCIALDATAX_API_KEY。申請與管理入口以官網爲準：https://socialdatax.com/?from=skillhub。
通過 SkillHub 安裝¶
官方頁面給出的安裝提示爲：讓 AI 參照 SkillHub 安裝文檔，安裝指定座標。
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_825d9e7e/socialdatax-douyin-search`。
若已安裝 skillhub CLI，可將 Skill 裝到當前 Agent 的 skills 目錄（須使用 --dir，否則默認落在 ./skills/ 且可能不被識別）。SkillHub 文檔中的常見路徑示例：
- Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/ - Claude Code：
~/.claude/skills/
示例命令（將 <skills 目錄> 替換爲上述路徑之一）：
skillhub install @user_825d9e7e/socialdatax-douyin-search --dir <skills 目錄>
CLI 未安裝時，可按 https://skillhub.cn/install/skillhub.md 中的腳本安裝 skillhub。
運行時依賴¶
Skill 元數據聲明通過 npm 包 socialdatax-skills 提供直連 CLI；日常調用可用 npx 拉取最新版，無需單獨全局安裝該包。
典型用法¶
Skill 建議優先使用直連 CLI（無需單獨配 MCP）。先配置 API Key，再執行查詢。
export SOCIALDATAX_API_KEY="<你的密鑰>"
熱榜（無額外參數）：
npx -y socialdatax-skills@latest douyin hot-search --pretty
關鍵詞作品搜索（將關鍵詞換成你的調研主題）：
npx -y socialdatax-skills@latest douyin search --keyword "露營" --pretty
帶篩選的搜索（示例：近一週、按點贊排序、僅視頻；參數名與取值以 Skill 文檔爲準）：
npx -y socialdatax-skills@latest douyin search \
--keyword "露營" \
--publish-time-range week \
--sort-type like_count_descending \
--content-type video \
--pretty
翻頁時把上一頁返回的 next_page_token 傳給 --page-token；Skill 說明在 token 非空時應繼續請求，不要僅因單頁 items 爲空就停止。
在 Cursor 等客戶端中，安裝 Skill 後可直接用自然語言描述意圖，例如「拉取抖音熱榜並列出前十條關鍵詞」或「搜索關鍵詞 X，要近 7 天發佈的視頻，按點贊排序」。Agent 會按 SKILL.md 選擇 CLI 或 MCP，並按要求區分事實字段與解讀。
輸出整理時，熱榜側重排名、關鍵詞、熱度及關聯內容；搜索側重可溯源字段（內容 ID、URL、標題/描述、作者、互動與發佈時間、content_type 等）。
適用場景與注意¶
適合誰
- 需要在對話裏快速看抖音熱榜、做關鍵詞掃盤的內容運營與研究員。
- 做競品樣本收集、趨勢掃描，希望結果可結構化落表或進下游分析腳本的同學。
- 已在用 SocialDataX 其他抖音類 Skill（如作品詳情），希望與搜索、熱榜能力組合使用的團隊。
限制與注意
- 調用消耗 SocialDataX 賬戶額度，需自行在官網管理 Key 與計費；本文不描述具體價格。
- 依賴外網與
npx拉包；沙箱或離線環境需提前放行。 - SkillHub 頁面統計（截至資料抓取）：評分 100000，下載 2364；安裝後若 Agent 未加載新 Skill，需按各客戶端說明刷新或重啓。
- 僅覆蓋 Skill 聲明的 hot search 與 work search；用戶主頁、評論、轉寫等屬於同生態其他能力，不在本 Skill 正文範圍內。
結尾¶
抖音數據分析 SocialDataX 視頻搜索把抖音熱榜與關鍵詞作品檢索封裝成 Agent 可執行的 Skill：配置 SOCIALDATAX_API_KEY，經 SkillHub 安裝 @user_825d9e7e/socialdatax-douyin-search，即可在對話或終端用 douyin hot-search / douyin search 拿到可整理的 JSON 結果。
官方入口：
