back
loading skill details...
轻量级YouTube视频字幕提取工具，支持单视频字幕获取与内容摘要，适合个人学习与内容分析。
---
name: "youtube-watcher-tool-free"
description: "轻量级YouTube视频字幕提取工具，支持单视频字幕获取与内容摘要，适合个人学习与内容分析。"
license: Proprietary
allowed-tools: read exec
compatibility: "Requires LLM with tool-use capability"
metadata:
displayName: "YouTube字幕提取-免费版"
version: "1.0.0"
summary: "轻量级YouTube视频字幕提取工具，支持单视频字幕获取与内容摘要，适合个人学习与内容分析。"
tags:
- "Creative"
- "视频处理"
- "字幕提取"
- "免费版"
source: "SkillHub"
converted_at: "2026-07-22T17:58:36"
---
# 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: 执行完成,结果如下: 操作成功
```
don't have the plugin yet? install it then click "run inline in claude" again.