前言¶
做抖音選題或競品觀察時，常見做法是打開 App 或第三方看板手工翻榜、記鏈接，再讓 AI 幫忙寫總結。榜單和樣本若不在同一條鏈路裏，對話裏容易缺可追溯的 ID、鏈接和指標，結論也難復盤。下面介紹 SkillHub 上的社區 Skill「抖音趨勢洞察」，它把抖音熱榜查詢和關鍵詞搜索接到 Agent 工作流裏，由模型按 SKILL 約定調用 CLI 或 MCP，輸出帶證據的結構化結果。
這是什麼¶
「抖音趨勢洞察」是面向 Agent 的 Skill，座標爲 @user_825d9e7e/douyin-trend-insights，當前版本 1.0.9，來源爲 community，分類爲 data-analysis，由發佈者 user_825d9e7e 維護。Skill 數據能力來自 SocialDataX（socialdatax-skills），需在環境中配置 SOCIALDATAX_API_KEY；SkillHub 頁面標註 requires_api_key=true。
當用戶需要做抖音趨勢洞察、熱點觀察、內容方向判斷、趨勢線索歸納或營銷靈感整理時，Agent 會按 SKILL 說明選用本 Skill，主要服務對象是內容運營、品牌調研和創作者。
核心功能¶
以下能力均來自該 Skill 的 SKILL.md 說明，爲只讀數據查詢，不涉及登錄、發帖或互動操作。
抖音熱榜¶
通過 douyin hot-search（或 MCP 工具 douyin_get_hot_search_list）獲取當前熱榜。該命令無必填參數，適合「先看平臺在推什麼話題」的場景。
關鍵詞搜索視頻/圖文¶
通過 douyin search --keyword <text>（或 MCP douyin_search_videos）按關鍵詞檢索內容，並可選用：
- 排序：
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
支持 --pages、--max-items 與 next_page_token 分頁；命令返回 JSON，字段包含 platform、tool、arguments、data，多頁時結果合併到 data.items。
輸出與協作方式¶
Skill 建議 Agent 把熱榜信號與關鍵詞搜索結果分開呈現，保留排名、標題、作者、鏈接或內容 ID、指標與發佈時間，便於用戶繼續追問或縮小範圍。本地需具備 Node.js、npm、npx，並安裝 npm 包 socialdatax-skills（Skill 元數據中的 install 依賴）。
安裝與啓用¶
方式一：讓 AI 按 SkillHub 文檔安裝¶
在 Cursor、Claude Code 等支持 Skills 的客戶端中，可將官方頁面給出的提示交給 Agent，讓其閱讀安裝說明並安裝指定座標：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_825d9e7e/douyin-trend-insights`。
方式二：使用 skillhub CLI¶
若本機已有 skillhub，安裝時需用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。Cursor 常用路徑爲 ~/.cursor/skills/；Claude Code 爲 ~/.claude/skills/；Codex 爲 ~/.codex/skills/ 或項目下的 .agents/skills/（完整列表見 SkillHub 安裝文檔）。
skillhub install douyin-trend-insights --namespace user_825d9e7e --dir ~/.cursor/skills/
未安裝 CLI 時，可按同一文檔通過官方安裝腳本安裝。
API Key 與環境變量¶
在 SocialDataX AI 頁面 申請或管理 API Key，並在運行環境中設置：
export SOCIALDATAX_API_KEY="你的密鑰"
Skill 不會在生成的文件裏寫入 Key；調用時使用用戶環境中的變量。
典型用法¶
能執行 shell 的 Agent 可優先走 direct CLI，無需單獨配置 MCP Server。下面兩條命令來自 Skill 官方示例，來源標記參數請保持與 Skill 一致。
查詢當前抖音熱榜：
npx -y socialdatax-skills@latest douyin hot-search \
--pretty --source-client socialdatax-skills --source-platform skillhub \
--source-skill douyin-trend-insights
按關鍵詞搜索（將 <keyword> 換成真實檢索詞）：
npx -y socialdatax-skills@latest douyin search \
--keyword "<keyword>" --pretty --source-client socialdatax-skills \
--source-platform skillhub --source-skill douyin-trend-insights
在對話中的典型流程可以是：先說明要看熱榜還是搜某個選題；若只想看樣本，先取 1 頁；需要更多結果時再按參數加 --pages 或 --max-items。若 Agent 已接入對應 MCP，也可調用 douyin_get_hot_search_list 或 douyin_search_videos，參數語義與 CLI 一致。
適用場景與注意¶
適合誰： 需要把抖音熱榜、關鍵詞搜索結果納入 Agent 對話的內容運營、品牌調研和創作者；希望輸出帶鏈接、ID 和指標、便於復盤的場景。
依賴與限制：
- 必須配置有效的
SOCIALDATAX_API_KEY；餘額不足（insufficient_balance）時不應反覆重試，應按錯誤信息中的充值指引處理。 - 依賴 Node/npm 與網絡；SDK 或 npx 拉包失敗屬於本地環境問題，Skill 說明不建議改用公開網頁搜索替代 SocialDataX 數據源。
- 只讀能力，不讀取本地瀏覽器數據，也不執行賬號寫操作。
- 分頁續查時須原樣傳遞完整的
next_page_token，不可截斷或改寫。
SkillHub 統計（以社區頁面抓取爲準）：評分 100000，下載 5002 次；安裝後若 Agent 未加載新 Skill，需按所用客戶端說明刷新或重啓。
結尾¶
「抖音趨勢洞察」把抖音熱榜與可篩選的關鍵詞搜索封裝成 Agent Skill，在統一對話裏完成趨勢觀察與樣本收集，並強調可追溯字段與只讀安全邊界。安裝與詳情見 SkillHub 官方頁：https://www.skillhub.cn/skills/user_825d9e7e/douyin-trend-insights；API 資源頁：https://api.skillhub.cn/user_825d9e7e/douyin-trend-insights。
