前言¶
做教育類內容整理或競品調研時，常見做法是手動打開抖音、記筆記，或嘗試下載視頻再轉寫。前者費時且難結構化，後者往往觸及平臺規則，也未必能覆蓋畫面裏的板書與圖示。若目標只是「看懂這條視頻在教什麼、適合誰」，更需要的是頁面可見信息的抓取與歸納，而不是完整的音視頻管線。
下面介紹的 抖音智能分析工具（Skill 座標 @user_09d1a78f/douyin-analyzer）走另一條路徑：用 Chrome DevTools Protocol（CDP）控制本機已登錄的瀏覽器打開視頻頁，截圖後交給 Agent 的多模態能力生成 Markdown 報告。SkillHub 將其歸類爲 data-analysis，標籤標明 requires_api_key=false（Skill 本身不強制配置獨立 API Key；實際分析仍依賴當前 Agent 的多模態能力）。
這是什麼¶
抖音智能分析工具 是社區來源（community）的 Agent Skill，當前版本 1.0.0，由 SkillHub 用戶 user_09d1a78f 發佈；Skill 元數據中的作者署名爲 QClaw。官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_09d1a78f/douyin-analyzer
- API 座標頁：https://api.skillhub.cn/user_09d1a78f/douyin-analyzer
一句話定位：輸入抖音視頻鏈接 → CDP 打開頁面並截圖 → AI 多模態分析 → 輸出結構化教學內容報告。
核心功能¶
以下能力均來自 Skill 自帶的 SKILL.md / README.md 說明，並與包內 scripts/analyze.js 設計一致。
| 能力 | 說明 |
|---|---|
| 鏈接解析 | 支持抖音短鏈接與完整 douyin.com/video 鏈接 |
| CDP 控制瀏覽器 | 連接本機 Edge/Chrome 遠程調試端口（默認 28800） |
| 頁面截圖 | 保存視頻頁截圖，供後續分析 |
| 多模態分析 | 直接基於截圖理解畫面內容，文檔說明無需單獨 OCR 流程 |
| 知識點與報告 | 提取教學知識點、適用人羣、質量評分等，生成 summary-{timestamp}.md |
明確不支持（Skill 文檔中的 exclude_when 與限制說明）：視頻文件下載、音頻提取、剪輯；當前版本也不支持批量分析。
依賴：文檔要求另行安裝 xbrowser（openclaw skills install xbrowser）；agent-browser 爲可選。工作流依賴 Node.js 腳本 scripts/analyze.js。
觸發關鍵詞（便於在對話中喚起 Skill）：分析抖音視頻、抖音視頻內容、視頻知識點提取、教學內容分析、抖音鏈接分析。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
官方安裝說明見 https://skillhub.cn/install/skillhub.md。先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時可執行完整安裝腳本（文檔推薦）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 將 Skill 裝到當前 Agent 的 skills 目錄¶
SkillHub 要求安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認落在 ./skills/ 可能無法被加載。社區 Skill 需帶命名空間安裝：
skillhub install douyin-analyzer --namespace user_09d1a78f --dir <你的 skills 目錄>
常見路徑（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
也可在對話中讓 Agent 按官方提示安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_09d1a78f/douyin-analyzer`。
3. OpenClaw 側依賴（按 Skill 文檔）¶
若運行環境基於 OpenClaw，需先安裝 xbrowser：
openclaw skills install xbrowser
4. 環境變量（可選）¶
| 參數 | 默認值 | 說明 |
|---|---|---|
CDP_HOST |
127.0.0.1 |
CDP 地址 |
CDP_PORT |
28800 |
遠程調試端口 |
SCREENSHOT_DIR |
douyin-screenshots |
截圖目錄名 |
REPORT_DIR |
douyin-screenshots |
報告目錄名 |
WORKSPACE |
文檔示例爲 OpenClaw workspace | 工作區根路徑 |
示例：
export CDP_PORT=9222
export WORKSPACE="$HOME/.openclaw/workspace"
典型用法¶
先做 瀏覽器遠程調試，再執行分析。官方 SKILL.md 以 Windows Edge 爲例；Linux/macOS 上可用 Chrome/Chromium，等價增加 --remote-debugging-port=28800（或與環境變量 CDP_PORT 一致）。
步驟一：啓動帶 CDP 的瀏覽器
taskkill /IM msedge.exe /F
"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --remote-debugging-port=28800
建議在調試瀏覽器中已登錄抖音，以減少跳轉登錄頁的情況。
步驟二：分析視頻
douyin-analyzer "https://v.douyin.com/Mo6r--OixXQ/"
或在 Skill 目錄下直接調用腳本：
node scripts/analyze.js "https://www.douyin.com/video/7497104894491905307"
步驟三：查看輸出
文檔默認將截圖與報告寫在 workspace 下的 douyin-screenshots（示例路徑爲 C:\Users\zhuyi\.openclaw\workspace\douyin-screenshots\）。包內 examples/sample-analysis.md 展示了報告結構：視頻信息、知識點識別、適用人羣、教學質量評分與文字總結。
在 Cursor 等環境中，也可直接發送抖音鏈接並說明「分析抖音視頻」「教學內容分析」等觸發語，由 Agent 按 Skill 流程調用 CDP 與多模態分析。
適用場景與注意¶
適合誰
- 需要快速歸納教育類抖音視頻的知識點與受衆，而不是留存視頻文件
- 已有本機瀏覽器登錄態，能接受 CDP 調試方式
- Agent 具備多模態識圖能力（示例分析中註明模型爲
qclaw/pool-hy3-preview，實際以你所用客戶端爲準）
限制與常見坑
- 僅視覺分析，不處理音頻；畫面外的講解無法從音軌還原。
- 單條鏈接分析，無官方批量接口。
- CDP 未啓動或端口不一致會出現
Unable to connect to CDP port 28800；頁面未渲染完可能導致黑屏截圖。 - 抖音反爬可能導致登錄頁：需保證 CDP 連接的瀏覽器會話已登錄。
- 未安裝 xbrowser 時可能出現
Cannot find module 'xbrowser'。 - SkillHub 頁面統計（以抓取資料爲準）：評分 100000，下載約 771 次，安裝約 12 次；與第三方轉載數據可能不一致，以 SkillHub 爲準。
結尾¶
抖音智能分析工具把「打開鏈接 → 截圖 → 結構化教學報告」收成一條 Agent Skill 流水線，適合教研筆記、自學復盤與內容調研。安裝與座標以 SkillHub 爲準：https://www.skillhub.cn/skills/user_09d1a78f/douyin-analyzer 。
