前言¶
做教育类内容整理或竞品调研时，常见做法是手动打开抖音、记笔记，或尝试下载视频再转写。前者费时且难结构化，后者往往触及平台规则，也未必能覆盖画面里的板书与图示。若目标只是「看懂这条视频在教什么、适合谁」，更需要的是页面可见信息的抓取与归纳，而不是完整的音视频管线。
下面介绍的 抖音智能分析工具（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 。
