YouTube 内容工具 是做什么的?
何时使用
当用户分享 YouTube 网址或视频链接、要求总结视频、请求转录、或希望从任何 YouTube 视频中提取内容并重新格式化时使用。将转录文本转换为结构化内容(章节、摘要、推文线程、博客文章)。
从 YouTube 视频中提取转录并将其转换为有用的格式。
设置
使用 uv 将依赖安装到同一个由 Hermes 管理的环境中,该环境运行辅助脚本:
uv pip install youtube-transcript-api
辅助脚本
SKILL_DIR 是包含此 SKILL.md 文件的目录。该脚本接受任何标准 YouTube 网址格式、短链接(youtu.be)、Shorts、嵌入视频、直播链接或原始的 11 字符视频 ID。
# 带元数据的 JSON 输出
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "https://youtube.com/watch?v=VIDEO_ID"
# 纯文本(适合直接用于后续处理)
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --text-only
# 带时间戳
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --timestamps
# 特定语言及回退链
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --language tr,en
输出格式
获取转录后,根据用户要求进行格式化:
- 章节:按主题转换分组,输出带时间戳的章节列表
- 摘要:整个视频的简练概述(5-10 句话)
- 章节摘要:每个章节附一段简短段落摘要
- 推文线程:Twitter/X 推文格式 — 编号帖子,每条不超过 280 个字符
- 博客文章:包含标题、章节和关键要点的完整文章
- 引用语录:带时间戳的精彩引述
示例 — 章节输出
00:00 引言 — 主持人以问题陈述开场
03:45 背景 — 先前工作以及现有解决方案的不足之处
12:20 核心方法 — 对提出方法的逐步讲解
24:10 结果 — 基准比较和关键要点
31:55 问答环节 — 观众关于可扩展性和下一步计划的问题
工作流程
- 获取:使用辅助脚本通过
uv run python3并加上--text-only --timestamps选项获取转录。 - 验证:确认输出非空且为预期语言。如果为空,则在不带
--language的情况下重试,以获取任何可用的转录。如果仍然为空,则告知用户该视频可能已禁用转录功能。 - 必要时分块:如果转录超过约 50K 字符,则将其拆分为重叠块(约 40K 字符,重叠 2K),分别总结每个块后再合并。
- 转换:按照用户要求的输出格式进行转换。如果用户没有指定格式,则默认输出摘要。
- 验证:重新阅读转换后的输出,检查连贯性、时间戳正确性和完整性,然后再呈现给用户。
错误处理
- 转录已禁用:告知用户;建议他们检查视频页面是否有字幕可用。
- 私密或不可用的视频:传递错误信息,并请用户确认网址是否正确。
- 没有匹配的语言:在不带
--language的情况下重试,以获取任何可用的转录,然后向用户说明实际语言。 - 缺少依赖:运行
uv pip install youtube-transcript-api并重试。