一个用于 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 会自动触发并执行以下流程：

1. 下载视频字幕/音频
2. 提取或转录文本
3. 生成结构化总结

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