前言¶

做抖音內容運營或品牌調研時，常見做法是手動刷熱榜、逐條點開對標賬號、把互動數據抄進表格。公開頁面上能看到的視頻、作者作品、評論和熱榜，其實可以結構化拉取，但自建爬蟲要處理接口、限流和合規邊界，成本不低。下面介紹 SkillHub 社區 Skill「抖音競品智析器」（座標 @user_fb71c45d/douyin-jingpinzhixiqi，v1.0.0），把關鍵詞搜索、賬號作品、視頻評論和實時熱榜封裝成 Node.js 命令行腳本，供 Cursor 等 Agent 在對話中按場景調用。

這是什麼¶

「抖音競品智析器」是面向抖音公開數據的獲取與分析 Skill，由社區發佈者 user_fb71c45d 維護，在 SkillHub 上歸類爲 data-analysis，來源爲 community。官方簡介將其定位爲：在用戶需要做抖音內容研究、選題、熱點觀察、競品內容對比、趨勢判斷或素材整理時使用，主要面向內容運營、品牌調研和創作者。

運行依賴 Node.js（Skill 元數據要求 nodejs@16.14.0+），並通過環境變量 GUAIKEI_API_TOKEN 調用怪客（guaikei.com）提供的 API；SkillHub 標籤 requires_api_key=true 與此一致。SkillHub 頁面統計（截至資料抓取）：評分 100000，下載 2229 次，安裝計數 0。

核心功能¶

Skill 在 SKILL.md 中聲明四類能力，均通過 scripts/douyin/ 下 CLI 暴露：

1. 關鍵詞搜索（search-cli.js）：按關鍵詞檢索公開視頻，支持綜合排序、最多點贊、最新發布，以及時間範圍、視頻時長、條數上限（單次最多 10000 條）。
2. 抖人作品列表（post-cli.js）：根據用戶主頁 URL、sec_uid 或搜索結果中的 author_sec_uid 批量拉取已發佈作品。
3. 作品評論（comment-cli.js）：根據視頻 URL 或 aweme_id 獲取評論詳情，用於輿情與反饋分析。
4. 實時熱榜（hot-cli.js）：無參數調用，獲取平臺熱搜榜單，便於跟蹤熱點。

出參結構在 Skill 的 assets/*.schema.json 中按 JSON Schema draft-07 描述；執行結果會寫入技能目錄下的 logs 文件夾（文件名含時間戳及任務類型），便於二次分析或交給 Agent 彙總。

安裝與啓用¶

通過 SkillHub CLI 安裝¶

先確認本機已安裝 skillhub（安裝方式見 SkillHub 安裝文檔）。安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且 Agent 可能無法加載。

在 Cursor 中，skills 目錄一般爲 ~/.cursor/skills/。安裝命令示例：

skillhub install douyin-jingpinzhixiqi --namespace user_fb71c45d --dir ~/.cursor/skills/

也可將下面提示詞發給支持 SkillHub 的 AI，由其按官方安裝說明完成安裝：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_fb71c45d/douyin-jingpinzhixiqi`。

配置 API Token¶

在 怪客官網 開通 TOKEN 後，配置環境變量（未配置時運行會報無權限類錯誤）：

# Linux / macOS
export GUAIKEI_API_TOKEN=你的TOKEN

REM Windows
set GUAIKEI_API_TOKEN=你的TOKEN

安裝完成後，在 Skill 根目錄（例如 ~/.cursor/skills/@user_fb71c45d/douyin-jingpinzhixiqi）執行下文命令；若 Agent 已加載該 Skill，也可在對話中描述任務，由 Agent 代爲選擇對應 CLI 與參數。

典型用法¶

以下示例均來自 Skill 官方文檔，需在 Skill 安裝目錄下執行。

按關鍵詞搜索：

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

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

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

--sort 取值：0 綜合、1 最多點贊、2 最新發布；--time 可取 0（全部）、1（一天內）、7（七天內）、180（半年內）；--limit 默認 10，最大 10000。

抓取對標賬號公開作品：

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

在 Agent 側，可將需求表述爲自然語言任務，例如「搜索近 7 天關鍵詞『AI 模型』的抖音視頻並按最新排序」「拉取該用戶主頁最近 20 條作品」「導出某視頻評論用於輿情歸納」，由 Agent 映射到上述腳本及 --time、--limit 等參數。更完整的參數表見 Skill 內 references/options.md。

適用場景與注意¶

適合誰： 需要基於公開數據做選題、競品賬號對比、評論輿情歸納、熱榜跟進的運營與調研人員；希望把重複抓取交給 Agent 編排、自己專注解讀與策略的團隊。

限制與注意：

• 僅支持抖音公開內容，不包含私密或隱藏作品。
• 必須配置 GUAIKEI_API_TOKEN；TOKEN 需自行保管，避免泄露。
• 官方說明要求數據僅限個人或團隊內部使用，禁止違規分發。
• 搜索結果爲空時，可更換更常見的關鍵詞，或將 --time 設爲 0（全部時間）。
• 依賴第三方 API 與平臺規則，調用頻率、字段可用性以服務商與抖音側爲準。

結尾¶

「抖音競品智析器」把搜索、賬號作品、評論和熱榜四類公開數據能力收斂到同一套 Skill 與 CLI，適合掛在 Cursor 等 Agent 上做抖音內容研究與競品對比。安裝與座標以 SkillHub 爲準：

• 技能頁：https://www.skillhub.cn/skills/user_fb71c45d/douyin-jingpinzhixiqi
• API 入口（SkillHub 登記）：https://api.skillhub.cn/user_fb71c45d/douyin-jingpinzhixiqi