一个为Plex媒体服务器提供的元数据代理插件，用于获取YouTube视频的电影和电视剧集元数据。通过视频ID查找相关信息，支持本地JSON文件和在线API获取方式。
一分钟了解#
YouTube-Agent.bundle 是一个专为Plex媒体服务器设计的元数据代理插件，专门用于组织和管理从YouTube下载的视频内容。无论您是想整理游戏实况、教程视频还是收藏的剧集，这个工具都能自动为您的视频添加准确的标题、简介、海报等信息，使它们在Plex中看起来就像专业电影一样。它适合游戏主播、收藏家或任何希望将YouTube视频整理成规范媒体库的用户。
核心价值：将零散的YouTube视频转换为结构化的专业媒体库，自动获取官方元数据
快速上手#
安装难度：中 - 需要手动安装插件并设置API密钥
# 1. 下载Zip文件
wget https://github.com/ZeroQI/YouTube-Agent.bundle/archive/refs/heads/master.zip
# 2. 解压并重命名
unzip YouTube-Agent.bundle-master.zip
mv YouTube-Agent.bundle-master Youtube-Agent.bundle
# 3. 放置到插件目录
cp -r Youtube-Agent.bundle /path/to/Plex\ Media\ Server/Plug-ins/
# 4. 重启Plex服务器
适合我的场景吗？
- ✅ 游戏实况视频收藏：自动获取游戏信息、封面和描述
- ✅ 教程视频整理：为不同技术教程分类并添加元数据
- ❌ 大规模商业用途：可能受YouTube API配额限制
- ❌ 追求"开箱即用"：需要手动配置API密钥
核心能力#
1. 多种ID格式支持 - 识别各种YouTube视频ID#
支持多种命名格式，包括[xxxxxxxx]、[youtube-xxx]等，能在文件名中自动识别YouTube视频ID。
实际价值：无需重命名大量已下载的视频文件，只需确保ID在文件名中即可
2. 双重元数据源 - 本地与云端结合#
优先使用.info.json文件中的元数据，减少YouTube API调用；同时支持在线API获取最新信息。
实际价值：减少API配额消耗，加快加载速度，同时保证元数据新鲜度
3. 电影与剧集支持 - 全媒体格式#
同时支持电影和电视剧集两种媒体类型，为不同库提供专用代理（YoutubeMovie和YouTubeSeries）。 实际价值：一次安装，满足所有YouTube视频的整理需求，无需其他插件
技术栈与集成#
开发语言：Python（Plex代理插件常用） 主要依赖：YouTube Data API 集成方式：Plex插件系统
维护状态#
- 开发活跃度：活跃维护，定期更新以支持YouTube API变化
- 最近更新：持续修复问题并添加新功能
- 社区响应：通过GitHub和Plex论坛提供技术支持
商用与许可#
许可证：开源
- ✅ 商用：允许
- ✅ 修改：允许
- ⚠️ 限制：需遵守YouTube服务条款
文档与学习资源#
- 文档质量：全面
- 官方文档：内置README
- 示例代码：提供文件命名规范和目录结构示例