name: youtube-downloader category: document-processing 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的安装
- 仅下载单个视频(默认跳过播放列表)
- 更高质量的视频可能需要更长时间下载并使用更多磁盘空间