overseerr-request-media

🎬 智能媒体库请求助手

基于 Overseerr 生态的自动化媒体请求工具,通过自然语言一键提交电影/剧集下载需求,自动检测库中已存内容避免重复请求,完美集成 Sonarr/Radarr 工作流。

收藏
5.7k
安装
2k
版本
v1.0.0
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

Overseerr Request Media Skill 是一个面向自建媒体库用户的自动化请求工具,旨在通过自然语言交互简化影视内容获取流程。用户只需以日常用语表达观影需求(如"请求 Interstellar"或"添加 Reacher 第二季"),该技能即可自动解析意图,调用 Overseerr API 完成搜索、匹配、状态检查及请求提交的全流程。其核心工作流程包括七个严谨步骤:首先解析用户输入以提取标题、媒体类型及季数范围;随后通过 Overseerr 搜索接口查询 TMDB 元数据;当检测到同名电影与剧集并存时,智能提示用户进行歧义消除;基于流行度和精确匹配度算法选择最佳结果;关键地,在提交前自动检查媒体是否已存在于 Plex 库中或已被请求,有效避免重复;最终通过标准化 POST 请求将需求转发至后端的 Sonarr 或 Radarr 下载队列。

该技能的显著优势在于其深度集成的媒体生态适配能力与智能边界处理。作为 Overseerr 官方工作流的自然语言封装,它原生支持 Plex 媒体库实时状态检测,能精准识别"已可观看"和"处理中"状态,从源头上防止重复下载造成的存储与带宽浪费。对于剧集内容,它支持精细到具体季数的选择(如仅请求第 2-4 季而非全系列),这在管理长篇剧集时极具实用价值。其歧义处理机制体现了良好的产品思维——当检测到如《Dune》这类同名电影与剧集并存时,会主动展示选项请求用户确认,而非盲目自动选择,显著降低了误操作风险。

然而,该技能也存在结构性局限。首先,它完全依赖用户自行部署的 Overseerr 实例,对没有自建 NAS 或媒体服务器的普通用户具有极高的使用门槛。其次,作为个人开发者维护的 T3 来源项目,缺乏官方组织的长期维护背书与代码审计保障。功能性上,其搜索能力受限于 Overseerr 的 TMDB 索引质量,对于冷门内容或拼写变体可能存在匹配失败。此外,硬性依赖环境变量配置(OVERSEERR_URL 与 API_KEY)要求用户具备基础的技术运维能力,无法做到非技术用户的开箱即用。

此技能最适合已构建 Plex + Overseerr + Sonarr/Radarr 自动化媒体栈的技术型用户,特别是追求"对话式媒体管理"体验的家庭影院爱好者与 PT 站用户。对于管理大型共享媒体库(如家庭或小型团队)的管理员,它能显著降低为成员代劳请求内容的沟通成本。反之,依赖公共流媒体服务(如 Netflix、Disney+)或缺乏本地存储基础设施的用户无法从中获得任何价值。

使用风险主要集中于配置安全与依赖稳定性。用户必须确保 OVERSEERR_URL 指向可信的私有网络实例,一旦配置错误导致 API Key 泄露至公网,可能导致媒体库元数据甚至服务器访问权限暴露。虽然技能本身为纯文档型资产且不收集用户数据,但错误的网络配置可能将用户的观影偏好等敏感信息暴露给第三方。此外,该技能的功能完全耦合于 Overseerr 服务的可用性与 API 稳定性,若后者服务异常、网络不可达或接口版本变更,请求功能将立即失效。建议用户定期审查环境变量配置的准确性,为 API Key 设置最小权限原则,并在防火墙层面限制 Overseerr 实例的访问范围。

安全解读

核心用法

本Skill用于通过自然语言向用户的Overseerr实例提交媒体请求。Overseerr作为Sonarr/Radarr的前端管理工具,可自动判断内容是否已存在于Plex库中或已被请求。

典型指令示例

  • "Request Interstellar" → 请求电影《星际穿越》
  • "Request Reacher season 2" → 指定请求剧集第二季
  • "Request The Office seasons 2-4" → 批量请求多季

工作流程
1. 解析用户输入(标题、类型、季数范围)

2. 调用Overseerr搜索API匹配媒体

3. 若结果模糊(如同名电影与剧集),主动询问用户确认

4. 检查现有状态:已入库则提示"Already available",已请求则提示"Already requested"

5. 符合条件时通过POST请求创建任务,支持完整剧集或指定季数

显著优点

  • 智能去重:自动检测重复请求与已有资源,避免无效操作
  • 灵活粒度:支持整剧请求或精确到单季/多季选择
  • 零配置依赖:纯文档型Skill,无第三方依赖,仅连接用户自托管服务
  • 清晰反馈:状态图标(✅)与简洁确认,交互直观

局限与注意事项

  • 环境依赖:必须预先配置OVERSEERR_URL和OVERSEERR_API_KEY
  • 仅限本地:不支持公共Overseerr实例,需用户自建服务栈(Overseerr+Sonarr/Radarr+Plex)
  • 无搜索预览:用户无法先浏览再选择,需明确知道目标标题
  • 无进度跟踪:请求提交后由后台处理,Skill不返回下载/处理状态

适合人群

  • 已部署Plex+Overseerr+Sonarr/Radarr家庭媒体服务器的用户
  • 习惯语音/文字快捷添加下载任务的高阶用户
  • 希望简化"想看电影→手动搜索→点击请求"流程的自动化爱好者

常规风险

  • 密钥管理风险:API Key需通过环境变量注入,若配置不当存在泄露可能
  • 实例安全风险:Skill信任用户配置的任意URL,需确保Overseerr实例HTTPS启用且访问受控
  • 误请求风险:模糊匹配可能导致请求非目标内容,虽有多重确认机制但仍需用户核对
  • 来源维护风险:来自个人开发者账号,长期更新与社区支持存在不确定性

overseerr-request-media 内容

手动下载zip · 1.9 kB
SKILL.mdtext/markdown
请选择文件