用途:从任意 yt-dlp 支持的站点下载媒体(音频、视频或两者),嵌入标题、艺术家、专辑、日期与封面等元数据,并传输到启用插件时配置的 SSH 远程主机。
主要能力:内置 youtube-dl 服务器提供两个 MCP 工具。youtube_download 下载一个或多个 URL 并用 rsync 或 scp 传输到远程;youtube_probe 为只读,解析标题、时长、上传者与格式数量而不下载。默认音频优先,mode 默认 audio,codec 默认配置的 audio_format(未更改时为 mp3)。文件按艺术家组织为 Artist/Title [id].ext,便于 Plex 等媒体服务器索引。
使用方式:youtube_download(urls="https://www.youtube.com/watch?v=...") 下载音频;加 mode="video", max_height=1080 下载限定分辨率视频;mode="both" 同时下载音视频(音频到音乐目录,视频到影视目录);use_archive=true 可只拉取播放列表新增内容;下载前可用 youtube_probe 检查目标。通常无需传 remote、dest_path 或 video_dest_path,它们回退到用户配置。
适用场景:需要把在线媒体归档到自建媒体库或远程服务器,并希望元数据与封面完整、按艺术家整理的用户。
限制与要求:运行主机需 ssh/openssh-client、到远程的无密码密钥认证;rsync 可选,不可用时回退 scp。yt-dlp 与 ffmpeg 自动解析(显式环境路径、PATH、用户缓存、运行时下载),可用 YTDLP_PATH、FFMPEG_PATH 覆盖。传输失败保留本地暂存副本以便重试,成功则删除,除非 keep_local=true。YouTube mix/radio URL 会自动清理为种子视频;播放列表完整下载并扁平化到按艺术家文件夹。yt-dlp 在服务器启动时若过期会自动更新(可配置)。超时由 YTDLP_TIMEOUT_SECS(默认 1800)与 YTDLP_TRANSFER_TIMEOUT_SECS(默认 600)控制;YTDLP_SHA256、FFMPEG_SHA256 可要求校验摘要;YTDLP_EXTRACTOR_ARGS 传给 --extractor-args;YTDLP_SSH_OPTS 添加额外 SSH 选项。具体收费、价格与平台支持范围资料未提供。