mcpField
D
download-video

download-video

github.com/feiskyer创意与媒体15166 次安装28 周前更新
代码仓库

关于 download-video

download-video 是一项使用 yt-dlp 从 YouTube、Bilibili、Twitter/X、TikTok 等网站下载视频和音频的技能。它提供封装脚本、常用选项及故障排查指南。

主要功能

  1. 01从 1000 多个网站下载
  2. 02将音频保存为 MP3
  3. 03限制视频分辨率
  4. 04列出可用格式
  5. 05下载字幕
  6. 06使用浏览器 Cookie

适用场景

  1. 01保存受支持网站的视频
  2. 02从视频中提取音频
  3. 03下载视频并附带字幕
  4. 04处理登录或年龄限制

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/feiskyer/video-skills --skill download-video

安装后在 Claude Code 中输入/download-video确认已加载。

附带文件references/platform-tips.mdscripts/download.py

详细介绍

下载视频

使用 yt-dlp 下载 YouTube、Bilibili、Twitter/X、TikTok 和其他 1000 多个网站上的视频。

第 1 步：检查前置条件

which yt-dlp && yt-dlp --version
which ffmpeg

如果缺少 yt-dlp，请安装：

# macOS
brew install yt-dlp ffmpeg

# Cross-platform
pip install yt-dlp

第 2 步：下载

使用附带的脚本——它通过合理的默认设置和清晰的错误消息封装了 yt-dlp。

python3 scripts/download.py "VIDEO_URL"

默认输出目录：~/Downloads/Videos/

常用选项
python3 scripts/download.py "URL" -f 1080            # Max 1080p
python3 scripts/download.py "URL" -a                  # Audio only (MP3)
python3 scripts/download.py "URL" -F                  # List formats
python3 scripts/download.py "URL" --subs              # With subtitles
python3 scripts/download.py "URL" -o ~/Desktop        # Custom output dir
python3 scripts/download.py "URL" --cookies chrome    # Use browser cookies
直接使用 yt-dlp 命令

对于脚本未涵盖的情况，请直接使用 yt-dlp：

# Download playlist
yt-dlp -P ~/Downloads/Videos "PLAYLIST_URL"

# Custom filename template
yt-dlp -o "%(uploader)s - %(title)s.%(ext)s" "VIDEO_URL"

# Download with subtitles in specific languages
yt-dlp --write-subs --sub-lang zh,en -P ~/Downloads/Videos "VIDEO_URL"

故障排除

大多数下载失败都属于以下几类：

症状解决方法
“需要登录”或受年龄限制添加 --cookies chrome 以使用浏览器会话
只能获取低画质更新 yt-dlp（brew upgrade yt-dlp），然后尝试使用 --cookies chrome
下载速度慢尝试 --concurrent-fragments 3 或 --downloader aria2c
网络错误（处于防火墙后）使用 --proxy socks5://127.0.0.1:1080 或设置 ALL_PROXY 环境变量

有关特定平台的详细信息（YouTube PO 令牌、Bilibili 系列、TikTok 去水印等），请参阅 references/platform-tips.md。

评论

支持 Markdown