mcpField
V
video-downloader

video-downloader

github.com/davepoon创意与媒体3.7k48 次安装1 天前更新
代码仓库

关于 video-downloader

video-downloader 是用于下载单个 YouTube 视频的命令行技能，可选择画质和格式，也可仅提取 MP3 音频。它使用 yt-dlp，并仅接受指定 YouTube 域名的 HTTPS 链接。

主要功能

  1. 01选择视频画质
  2. 02支持 MP4、WebM 和 MKV
  3. 03仅下载 MP3 音频
  4. 04自定义输出目录
  5. 05验证 HTTPS 与 YouTube 域名

适用场景

  1. 01按指定分辨率保存 YouTube 视频
  2. 02提取 YouTube 视频中的音频
  3. 03为视频下载选择格式
  4. 04将下载内容保存到指定目录

安装

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

$npx skills add https://github.com/davepoon/buildwithclaude --skill video-downloader

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

附带文件.gitignorescripts/download_video.py

详细介绍

YouTube 视频下载器

下载 YouTube 视频，并全面控制画质和格式设置。

快速开始

下载视频的最简单方法：

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

此命令会以最高可用画质将视频下载为 MP4 文件，并保存到 /mnt/user-data/outputs/。

选项

画质设置

使用 -q 或 --quality 指定视频画质：

  • best（默认）：最高可用画质
  • 1080p：全高清
  • 720p：高清
  • 480p：标清
  • 360p：较低画质
  • worst：最低可用画质

示例：

python scripts/download_video.py "URL" -q 720p
格式选项

使用 -f 或 --format 指定输出格式（仅适用于视频下载）：

  • mp4（默认）：兼容性最佳
  • webm：现代格式
  • mkv：Matroska 容器

示例：

python scripts/download_video.py "URL" -f webm
仅下载音频

使用 -a 或 --audio-only 将音频下载为 MP3：

python scripts/download_video.py "URL" -a
自定义输出目录

使用 -o 或 --output 指定其他输出目录：

python scripts/download_video.py "URL" -o /path/to/directory

完整示例

  1. 以 1080p 画质将视频下载为 MP4：
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p
  1. 仅下载音频为 MP3：
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a
  1. 以 720p 画质将视频下载为 WebM，并保存到自定义目录：
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path

支持的 URL

  • 仅支持 HTTPS — 不接受 http:// 链接。
  • 仅支持 YouTube 主机 — 允许的主机名包括 youtube.com（以及 www、m、music 等子域名）、youtu.be 和 youtube-nocookie.com（包括 www）。不接受其他网站。

yt-dlp 安装

此脚本不会将软件包安装到系统 Python 中（不会使用 --break-system-packages）。

  1. 如果 yt-dlp 位于 PATH 中，则使用该版本。
  2. 否则，脚本会在 video-downloader/.venv 中创建一个本地虚拟环境，使用 pip 在其中安装 yt-dlp，并运行该环境中的二进制文件。
  3. 如果创建虚拟环境或安装失败，请按照打印的提示操作，或全局安装，例如：pipx install yt-dlp、brew install yt-dlp，或者使用操作系统的软件包管理器。

.venv 目录已加入 Git 忽略列表，并保留在技能文件夹内。

工作原理

此技能使用 yt-dlp，这是一款功能强大的 YouTube 下载器，它可以：

  • 按上述说明通过 PATH 或技能专属的 .venv 查找 yt-dlp
  • 在下载前获取视频信息
  • 根据你的条件选择最佳可用流
  • 在需要时合并视频流和音频流
  • 支持多种 YouTube 视频格式

重要说明

  • 下载内容默认保存到 /mnt/user-data/outputs/
  • 视频文件名会根据视频标题自动生成
  • 仅下载单个视频（默认跳过播放列表）
  • 画质越高的视频，下载耗时可能越长，占用的磁盘空间也越多

评论

支持 Markdown