Youtube Watcher Tool Free

轻量级YouTube视频字幕提取工具，支持单视频字幕获取与内容摘要，适合个人学习与内容分析。

YouTube 字幕提取工具 - 免费版

概述

YouTube 字幕提取免费版是一款面向个人用户的轻量级视频字幕获取工具。它通过 yt-dlp 工具提取 YouTube 视频的字幕文本，支持自动生成字幕与人工 CC 字幕，提取后可进行内容摘要、问答、关键词检索等操作。

免费版聚焦核心字幕提取场景：单视频字幕获取、基础内容分析。配置简单，适合以下用户：

• 学习者获取视频内容摘要
• 研究者检索视频关键信息
• 内容创作者整理素材
• 外语学习者理解视频内容

免费版限制：单次处理 1 个视频，仅支持提取字幕文本，不支持批量提取、频道监控、多语言字幕对比、关键词追踪等高级能力。如需这些能力，请使用 PRO 版本。

核心能力

能力清单

能力	描述	免费版
字幕提取	获取视频字幕文本	支持
自动字幕	提取自动生成字幕	支持
CC 字幕	提取人工字幕	支持
内容摘要	生成视频摘要	支持
关键信息检索	搜索字幕内容	支持
视频问答	基于内容回答问题	支持
字幕导出	导出为文本文件	支持
批量提取	多视频字幕	不支持
频道监控	监控频道更新	不支持
多语言字幕	多语言对比	不支持
关键词追踪	跨视频关键词	不支持
时间戳标记	字幕带时间戳	不支持（仅文本）

输入: 用户提供能力清单所需的指令和必要参数。 处理: 按照skill规范执行能力清单操作,遵循单一意图原则。 输出: 返回能力清单的执行结果,包含操作状态和输出数据。

工作流程

text

用户提供 YouTube 视频 URL
      ↓
调用 yt-dlp 提取字幕
      ↓
解析字幕文本内容
      ↓
可选：摘要 / 检索 / 问答
      ↓
返回结果给用户

输入: 用户提供工作流程所需的指令和必要参数。 处理: 按照skill规范执行工作流程操作,遵循单一意图原则。 输出: 返回工作流程的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

字幕类型解析与选择

YouTube 视频通常有两种字幕：

类型	说明	准确度
自动字幕	YouTube 自动生成	中等（依赖语音识别）
CC 字幕	人工上传字幕	高（人工校对）

免费版优先提取 CC 字幕，若无则使用自动字幕。

输入: 用户提供字幕类型说明所需的指令和必要参数。 处理: 按照skill规范执行字幕类型说明操作,遵循单一意图原则。 输出: 返回字幕类型说明的执行结果,包含操作状态和输出数据。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：轻量级、视频字幕提取工具、支持单视频字幕获、取与内容摘要、适合个人学习与内、容分析、字幕提取免费版、为个人用户提供轻、量化的视频字幕获、取能力、核心能力、单视频字幕提取、自动字幕与、字幕内容摘要生成、视频内容问答、字幕文本导出等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

核心功能执行

执行核心功能执行操作,使用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。 输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

使用场景

场景 1：学习视频内容摘要

小张想学习一个 YouTube 技术教程视频，但视频有 1 小时，希望先获取摘要判断是否值得学习。

操作步骤：

1. 告诉 Agent：「帮我提取这个视频的字幕并总结要点 https://www.youtube.com/watch?v=VIDEO_ID」
2. Agent 调用字幕提取脚本
3. 读取字幕文本内容
4. 生成内容摘要返回给用户

示例命令：

bash

# 提取字幕
python3 {baseDir}/scripts/get_transcript.py "https://www.youtube.com/watch?v=VIDEO_ID"

返回示例：

text

视频摘要：
- 主题：React Hooks 入门教程
- 时长：45 分钟
- 核心要点：
  1. useState 状态管理基础
  2. useEffect 副作用处理
  3. useContext 跨组件传值
  4. 自定义 Hook 开发
- 适合人群：有 React 基础的开发者

场景 2：视频关键信息检索

小李需要从一段产品评测视频中找到关于「续航时间」的具体信息。

操作步骤：

1. 告诉 Agent：「从这个视频找关于续航时间的内容 https://www.youtube.com/watch?v=VIDEO_ID」
2. Agent 提取字幕文本
3. 在字幕中搜索「续航」相关内容
4. 返回相关片段

示例命令：

bash

# 提取字幕
python3 {baseDir}/scripts/get_transcript.py "https://www.youtube.com/watch?v=VIDEO_ID"

# 示例
grep -A 2 -B 2 "续航" /tmp/transcript.txt

场景 3：外语视频内容理解

小王想看一段英文演讲视频，但英语水平有限，希望通过字幕理解内容。

操作步骤：

1. 告诉 Agent：「提取这个英文视频的字幕并翻译要点 https://www.youtube.com/watch?v=VIDEO_ID」
2. Agent 提取英文字幕
3. 生成中文摘要
4. 返回中文要点

示例命令：

bash

# 提取英文字幕
python3 {baseDir}/scripts/get_transcript.py "https://www.youtube.com/watch?v=VIDEO_ID" --lang en

不适用场景

以下场景YouTube字幕提取-免费版不适合处理：

• 黑帽SEO手段
• 搜索引擎作弊
• 付费广告投放管理

触发条件

需要SEO优化、关键词分析、排名提升、搜索流量优化时使用。不适用于非本工具能力范围的需求。

快速开始

依赖详情

bash

# 使用 pip 安装
pip3 install yt-dlp

# 或使用 brew 安装（macOS）
brew install yt-dlp

# 验证安装
yt-dlp --version

第二步：提取字幕

最简单的用法 - 提取视频字幕：

bash

python3 {baseDir}/scripts/get_transcript.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

第三步：生成摘要

提取字幕后，让 Agent 生成摘要：

bash

# 提取字幕到文件
python3 {baseDir}/scripts/get_transcript.py "https://www.youtube.com/watch?v=VIDEO_ID" > /tmp/transcript.txt

# 让 Agent 读取并生成摘要

第四步：关键词检索

bash

# 提取字幕
python3 {baseDir}/scripts/get_transcript.py "https://www.youtube.com/watch?v=VIDEO_ID" > /tmp/transcript.txt

# 搜索关键词
grep -i "关键词" /tmp/transcript.txt

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

配置示例

最佳实践

1. 选择有字幕的视频

bash

# 提取前检查视频是否有字幕
yt-dlp --list-subs "https://www.youtube.com/watch?v=VIDEO_ID"

2. 优先使用 CC 字幕

CC 字幕准确度更高：

bash

# 优先提取人工字幕
python3 {baseDir}/scripts/get_transcript.py "URL" --prefer-cc

3. 字幕语言选择

bash

# 提取中文字幕
python3 {baseDir}/scripts/get_transcript.py "URL" --lang zh

# 提取英文字幕
python3 {baseDir}/scripts/get_transcript.py "URL" --lang en

4. 长视频处理建议

视频时长	建议
< 10 分钟	直接提取全部字幕
10-30 分钟	提取后分段摘要
30-60 分钟	提取后按章节摘要
> 60 分钟	建议分段处理

常见问题

Q1：提示 yt-dlp 未找到？

A： 请安装 yt-dlp：

bash

pip3 install yt-dlp
# 或
brew install yt-dlp

Q2：视频没有字幕怎么办？

A： 可能原因：

1. 视频没有自动生成字幕（如纯音乐视频）
2. 视频没有人工上传字幕
3. 字幕已被创作者关闭

建议：选择有 CC 字幕的视频，或使用其他有字幕的视频。

Q3：提取的字幕不准确？

A： 自动字幕依赖语音识别，准确度受以下因素影响：

• 视频音质（清晰度、背景噪音）
• 说话人口音
• 专业术语数量

建议优先使用人工 CC 字幕。

Q4：能否提取多语言字幕？

A： 免费版单次仅提取一种语言字幕。如需多语言对比，请使用 PRO 版本。

Q5：能否批量提取多个视频？

A： 免费版仅支持单视频提取。如需批量处理，请使用 PRO 版本。

Q6：提取的字幕可以保存为文件吗？

A： 可以：

bash

python3 {baseDir}/scripts/get_transcript.py "URL" > /tmp/transcript.txt

Q7：能否提取播放列表的字幕？

A： 免费版仅支持单视频。播放列表批量提取请使用 PRO 版本。

依赖说明

运行环境

• Agent 平台：支持 SKILL.md 规范的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统：Windows / macOS / Linux
• Python：3.8+（脚本依赖）
• 网络：需要网络连接（访问 YouTube）

第三方依赖

依赖项	类型	是否必需	获取方式	版本要求
Python	运行时	必需	python.org	3.8+
yt-dlp	命令行工具	必需	pip install yt-dlp	2023.0+
LLM API	API	必需	由 Agent 内置 LLM 提供	-

安装命令

bash

# 安装 yt-dlp
pip3 install yt-dlp

# 验证安装
python3 --version
yt-dlp --version

API Key 配置

• 本 Skill 纯本地运行，无需任何 API Key
• 字幕提取通过 yt-dlp 公开接口完成
• 如需访问私人视频，需配置 YouTube Cookie（可选）

bash

# 可选：配置 YouTube Cookie 访问私人视频
# yt-dlp --cookies /path/to/cookies.txt "URL"

可用性分类

• 分类：MD+EXEC（Markdown 指令 + 命令行执行 + Python 脚本）
• 说明：通过自然语言指令驱动 Agent 调用 get_transcript.py 完成字幕提取
• 离线可用：否（需要网络访问 YouTube）
• 隐私等级：高（字幕本地处理，不上传）

版本说明

• 当前版本：1.0.0
• 版本类型：FREE（免费版）
• 升级路径：如需批量提取、频道监控、多语言字幕、关键词追踪等能力，请使用 youtube-watcher-tool-pro

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响

示例

基本用法

输入：用户提供操作指令和必要参数

输出：返回执行结果,包含操作状态和输出数据

text

用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功