前言¶
做抖音競品或同賽道調研時，常見做法是手動翻 App、截圖或零散複製鏈接，很難在 Agent 對話裏一次性拿到可對比的結構化結果。下面介紹 SkillHub 社區 Skill「抖音數據洞察」（座標 @user_fb71c45d/douyin-data-insight）：在配置好數據接口 Token 後，由 Agent 按 SKILL.md 調用內置 Node.js CLI，完成關鍵詞搜索、賬號作品、視頻評論與實時熱榜等查詢，並把結果寫入技能目錄下的 JSON 日誌，便於後續分析。
這是什麼¶
「抖音數據洞察」是面向品牌、MCN、內容運營與創作者的 data-analysis 類 Agent Skill，版本 1.0.0，來源爲 SkillHub community，發佈者爲 user_fb71c45d。官方頁面：SkillHub - 抖音數據洞察；API 入口：https://api.skillhub.cn/user_fb71c45d/douyin-data-insight。
Skill 的觸發描述寫明：當用戶需要做抖音競品研究、競品分析、同賽道觀察、內容角度對比、內容策略對比或品牌內容調研時使用。運行依賴 Node.js 16.14.0+，並需環境變量 GUAIKEI_API_TOKEN（SkillHub 標籤 requires_api_key=true）。Token 需在 guaikei.com 開通，與抖音賬號登錄無關，僅用於調用背後數據 API。
核心功能¶
Skill 通過四條 CLI 封裝公開數據能力（入參、出參在 assets/*.schema.json 中按 JSON Schema draft-07 定義）：
- 關鍵詞搜索（
scripts/douyin/search-cli.js）：按關鍵詞檢索視頻，支持綜合排序、最多點贊、最新發布，以及時間範圍、時長、條數上限（單次最多 10000 條）。 - 抖人作品（
scripts/douyin/post-cli.js）：傳入用戶主頁 URL 或sec_uid，批量拉取已發佈公開作品。 - 作品評論（
scripts/douyin/comment-cli.js）：傳入視頻 URL 或aweme_id，獲取評論詳情。 - 實時熱榜（
scripts/douyin/hot-cli.js）：無參數，獲取抖音熱搜榜單。
執行成功後，結果默認歸檔到技能目錄下的 logs 文件夾（文件名含時間戳與任務類型），便於導出或二次分析。Skill 說明中強調：僅抓取公開數據，不支持私密或隱藏內容；數據限個人或團隊內部使用，禁止違規分發。
安裝與啓用¶
安裝 SkillHub CLI¶
若本機尚未安裝 skillhub，可先檢查版本：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔 執行完整安裝：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能無法被識別。在 Cursor 中常用路徑爲 ~/.cursor/skills/。
skillhub install douyin-data-insight --namespace user_fb71c45d --dir ~/.cursor/skills/
也可讓 AI 按官方提示安裝：參閱 https://skillhub.cn/install/skillhub.md，安裝 @user_fb71c45d/douyin-data-insight。
配置 API Token¶
在技能根目錄執行 CLI 前，先設置 GUAIKEI_API_TOKEN：
export GUAIKEI_API_TOKEN=你的TOKEN
Windows 可使用 set GUAIKEI_API_TOKEN=你的TOKEN。Token 在 guaikei.com 申請，請勿泄露。
典型用法¶
以下示例均來自 Skill 自帶的 SKILL.md 與 references/options.md，需在已安裝技能的目錄下執行。
關鍵詞搜索（默認綜合排序，默認返回 10 條）：
node scripts/douyin/search-cli.js --keyword "AI"
按最多點贊排序，用於對標高贊內容：
node scripts/douyin/search-cli.js --keyword "AI" --sort 1
限定半年內、按最新發布，並拉取 20 條：
node scripts/douyin/search-cli.js --keyword "AI 教程" --sort 2 --time 180 --limit 20
（--time 取值：0 全部、1 一天內、7 七天內、180 半年內；--sort：0 綜合、1 最多點贊、2 最新發布。）
抓取指定抖人主頁作品：
node scripts/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx"
獲取單條視頻評論：
node scripts/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx"
獲取實時熱榜：
node scripts/douyin/hot-cli.js
在 Cursor 等支持 Skills 的客戶端裏，用自然語言描述「競品賬號」「關鍵詞」「時間範圍」等意圖即可；Agent 應讀取本 Skill 後選擇對應腳本與參數。更完整的選項表見技能內 references/options.md。
適用場景與注意¶
適合： 需要結構化抖音公開數據的選題調研、競品作品對比、評論輿情粗讀、熱榜跟題，以及需要 JSON 日誌落盤再做報表的團隊。
限制與注意：
- 無有效
GUAIKEI_API_TOKEN時會報權限類錯誤，必須先完成開通與配置。 - 搜索無結果時可換更常見的關鍵詞，或將
--time設爲0（全部時間）。 - 依賴第三方 API 與網絡，配額、計費與穩定性以 guaikei 服務條款爲準；Skill 本身不替代合規審查，對外發布內容仍需遵守平臺與數據使用規範。
- SkillHub 頁面統計（截至資料抓取）：評分 100000，下載 2688 次；安裝後若 CLI 未出現在 Agent 技能列表，請確認
--dir路徑並重啓或重新加載客戶端。
結尾¶
「抖音數據洞察」把抖音公開側的搜索、賬號作品、評論與熱榜查詢收斂成一套可複用的 Skill 與 Node CLI，適合在 Agent 工作流裏做競品與同賽道分析。需要安裝或更新時，以上文座標在 SkillHub 檢索即可。
官方地址：https://www.skillhub.cn/skills/user_fb71c45d/douyin-data-insight
