前言¶
做內容調研或競品觀察時，常見做法是在抖音 App 裏手動搜關鍵詞、翻推薦頁，再逐條抄標題、鏈接和互動數據。數據散在界面裏，很難按時間範圍篩一批結果，也不方便交給 Agent 做二次整理。
下面介紹 SkillHub 上的「抖音作品查詢」：在支持 Skills 的 AI 客戶端裏，用自然語言觸發搜索，把熱門作品以結構化表格返回，並支持按日期範圍篩選。
這是什麼¶
「抖音作品查詢」是社區來源（community）的 Agent Skill，座標爲 @user_5f9c21aa/douyin-search-pro，當前版本 1.0.3，SkillHub 分類爲 data-analysis。頁面標註作者爲 to the moon（紅狐數據）。
它面向「查抖音熱門/爆款作品數據」這一類任務：按關鍵詞檢索抖音熱門內容，可選日期範圍，結果以表格形式展示，便於對照、摘錄或繼續分析。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_5f9c21aa/douyin-search-pro
- API 入口（Skill 元數據）：https://api.skillhub.cn/user_5f9c21aa/douyin-search-pro
SkillHub 標籤包含 requires_api_key=true，使用前需按 Skill 內說明配置 API Key；具體環境變量或配置項以安裝後目錄中的 SKILL.md 爲準。
核心功能¶
以下能力均來自官方簡介與 SkillHub 頁面描述，未單獨列出的細節不作延伸。
- 關鍵詞搜索：根據用戶給出的關鍵詞，檢索抖音側的熱門、爆款類作品。
- 日期範圍篩選：可在查詢時限定時間區間，縮小樣本範圍。
- 結構化表格輸出：將命中作品整理爲表格，而不是零散段落，方便複製或下游處理。
- 自然語言觸發：在對話中使用官方列出的觸發詞即可喚起 Skill，例如「抖音作品查詢」「抖音爆款」「抖音熱門」「抖音熱榜」「抖音搜索」「爆款視頻」「熱門視頻」。
安裝與啓用¶
SkillHub 推薦通過 CLI 安裝到當前 Agent 的 skills 目錄；也可把安裝提示詞發給 AI，讓其按官方安裝文檔執行。
1. 檢查 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 安裝文檔執行完整安裝或僅安裝 CLI（文檔地址：https://skillhub.cn/install/skillhub.md）。
2. 安裝本 Skill¶
安裝時必須用 --dir 指向當前客戶端的 skills 目錄，否則默認落在 ./skills/，Agent 可能無法加載。
skillhub install @user_5f9c21aa/douyin-search-pro --dir <你的 skills 目錄>
常見路徑示例（以 SkillHub 安裝文檔爲準）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
若通過對話安裝，可將下面一句發給 AI，並指明你的 skills 目錄：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_5f9c21aa/douyin-search-pro`。
安裝完成後，按客戶端要求重啓或刷新 Skills，並依照 SKILL.md 完成 API Key 等配置（requires_api_key=true）。
典型用法¶
官方未提供獨立 CLI 示例子命令；典型路徑是在已啓用該 Skill 的對話裏說明意圖。下面示例僅複述官方能力描述，實際字段以 Skill 返回表格爲準。
- 直接說明關鍵詞與需求，例如：「用抖音作品查詢搜關鍵詞『減脂餐』，看最近熱門爆款。」
- 需要縮小時間窗口時，在同一句裏帶上日期範圍，例如：「抖音搜索『露營裝備』，只看 2026-09-01 到 2026-09-30 的作品，用表格列出來。」
- 使用觸發詞降低歧義，例如：「抖音熱榜相關：幫我查『AI 繪畫』的爆款視頻數據。」
Agent 應調用 Skill 背後的查詢能力，並將結果以表格呈現；若 Key 未配置或權限不足，需先按 SKILL.md 排查。
適用場景與注意¶
適合誰
- 需要在桌面工作流裏快速掃一批抖音熱門選題、對標賬號或爆款樣本的運營、產品、數據分析相關角色。
- 已在使用 Cursor、Claude Code、Codex 等支持 SkillHub Skills 的客戶端，希望少切換 App、多留在對話裏完成檢索。
使用注意
- 數據來自 Skill 對接的查詢服務，時效、字段完整度與平臺規則以實際返回爲準；不宜把單次表格結果當作唯一事實來源。
- 社區 Skill（community），升級與維護節奏取決於發佈者；SkillHub 頁面顯示版本 1.0.3，安裝前可用
skillhub查看是否有更新。 - SkillHub 統計（以抓取資料爲準）：評分 100000，下載 2725；安裝量等指標會變動，以頁面實時數據爲準。
- 涉及平臺內容與賬號數據時，請遵守抖音及相關服務的使用條款與合規要求。
結尾¶
「抖音作品查詢」把「搜關鍵詞 → 按日期篩 → 表格化結果」收進一個 Skill，適合在 Agent 對話裏做抖音熱門與爆款內容的快速摸底。安裝與優先源配置見 https://skillhub.cn/install/skillhub.md ；Skill 詳情見 https://www.skillhub.cn/skills/user_5f9c21aa/douyin-search-pro 。
