免费YouTube下载工具yt-dlp使用指南：离线下载视频、提取字幕、获取元数据

youtube-tools by casper-studios/casper-marketplace

149 周安装量

10 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/casper-studios/casper-marketplace --skill youtube-tools

内容创作自动化命令行工具

🇨🇳中文介绍

YouTube 工具 (yt-dlp)

概述

使用 yt-dlp 进行免费的本地 YouTube 操作。无需 API 密钥，无单视频成本。安装后可在离线状态下工作。

何时使用此工具而非 Apify

┌─────────────────────────────────────────────────────────────────┐
│ 决策：YouTube 工具 (yt-dlp) 与 Apify                            │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ 在以下情况下使用 youtube-tools (免费)：                         │
│ ├── 将视频下载到本地存储                                        │
│ ├── 提取字幕/转录稿                                             │
│ ├── 获取视频元数据（标题、时长、观看次数等）                    │
│ ├── 批量下载播放列表或频道内容                                  │
│ ├── 转换为纯音频格式 (MP3)                                      │
│ └── 您希望实现零 API 成本                                       │
│                                                                 │
│ 在以下情况下使用 apify-scrapers：                               │
│ ├── 抓取 YouTube 搜索结果                                       │
│ ├── 大规模获取评论                                              │
│ ├── 频道分析和统计数据                                          │
│ ├── 发现热门视频                                                │
│ └── 您需要基于云的处理                                          │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

按特定画质下载

python scripts/download_video.py "https://youtu.be/VIDEO_ID" --quality 1080p

仅下载音频 (MP3)

python scripts/download_video.py "https://youtube.com/watch?v=VIDEO_ID" --audio-only

下载整个播放列表

python scripts/download_video.py "https://youtube.com/playlist?list=PLAYLIST_ID" --output-dir ./videos

从文件批量下载

# 创建 urls.txt，每行一个 URL
python scripts/download_video.py --urls-file urls.txt --output-dir ./downloads

python scripts/get_transcript.py "https://youtube.com/watch?v=VIDEO_ID"

获取特定语言的字幕

python scripts/get_transcript.py "https://youtu.be/VIDEO_ID" --lang es

获取视频元数据

python scripts/get_video_info.py "https://youtube.com/watch?v=VIDEO_ID"

获取多个视频的元数据

python scripts/get_video_info.py --urls-file videos.txt --output metadata.json

默认情况下，所有输出保存到 .tmp/youtube/：

视频：.tmp/youtube/videos/
音频：.tmp/youtube/audio/
字幕：.tmp/youtube/transcripts/
元数据：.tmp/youtube/metadata/

免费 - 无需 API 密钥，无单视频成本，无订阅费用。

URL 验证：仅接受 YouTube URL (youtube.com, youtu.be)
文件名清理：移除危险字符
输出限制：仅写入 .tmp/ 目录
无 Shell 注入：使用带参数列表的 subprocess，而非字符串拼接
不存储凭据：仅在明确请求时使用 cookies

仅下载您有权访问的内容
遵守 YouTube 的服务条款
请勿重新分发受版权保护的内容
用于个人/教育目的

yt-dlp 内置速率限制
对于批量下载，使用 --sleep-interval 5 以避免节流
请求过多时，YouTube 可能会暂时封锁 IP

问题："视频不可用"

原因： 视频为私享、年龄限制或区域锁定 解决方案： 对于年龄限制内容，使用 --cookies-from-browser chrome

问题："无法提取视频数据"

原因： YouTube 更改了其页面结构 解决方案： 更新 yt-dlp：pip install -U yt-dlp

问题：未找到字幕

原因： 视频没有字幕（自动或手动） 解决方案： 先使用 --list-subs 查看可用的字幕

问题：下载速度慢

原因： YouTube 节流或网络问题 解决方案： 尝试使用 --concurrent-fragments 4 以加快下载速度

问题：格式转换失败

原因： 未安装 ffmpeg 解决方案： 安装 ffmpeg (参见环境设置)

下载 + 转录 + 总结

# 1. 下载视频
python scripts/download_video.py "URL" --output-dir .tmp/video

# 2. 获取字幕
python scripts/get_transcript.py "URL" --output .tmp/transcript.txt

# 3. 使用内容生成工具进行总结
# (字幕文件现已准备好用于总结)

批量研究工作流

# 1. 获取研究视频的元数据
python scripts/get_video_info.py --urls-file research_videos.txt --output .tmp/metadata.json

# 2. 下载字幕用于文本分析
python scripts/get_transcript.py --urls-file research_videos.txt --output-dir .tmp/transcripts

# 3. 使用并行研究工具分析内容

# 将整个播放列表作为课程模块下载
python scripts/download_video.py "PLAYLIST_URL" --output-dir .tmp/course --quality 720p

# 获取所有字幕用于笔记
python scripts/get_transcript.py "PLAYLIST_URL" --output-dir .tmp/course/transcripts

references/yt-dlp-guide.md - 完整的 yt-dlp 参考，包含所有选项
yt-dlp 文档 : https://github.com/yt-dlp/yt-dlp#readme

🇺🇸English

YouTube Tools (yt-dlp)

Overview

Free, local YouTube operations using yt-dlp. No API keys required, no per-video costs. Works offline after installation.

When to Use This vs Apify

┌─────────────────────────────────────────────────────────────────┐
│ DECISION: YouTube Tools (yt-dlp) vs Apify                       │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ Use youtube-tools (FREE) when:                                  │
│ ├── Downloading videos to local storage                         │
│ ├── Extracting transcripts/subtitles                            │
│ ├── Getting video metadata (title, duration, views, etc.)       │
│ ├── Bulk downloading playlists or channels                      │
│ ├── Converting to audio-only (MP3)                              │
│ └── You want zero API costs                                     │
│                                                                 │
│ Use apify-scrapers when:                                        │
│ ├── Scraping YouTube SEARCH results                             │
│ ├── Getting comments at scale                                   │
│ ├── Channel analytics and statistics                            │
│ ├── Trending video discovery                                    │
│ └── You need cloud-based processing                             │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Quick Decision Tree

What do you need?
│
├── Download video(s)
│   ├── Single video → scripts/download_video.py URL
│   ├── Multiple videos → scripts/download_video.py --urls-file list.txt
│   ├── Playlist → scripts/download_video.py "playlist_url"
│   ├── Audio only → scripts/download_video.py URL --audio-only
│   └── Specific quality → scripts/download_video.py URL --quality 720p
│
├── Get transcript/subtitles
│   ├── Auto-generated captions → scripts/get_transcript.py URL
│   ├── Manual subtitles → scripts/get_transcript.py URL --manual-only
│   ├── Specific language → scripts/get_transcript.py URL --lang es
│   └── All available → scripts/get_transcript.py URL --all-langs
│
├── Get video metadata
│   ├── Single video → scripts/get_video_info.py URL
│   ├── Multiple videos → scripts/get_video_info.py --urls-file list.txt
│   └── Playlist info → scripts/get_video_info.py "playlist_url"
│
└── Advanced
    ├── Age-restricted → scripts/download_video.py URL --cookies-from-browser chrome
    ├── Private videos → Requires authentication (see references/yt-dlp-guide.md)
    └── Live streams → scripts/download_video.py URL --live-from-start

Environment Setup

# Install yt-dlp (required)
pip install yt-dlp

# Optional: Install ffmpeg for format conversion
# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Windows
winget install ffmpeg

No API keys required! This is completely free.

Common Usage

Download Single Video

python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"

Download with Specific Quality

python scripts/download_video.py "https://youtu.be/VIDEO_ID" --quality 1080p

Download Audio Only (MP3)

python scripts/download_video.py "https://youtube.com/watch?v=VIDEO_ID" --audio-only

Download Entire Playlist

python scripts/download_video.py "https://youtube.com/playlist?list=PLAYLIST_ID" --output-dir ./videos

Bulk Download from File

# Create urls.txt with one URL per line
python scripts/download_video.py --urls-file urls.txt --output-dir ./downloads

Get Transcript

python scripts/get_transcript.py "https://youtube.com/watch?v=VIDEO_ID"

Get Transcript in Specific Language

python scripts/get_transcript.py "https://youtu.be/VIDEO_ID" --lang es

Get Video Metadata

python scripts/get_video_info.py "https://youtube.com/watch?v=VIDEO_ID"

Get Metadata for Multiple Videos

python scripts/get_video_info.py --urls-file videos.txt --output metadata.json

Output Location

All outputs save to .tmp/youtube/ by default:

Videos: .tmp/youtube/videos/
Audio: .tmp/youtube/audio/
Transcripts: .tmp/youtube/transcripts/
Metadata: .tmp/youtube/metadata/

Cost

FREE - No API keys, no per-video costs, no subscriptions.

Security Notes

Safe by Design

URL validation: Only accepts YouTube URLs (youtube.com, youtu.be)
Filename sanitization: Removes dangerous characters
Output restriction: Only writes to .tmp/ directory
No shell injection: Uses subprocess with argument lists, not string concatenation
No stored credentials: Cookies only used when explicitly requested

Copyright Warning

Only download content you have rights to access
Respect YouTube's Terms of Service
Do not redistribute copyrighted content
Use for personal/educational purposes

Rate Limiting

yt-dlp has built-in rate limiting
For bulk downloads, use --sleep-interval 5 to avoid throttling
YouTube may temporarily block IPs with excessive requests

Troubleshooting

Issue: "Video unavailable"

Cause: Video is private, age-restricted, or region-locked Solution: Use --cookies-from-browser chrome for age-restricted content

Issue: "Unable to extract video data"

Cause: YouTube changed their page structure Solution: Update yt-dlp: pip install -U yt-dlp

Issue: No subtitles found

Cause: Video has no captions (auto or manual) Solution: Use --list-subs to see available subtitles first

Issue: Slow downloads

Cause: YouTube throttling or network issues Solution: Try --concurrent-fragments 4 for faster downloads

Issue: Format conversion failed

Cause: ffmpeg not installed Solution: Install ffmpeg (see Environment Setup)

Integration Patterns

Download + Transcribe + Summarize

# 1. Download video
python scripts/download_video.py "URL" --output-dir .tmp/video

# 2. Get transcript
python scripts/get_transcript.py "URL" --output .tmp/transcript.txt

# 3. Use content-generation to summarize
# (transcript file is now ready for summarization)

Bulk Research Workflow

# 1. Get metadata for research videos
python scripts/get_video_info.py --urls-file research_videos.txt --output .tmp/metadata.json

# 2. Download transcripts for text analysis
python scripts/get_transcript.py --urls-file research_videos.txt --output-dir .tmp/transcripts

# 3. Use parallel-research to analyze content

Course Content Download

# Download entire playlist as course modules
python scripts/download_video.py "PLAYLIST_URL" --output-dir .tmp/course --quality 720p

# Get all transcripts for notes
python scripts/get_transcript.py "PLAYLIST_URL" --output-dir .tmp/course/transcripts

Resources

references/yt-dlp-guide.md - Complete yt-dlp reference with all options
yt-dlp documentation : https://github.com/yt-dlp/yt-dlp#readme

Weekly Installs

108

Repository

casper-studios/…ketplace

GitHub Stars

First Seen

Feb 24, 2026

Security Audits

Gen Agent Trust HubPass SocketWarn SnykWarn

Installed on

opencode108

github-copilot108

codex108

kimi-cli108

gemini-cli108

amp108

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

36,300 周安装