一个用于 Claude Code 的视频总结 Skill，支持自动下载 YouTube 和 B站视频，提取字幕或语音转文字，生成结构化的内容总结。
- 多平台支持: YouTube、哔哩哔哩 (B站)
- 智能字幕提取: 优先获取官方字幕/CC 字幕
- 语音转文字: 无字幕时使用 Whisper (本地或 API) 转录
- 时间戳标注: 转录内容带时间戳，便于定位
- 结构化总结: 自动生成 Markdown 格式的视频总结
- 问答支持: 基于视频内容进行问答
# macOS
brew install yt-dlp ffmpeg
# Python 依赖
pip install openai
# 可选：本地 Whisper（推荐，无需 API）
pip install openai-whisper
将此仓库克隆到 Claude Code skills 目录：
# 个人全局 skill
git clone https://github.com/nothinginterested/video-summarizer-skill.git ~/.claude/skills/video-summarizer
# 或项目级 skill
git clone https://github.com/nothinginterested/video-summarizer-skill.git .claude/skills/video-summarizer
如果使用 OpenAI Whisper API：
export OPENAI_API_KEY="your-api-key"
在 Claude Code 中直接输入：
总结这个视频 https://www.youtube.com/watch?v=xxxxx
帮我归纳这个 B站教程的方法 https://www.bilibili.com/video/BVxxxxx
这个视频讲了什么？[URL]
Skill 会自动触发并执行以下流程：
- 下载视频字幕/音频
- 提取或转录文本
- 生成结构化总结
video-summarizer/
├── SKILL.md # Skill 核心定义
├── README.md # 说明文档
├── scripts/
│ ├── download.py # 视频/字幕下载
│ ├── extract_subtitles.py # 字幕解析
│ ├── transcribe.py # Whisper 转录
│ ├── setup_check.py # 依赖检查
│ └── utils.py # 工具函数
├── references/
│ ├── prompt_templates.md # 总结模板
│ └── platform_notes.md # 平台说明
├── assets/ # 资源文件
└── output/ # 临时输出（已忽略）
部分 B站视频需要登录才能获取字幕，有两种解决方案：
方案 1: 自动读取浏览器 cookies
python3 scripts/download.py --url "URL" --cookies-from-browser chrome
方案 2: 手动导出 cookies 文件到 assets/cookies/bilibili.txt
默认总结保存到 ~/lzz/video-summaries/，可在 SKILL.md 中修改路径。
| 依赖 | 用途 | 必需 |
|---|---|---|
| yt-dlp | 视频/字幕下载 | 是 |
| ffmpeg | 音频处理 | 是 |
| openai | Whisper API | 可选 |
| openai-whisper | 本地转录 | 可选 |
MIT
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
