技能介绍
YouTube to Ebook 是一个把 YouTube 频道视频转化为格式精美的 EPUB 电子书的工具。作者张咋啦是 Harvard '17、Builder。它解决的是“想长期追某个频道，但只看文字版”的问题：抓取频道最新视频的转录文本，交给 Claude AI 整理成杂志风格的文章，再打包成一本可离线阅读的电子书。
适用场景
- 希望将 YouTube 频道内容整理成离线可读的电子书
- 喜欢某个频道的内容，想以杂志风格阅读文字版
- 需要定期获取频道最新视频的文字摘要
核心能力
- 获取 YouTube 频道最新视频（自动过滤 Shorts）
- 提取视频转录文本
- 使用 Claude AI 将转录内容转化为杂志风格的文章
- 生成 EPUB 格式电子书，可在任何设备上阅读
- 可选：通过邮件发送电子书附件
- 可选：Web 面板，方便管理频道和电子书
已知问题与解决方案：
↔ 左右滑动查看完整表格
| 问题 | 解决方案 |
|---|---|
| Shorts 未被时长过滤 | 检查 /shorts/ URL 模式 |
| 搜索 API 返回结果不是按时间排序 | 改用 uploads playlist |
| 转录 API 语法变更 | 使用实例方法 ytt_api.fetch() |
| 云服务器被屏蔽 | 在本地运行，不要使用 GitHub Actions |
| 转录中名字拼写错误 | 在 Claude 上下文中包含视频描述 |
| 文章被截断 | 增加 write_articles.py 中的 max_tokens |
其他说明：电子书将保存在 newsletters/ 目录下；已处理过的视频会被记录，避免重复生成。
效果预览
按 channels.txt 里配置的频道列表运行后，工具会为这些频道的最新视频生成文章并打包成 EPUB。
工作方式
- 您提供 YouTube 频道列表（如
@mkbhd、@veritasium）和 API Key - 工具自动获取每个频道的最新视频，提取转录文本
- Claude AI 将转录内容整理成结构清晰、可读性强的文章
- 最终生成 EPUB 电子书，并可选通过邮件发送给您
你需要提供
- YouTube Data API Key：免费获取，用于获取视频列表和转录
- Anthropic API Key：用于调用 Claude AI 处理文本
- 频道列表：在
channels.txt中按行填写 YouTube 频道 handle（如@mkbhd）
获取 API Key 的简要步骤：
YouTube Data API（免费）
- 前往 Google Cloud Console
- 创建新项目，启用“YouTube Data API v3”
- 创建凭据 → API Key，复制到
.env文件
Anthropic API
- 前往 Anthropic Console
- 创建 API Key，复制到
.env文件
你会获得
- 一份 EPUB 格式的电子书，包含所选频道的最新视频文章
- 可选：电子书作为邮件附件发送到指定邮箱
- 可选：通过 Web 面板查看和管理生成记录
使用示例
channels.txt 内容示例：
# channels.txt 内容示例
@mkbhd
@veritasium
@3blue1brown运行后，工具会为这些频道的最新视频生成文章并打包成 EPUB。也可以通过 Streamlit 启动 Web 面板，管理视频订阅和电子书生成任务。
