yt-dlp 视频下载器

使用 yt-dlp 从数千个网站下载视频。

先决条件

在下载前，请验证依赖项是否已安装：

# Check yt-dlp
which yt-dlp || echo "yt-dlp not installed. Install with: pip install yt-dlp"

# Check ffmpeg (required for audio extraction and format merging)
which ffmpeg || echo "ffmpeg not installed. Install with: brew install ffmpeg"

如果未安装，请先安装它们：

pip install yt-dlp
brew install ffmpeg  # macOS

快速开始

基本下载（最佳质量）

yt-dlp -P "~/Downloads/yt-dlp" "VIDEO_URL"

YouTube 下载（推荐 - 使用 Cookies）

YouTube 经常会用 403 错误阻止直接下载。对于 YouTube，请始终使用浏览器 Cookies：

yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "YOUTUBE_URL"

支持的浏览器：chrome、firefox、safari、edge、brave、opera

使用自定义输出路径下载

yt-dlp -P "/path/to/save" -o "%(title)s.%(ext)s" "VIDEO_URL"

常见任务

1. 下载视频（默认 - 最佳质量）

yt-dlp -P "~/Downloads/yt-dlp" "VIDEO_URL"

2. 仅提取音频（MP3）

yt-dlp -P "~/Downloads/yt-dlp" -x --audio-format mp3 "VIDEO_URL"

3. 下载带字幕

yt-dlp -P "~/Downloads/yt-dlp" --write-subs --sub-langs all "VIDEO_URL"

4. 下载指定质量

720p：

yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo[height<=720]+bestaudio/best[height<=720]" "VIDEO_URL"

1080p：

yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" "VIDEO_URL"

最佳可用质量：

yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo+bestaudio/best" "VIDEO_URL"

5. 列出可用格式（下载前）

yt-dlp -F "VIDEO_URL"

然后通过ID下载特定格式：

yt-dlp -P "~/Downloads/yt-dlp" -f FORMAT_ID "VIDEO_URL"

6. 下载播放列表

# Download entire playlist
yt-dlp -P "~/Downloads/yt-dlp" -o "%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s" "PLAYLIST_URL"

# Download specific range (e.g., items 1-5)
yt-dlp -P "~/Downloads/yt-dlp" -I 1:5 "PLAYLIST_URL"

7. 下载含缩略图

yt-dlp -P "~/Downloads/yt-dlp" --write-thumbnail "VIDEO_URL"

工作流程

当用户提供视频URL时：

1. 识别平台：

   • YouTube/YouTube音乐 →始终使用--cookies-from-browser chrome
   • 其他网站 → 先尝试无Cookie访问

2. 询问用户需求（如未指定）：

   • 仅下载视频？
   • 仅提取音频？
   • 需要字幕吗？
   • 具体的质量要求？

3. 根据需求构建命令

4. 执行下载使用Shell工具，并具备required_permissions: ["all", "network"]

5. 错误处理：

   • 403 禁止访问 → 使用--cookies-from-browser
   • 重试
   • 连接问题 → yt-dlp 会自动恢复，只需重试格式不可用 → 使用-F

6. 列出格式，然后选择报告结果

- 文件位置和任何错误

示例交互用户："帮我下载这个视频https://www.youtube.com/watch?v=xxx

"

# YouTube - use cookies to avoid 403 errors
yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "https://www.youtube.com/watch?v=xxx"

回复：https://www.bilibili.com/video/xxx“

响应：

# Bilibili - extracting audio as MP3
yt-dlp -P "~/Downloads/yt-dlp" -x --audio-format mp3 "https://www.bilibili.com/video/xxx"

用户：“下载这个 Twitter 视频https://twitter.com/xxx/status/123”

响应：

# Twitter/X - direct download usually works
yt-dlp -P "~/Downloads/yt-dlp" "https://twitter.com/xxx/status/123"

支持的网站

yt-dlp 支持数千个网站，包括：

• YouTube, YouTube Music
• Bilibili (B站)
• Twitter/X
• TikTok, Douyin (抖音)
• Vimeo
• Twitch
• 以及更多...

完整列表：https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md

故障排除

常见错误与解决方案

错误："yt-dlp: command not found"

pip install yt-dlp

错误："ffmpeg not found"（用于音频提取）

brew install ffmpeg  # macOS

错误：HTTP 403 禁止访问（YouTube）

这是YouTube最常见的错误。对于YouTube，请始终使用Cookie：

# Recommended approach for YouTube
yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "YOUTUBE_URL"

支持的浏览器：chrome、firefox、Safari,Edge,Brave,Opera

错误：视频不可用或受地域限制

# Try with cookies from browser
yt-dlp --cookies-from-browser chrome "VIDEO_URL"

# Or use a specific format
yt-dlp -F "VIDEO_URL"  # List formats first
yt-dlp -f FORMAT_ID "VIDEO_URL"

错误：下载持续失败

# Update yt-dlp to latest version
pip install -U yt-dlp

# Force IPv4 (sometimes helps with connection issues)
yt-dlp -4 "VIDEO_URL"

最佳实践

1. YouTube下载：始终使用--cookies-from-browser chrome
2. 大文件：yt-dlp支持自动续传，如遇中断只需重试即可
3. 保持yt-dlp为最新版本：pip install -U yt-dlp
4. 先检查可用格式：如不确定，下载前请使用-F参数