youtube-fetcher-to-markdown
自动抓取YouTube视频字幕并保存为结构化Markdown文件
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：youtube-fetcher-to-markdown。 它的用途是：自动抓取YouTube视频字幕并保存为结构化Markdown文件 完整的 Skill 内容见：https://321skill.com/skills/youtube-fetcher-to-markdown/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我提取这个YouTube视频https://youtu.be/xxx的字幕，并总结要点。’ 它会先调用此Skill抓取字幕并保存为本地Markdown文件，然后读取文件内容为你生成视频摘要。或者直接说：‘分析一下这个视频讲了什么。’ 即使你没有提到‘字幕’，AI在识别到YouTube链接后也会默认触发此Skill获取文本内容。
介绍
这个Skill解决了用户需要快速获取YouTube视频文本内容进行笔记、分析或存档的痛点。它通过集成yt-dlp和youtube-transcript-api，自动提取视频的完整元数据（标题、频道、描述、章节）和字幕，生成结构清晰的Markdown文件，保存在本地指定目录。
使用时，用户只需向AI助手（如Claude）提供一个YouTube链接或视频ID，助手便会调用该Skill的脚本执行抓取任务。脚本支持多种参数，如强制重新抓取（—force）、输出到终端（—stdout）、指定语言（—lang）和包含时间戳（—timestamps），以适应不同需求。
它非常适合学生、研究者、内容创作者、笔记爱好者以及任何需要深度处理或引用YouTube视频信息的人。无论是为了学习做笔记、为内容创作收集素材，还是进行语言学习或视频内容分析，这个工具都能将视频的音频信息快速转化为可搜索、可编辑的文本。
与单纯下载字幕的工具不同，它的核心价值在于“结构化”和“本地化”。它不仅抓取原始字幕文本，还整合了丰富的视频元数据，并以带YAML frontmatter的Markdown格式保存，便于后续用其他工具（如笔记软件、AI）进行二次处理。同时，文件本地保存的特性，也方便用户建立个人视频知识库。
核心特点
核心区别在于它并非仅提供原始字幕文本，而是生成一个包含完整视频元数据（标题、频道、描述、时长、章节）和结构化字幕的Markdown文件，并自动保存到本地目录，实现了从“获取文本”到“创建可管理知识资产”的闭环。
注意事项
不适合需要实时翻译或处理非公开、会员专享等无法通过API获取字幕的视频场景。
常见问题
如何获取视频的字幕文本？
向AI提供YouTube视频链接，AI会自动运行脚本抓取并保存Markdown文件，也可使用--stdout参数直接输出到对话中。
抓取的字幕文件保存在哪里？
文件默认保存在用户主目录下的 ~/yt_transcripts/ 文件夹中，按日期和视频标题命名。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/youtube-fetcher-to-markdown/raw/index.md 读取 youtube-fetcher-to-markdown 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/youtube-fetcher-to-markdown/raw/index.md（查看排版版本）