video-summarizer-skill

KO | EN

gitlite — search

#python #hacktoberfest #ai #go #golang #rust #docker #windows #awesome #cli #kubernetes #awesome-list #mcp #open-source

video-summarizer-skill

(★ 13)

Claude Code Skill: 下载并总结 YouTube/B站视频内容

video-summarizer-skill Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Video Summarizer - Claude Code Skill

一个用于 [Claude Code](https://claude.ai/claude-code) 的视频总结 Skill，支持自动下载 YouTube 和 B站视频，提取字幕或语音转文字，生成结构化的内容总结。

## 功能特点

- **多平台支持**: YouTube、哔哩哔哩 (B站)
- **智能字幕提取**: 优先获取官方字幕/CC 字幕
- **语音转文字**: 无字幕时使用 Whisper (本地或 API) 转录
- **时间戳标注**: 转录内容带时间戳，便于定位
- **结构化总结**: 自动生成 Markdown 格式的视频总结
- **问答支持**: 基于视频内容进行问答

## 安装

### 1. 安装依赖

```bash
# macOS
brew install yt-dlp ffmpeg

# Python 依赖
pip install openai

# 可选：本地 Whisper（推荐，无需 API）
pip install openai-whisper
```

### 2. 安装 Skill

将此仓库克隆到 Claude Code skills 目录：

```bash
# 个人全局 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
```

### 3. 配置环境变量（可选）

如果使用 OpenAI Whisper API：

```bash
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站视频登录问题

部分 B站视频需要登录才能获取字幕，有两种解决方案：

**方案 1**: 自动读取浏览器 cookies
```bash
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 | 本地转录 | 可选 |

## License

MIT

video-summarizer-skill

video-summarizer-skill Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

video-summarizer-skill

video-summarizer-skill Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README