前言¶
做內容調研或競品觀察時，往往要在抖音裏按關鍵詞翻作品，再手工記下標題、鏈接和發佈時間。瀏覽器裏一頁頁點，很難一次性按時間範圍收口，也不方便把結果交給表格或後續分析。下面介紹 SkillHub 上的 抖音關鍵詞作品查詢（@redfox-data/douyin-search-v2），讓 Agent 在對話裏按關鍵詞拉取作品，並按日期篩選後以結構化表格呈現。
這是什麼¶
抖音關鍵詞作品查詢 是紅狐數據在 SkillHub 發佈的 enterprise 來源 Skill，當前版本 1.0.4，分類爲 data-analysis。官方定位是抖音作品查詢工具：根據關鍵詞搜索抖音熱門、爆款類作品，支持按日期範圍篩選，結果以結構化表格展示。
- Skill 座標：
@redfox-data/douyin-search-v2 - SkillHub 頁面：https://www.skillhub.cn/skills/redfox-data/douyin-search-v2
- 技能包地址：https://api.skillhub.cn/redfox-data/douyin-search-v2
頁面標註 requires_api_key=true，使用前需按 Skill 說明配置 API Key（具體字段以安裝後的 SKILL.md 爲準）。
核心功能¶
以下能力均來自官方簡介，未在資料中出現的接口或字段不寫。
- 關鍵詞搜索：輸入搜索詞，檢索與之相關的抖音作品，側重熱門、爆款方向的內容發現。
- 日期範圍篩選：在關鍵詞結果上按時間窗口收窄，便於看某一階段的上榜或爆發內容。
- 結構化表格輸出：查詢結果以表格形式展示，便於複製、對比或接入後續數據處理。
- 對話觸發：當用戶表達「查抖音熱門」「搜爆款視頻」等意圖時，Agent 可掛載本 Skill 執行。官方列出的觸發詞包括：抖音作品查詢、抖音爆款、抖音熱門、抖音熱榜、抖音搜索、爆款視頻、熱門視頻。
安裝與啓用¶
Skill 遵循通用 SKILL.md 格式。安裝方式以 SkillHub 頁面與安裝文檔爲準。
方式一：讓 Agent 按官方指引安裝¶
在支持 Skill 的客戶端裏，可將下面意圖發給 AI（SkillHub 頁面提供的安裝提示）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@redfox-data/douyin-search-v2`。
Agent 會按 SkillHub 安裝與優先源配置 檢查 CLI、選擇 skills 目錄並完成安裝。
方式二：使用 skillhub CLI¶
若本機已有 skillhub，可直接安裝到當前 Agent 的 skills 目錄（必須使用 --dir，否則默認落在 ./skills/ 且可能不被識別）：
command -v skillhub && skillhub --version
未安裝 CLI 時，安裝文檔給出的完整安裝命令爲：
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
安裝 Skill（將 <skills 目錄> 換成當前環境路徑）：
skillhub install @redfox-data/douyin-search-v2 --dir <skills 目錄>
常見客戶端 skills 目錄（摘自安裝文檔）：
| 客戶端 | 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝後按客戶端要求刷新或重啓，使 Skill 被加載；若 Skill 要求 API Key，在對應配置或環境變量中補齊後再查詢。
典型用法¶
官方未單獨給出命令行示例，用法以對話爲主：在已啓用本 Skill 的 Agent 中說明關鍵詞，必要時補充起止日期，並說明需要表格化結果。
示例表述（意圖與官方觸發詞一致，可按需改寫）：
- 「用抖音作品查詢，關鍵詞
露營裝備，最近 7 天的熱門作品，表格列標題和鏈接。」 - 「抖音搜索
減脂餐，日期範圍 2026-10-01 到 2026-10-15，爆款視頻列表。」 - 「查抖音熱榜相關詞
雙十一預售的作品數據，按日期篩一下。」
經過上面的步驟，Agent 應調用 Skill 內定義的能力返回結構化表格；若因未配置 API Key 或網絡限制失敗，以 Skill 文檔與 SkillHub 頁面說明爲準排查。
適用場景與注意¶
適合誰
- 需要按詞做抖音內容樣本採集、熱點觀察的運營、分析或研發同學。
- 希望在 IDE / 對話環境裏完成查詢，而不是單獨開腳本或第三方面板的人。
使用注意
- 本 Skill 標記 requires_api_key=true，未配置密鑰時通常無法完成查詢。
- 來源爲 enterprise，使用條款、配額與數據範圍以紅狐數據及 SkillHub 公示爲準。
- SkillHub 統計（以抓取資料爲準）：評分 100000，下載 5688，安裝 1；僅作商店熱度參考，不代表查詢結果實時性或覆蓋全站。
- 抖音內容與平臺規則會變化，日期篩選與「熱門」「爆款」口徑以 Skill 實際返回字段爲準，不宜直接當作官方榜單唯一依據。
結尾¶
抖音關鍵詞作品查詢 把「關鍵詞 + 可選日期 + 表格結果」收進一個 data-analysis 類 Skill，適合在 Agent 對話裏快速拉一批抖音作品做對照。安裝與座標見 SkillHub：https://www.skillhub.cn/skills/redfox-data/douyin-search-v2 ，技能包：https://api.skillhub.cn/redfox-data/douyin-search-v2 。
