前言¶

做抖音內容運營或品牌調研時，常見做法是手動刷 App、截圖或零散複製鏈接，再整理成表格。熱點一過，對照賬號作品和評論的成本很高，也不利於在 Agent 對話裏直接出結論。

下面介紹 SkillHub 社區 Skill「抖音競品智析」（座標 @user_fb71c45d/douyin-jingpin-zhixi）。它把關鍵詞搜索、達人作品、視頻評論和實時熱榜封裝成可執行命令，由 Agent 按 SKILL.md 調用，適合需要結構化公開數據、而不是隻靠肉眼掃榜的場景。

這是什麼¶

「抖音競品智析」是面向抖音公開數據的獲取與分析 Skill，版本 1.0.0，來源爲 community，發佈者爲 user_fb71c45d，在 SkillHub 上歸類爲 data-analysis。

官方簡介：抖音公開數據智能獲取工具；適用於抖音內容研究、選題、熱點觀察、競品內容對比、趨勢判斷或素材整理，面向內容運營、品牌調研和創作者。

SkillHub 頁面標註 requires_api_key=true，運行前需配置第三方 API 憑證（見下文 GUAIKEI_API_TOKEN）。

核心功能¶

以下能力來自該 Skill 包內 SKILL.md 與配套腳本說明，經 skillhub install 安裝 @user_fb71c45d/douyin-jingpin-zhixi 後可覈對。

1. 關鍵詞搜索：按 --keyword 檢索視頻，支持綜合 / 最多點贊 / 最新發布排序（--sort 0/1/2），時間範圍（--time 0/1/7/180）、時長篩選（--duration）及 --limit（1–10000，默認 10）。
2. 達人作品列表：通過抖人主頁 URL 或 sec_uid（post-cli.js --url）批量拉取公開作品，用於對標賬號內容策略。
3. 作品評論：對視頻或圖文 URL / aweme_id 拉取評論（comment-cli.js），用於輿情與反饋方向梳理。
4. 實時熱榜：無參數運行 hot-cli.js，獲取平臺熱搜榜單，對應 Skill 側欄文案「實時掌握平臺熱點，快速響應熱門話題」。
5. 結果落盤：執行結果以 JSON 寫入技能目錄下 logs，便於二次分析或交給 Agent 彙總。

運行環境要求：本機已安裝 node（Skill 元數據標明 nodejs@16.14.0+），無需登錄個人抖音賬號即可拉取公開數據（Skill 文檔中的說明）。

安裝與啓用¶

安裝 SkillHub CLI¶

若尚未安裝 CLI，可先檢查版本；未安裝時按 SkillHub 安裝文檔執行完整安裝或僅 CLI：

command -v skillhub && skillhub --version

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-jingpin-zhixi --namespace user_fb71c45d --dir ~/.cursor/skills/

也可在對話中讓 AI 按官方提示安裝：參閱 https://skillhub.cn/install/skillhub.md，安裝 @user_fb71c45d/douyin-jingpin-zhixi。

配置 API Token¶

在 https://www.guaikei.com 開通 TOKEN 後，設置環境變量 GUAIKEI_API_TOKEN，否則腳本會報無權限類錯誤。示例：

export GUAIKEI_API_TOKEN=你的TOKEN

Windows 可使用 set GUAIKEI_API_TOKEN=你的TOKEN。安裝 Skill 後，在技能目錄內執行下列命令（路徑以你本機 ~/.cursor/skills/@user_fb71c45d/douyin-jingpin-zhixi 爲準）。

典型用法¶

進入已安裝的 Skill 根目錄後，Agent 或直接在本機可復現以下官方示例（佔位 URL 需換成真實鏈接）。

關鍵詞搜索（基礎）：

node scripts/douyin/search-cli.js --keyword "AI"

按點贊排序找高互動內容：

node scripts/douyin/search-cli.js --keyword "AI" --sort 1

近 7 天內的關鍵詞結果：

node scripts/douyin/search-cli.js --keyword "AI 模型" --time 7

拉取對標賬號公開作品：

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 等客戶端中，更常見的用法是用自然語言描述任務（例如「搜近一週 AI 教程高贊視頻並對比某賬號作品」），由 Agent 讀取 SKILL.md 後選擇對應 CLI 與參數。入參、出參還可對照技能內 assets/*_cli_*.schema.json（JSON Schema draft-07）。

適用場景與注意¶

適合誰

• 需要系統化做抖音選題、競品賬號對比、熱點跟蹤或評論輿情梳理的運營與調研人員。
• 希望在 Agent 工作流裏直接調用命令、導出 JSON 再生成報告的團隊。

限制與注意

• 僅支持公開數據，不包含私密或隱藏內容。
• 依賴 GUAIKEI_API_TOKEN 與 Guaikei 服務；Token 勿泄露，Skill 文檔要求數據限個人或團隊內部使用，禁止違規分發。
• 搜索結果爲空時，可換更常見的關鍵詞或將 --time 設爲 0（全部時間）；日誌文件名規則見 SKILL.md 常見問題一節。
• SkillHub 抓取信息（截至頁面展示）：評分 100000，下載 2217，安裝計數 0；以 SkillHub 實時頁面爲準。

結尾¶

「抖音競品智析」把抖音公開側的搜索、賬號作品、評論與熱榜收斂到同一套 Node 命令，便於在 Agent 裏做內容研究與競品觀察，而不必完全依賴手工刷榜。

官方入口：

• SkillHub：https://www.skillhub.cn/skills/user_fb71c45d/douyin-jingpin-zhixi
• API 座標頁：https://api.skillhub.cn/user_fb71c45d/douyin-jingpin-zhixi