id: “678ab39e-3ab4-5370-a0cd-79fd9ed28b21” name: youtube-downloader description: 下载YouTube视频,提供可定制的质量和格式选项。当用户要求下载、保存或抓取YouTube视频时使用此技能。支持各种质量设置(最佳、1080p、720p、480p、360p)、多种格式(mp4、webm、mkv)以及仅下载音频为MP3。
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
完整示例
- 以1080p作为MP4格式下载视频:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p
- 仅下载音频作为MP3:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a
- 以720p作为WebM格式下载到自定义目录:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path
工作原理
该技能使用 yt-dlp,一个强大的YouTube下载器,它:
- 如果不存在,自动安装自身
- 在下载前获取视频信息
- 选择匹配您标准的最佳可用流
- 当需要时合并视频和音频流
- 支持广泛的YouTube视频格式
重要说明
- 下载默认保存到
/mnt/user-data/outputs/ - 视频文件名自动从视频标题生成
- 脚本自动处理yt-dlp的安装
- 仅下载单个视频(默认跳过播放列表)
- 更高质量的视频可能需要更长时间下载并使用更多磁盘空间