yt-search-download
一站式 YouTube 视频搜索、下载与字幕提取工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：yt-search-download。 它的用途是：一站式 YouTube 视频搜索、下载与字幕提取工具 完整的 Skill 内容见：https://321skill.com/skills/yt-search-download/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“搜索 YouTube 上关于 Python 入门的最新教程，按播放量排序。” AI 会调用此 Skill 进行搜索，并将结果（含中文翻译）以表格形式返回。然后你可以说：“下载第一个视频。” AI 便会启动下载流程，将视频保存到你的电脑。
介绍
这个 Skill 解决了用户在 YouTube 上高效查找、获取和整理视频内容的痛点。它整合了 YouTube Data API v3 的高级搜索能力和 yt-dlp 的强大下载功能，让你无需离开 AI 对话界面，就能完成从精准搜索到下载保存的全过程。
使用方式非常直观：通过简单的命令行指令，你可以进行全站关键词搜索、浏览特定频道的最新视频、按播放量或时长等条件筛选结果，并直接下载视频、音频或字幕。AI 会帮你将搜索结果翻译成中文并以清晰的表格呈现。
它非常适合内容创作者、研究者、学习者以及任何需要从 YouTube 快速获取视频素材或信息的用户。无论是想下载教程视频离线学习，还是提取播客音频在通勤时收听，或是获取视频字幕用于内容分析，这个 Skill 都能派上用场。
与同类工具相比，它的优势在于深度集成到 AI 工作流中，实现了“搜索-预览-下载”的无缝衔接。它不仅仅是调用一个下载器，而是结合了 API 搜索的精准性、本地排序过滤的灵活性，并强制 AI 进行中文翻译输出，极大地提升了非英语用户的使用体验。
核心特点
核心区别在于将 YouTube Data API v3 的官方搜索能力与 yt-dlp 的下载能力深度结合，并通过 AI 强制翻译输出，形成了一个闭环的“精准搜索 -> 中文预览 -> 一键下载”工作流。它支持基于频道、时长、日期、播放量的高级过滤和排序，这是纯下载工具或简单爬虫所不具备的。
注意事项
不适合需要批量下载整个播放列表或频道所有视频的场景，且依赖用户自行配置 YouTube API Key 和安装 yt-dlp。
常见问题
如何获取 YouTube API Key？
前往 Google Cloud Console，启用 YouTube Data API v3 服务并创建凭据，将获得的 API Key 设置为环境变量 YT_BROWSE_API_KEY。
下载的视频保存在哪里？
默认保存在用户的 ~/Downloads 目录，也可通过 --dir 参数指定其他路径。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/yt-search-download/raw/index.md 读取 yt-search-download 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/yt-search-download/raw/index.md（查看排版版本）