Yt Search Download

yt-search-download

YouTube 视频搜索、下载、字幕提取工具 — Claude Code Skill

基于 YouTube Data API v3 进行高级搜索，配合 yt-dlp 下载视频/音频/字幕，自动翻译英文标题为中文。

功能

• 搜索：全站关键词搜索，支持按时间 / 播放量 / 相关度排序
• 频道浏览：浏览指定频道最新视频，支持频道内关键词搜索
• 下载视频：支持多种画质（最高 4K），指定保存目录
• 提取音频：一键下载 MP3
• 下载字幕：自动生成 SRT（带时间轴）+ TXT（供 AI 总结），支持中英双语
• 中文翻译：搜索结果为英文时自动附加中文译名，无需额外操作
• 视频详情：查询时长、播放量、简介等元数据

安装

npx skills add joeseesun/yt-search-download

前置条件

1. **YouTube API Key**：[Google Cloud Console](https://console.cloud.google.com/) → 启用 YouTube Data API v3 → 创建 API Key

   export YT_BROWSE_API_KEY=your_key   # 写入 ~/.zshrc

2. **yt-dlp**（下载 / 字幕用）：

   brew install yt-dlp   # macOS
   pip install yt-dlp     # 或 pip

使用场景

在 Claude Code 中直接用自然语言描述需求，无需记命令：

🔍 搜索视频

"搜索 Lex Fridman 最近更新的 YouTube"
"YouTube 上有什么关于 Claude 4 的最新视频"
"找 Andrej Karpathy 频道的视频，按播放量排序"
"搜索 AI agent 相关视频，最近一个月发布的"

搜索结果示例（英文自动附中文译名）：

1  Rick Beato: Greatest Guitarists of All Time
   【译】里克·贝阿托：史上最伟大的吉他手、音乐史与创作秘密
   2026-03-01  2h34m  301.9K

2  State of AI in 2026: LLMs, Coding, Scaling Laws
   【译】2026年AI现状：大模型、编程、Scaling法则与中国AI
   2026-01-31  4h25m  741.7K

📺 浏览频道

"看看 Lex Fridman 最近发了什么视频"
"浏览 @karpathy 的频道，找讲 GPT 的视频"
"查看 3Blue1Brown 最新上传"

⬇️ 下载视频

"下载这个视频 https://youtube.com/watch?v=..."
"把这个视频下载到桌面，要 1080p"
"下载 Lex Fridman 和 Sam Altman 的那期播客"

🎵 提取音频

"提取这个视频的音频"
"YouTube 转 MP3，只要音频"
"下载播客音频 https://youtube.com/watch?v=..."

📝 下载字幕（SRT + TXT）

字幕下载**自动生成两个文件**：

• .srt：带时间轴，适合视频剪辑、精准定位
• .txt：保留时间戳，适合交给 AI 总结归纳

"下载这个视频的字幕 https://youtube.com/watch?v=..."
"提取 Lex Fridman 这期节目的英文字幕"
"获取视频文本，我要交给 AI 总结"
"下载中文字幕"

TXT 格式示例（保留时间戳，AI 可引用具体时间点）：

00:00:01,000 --> 00:00:04,000
Welcome to the Lex Fridman podcast.

00:00:05,000 --> 00:00:09,000
Today we're talking about the greatest guitarists of all time.

🔄 典型工作流

**① 找频道最新视频并下载字幕：**

1. "看看 Lex Fridman 最近更新了什么"
2. 选择感兴趣的视频
3. "下载第2个视频的字幕"