Request media on Overseerr

在 Overseerr 按标题(可选季)请求影片或剧集,转发至 Sonarr 或 Radarr 前先检查可用性。

安装

概览

Overseerr Request Media Skill 是一个专为媒体管理系统设计的智能技能工具,旨在让用户通过自然语言指令快速向 Overseerr 实例请求电影或电视剧。用户只需说出影片名称(如《星际穿越》)、剧集名称及具体季数(如《猎魔人 第二季》),该技能便会自动解析需求并调用 Overseerr API 完成请求流程。在转发请求至 Sonarr 或 Radarr 之前,系统会先检查目标内容是否已在媒体库中可用,或者是否已有待处理中的请求,从而避免重复操作和资源浪费。整个交互过程高度自动化,同时保留了必要的澄清机制,确保请求准确无误。 该技能的核心运行逻辑包括五个关键步骤:首先对用户输入进行语义解析,提取出标题、类型(电影/剧集)以及可选的季数范围;接着通过 Overseerr 的搜索接口获取匹配结果;若存在同名电影与剧集等歧义情况,则会主动询问用户以确认意图;随后根据精确度、流行度和用户提示选择最佳匹配项;最后判断该内容是否已存在或已被请求,仅在必要时发起新请求。这种严谨的设计既提升了用户体验,也保障了后端系统的稳定性。 值得注意的是,本技能完全依赖 Overseerr 提供的 RESTful API 实现功能,所有操作均需配置正确的访问地址(OVERSEERR_URL)和 API 密钥(OVERSEERR_API_KEY),并通过 X-Api-Key 头进行身份验证。它适用于任何已部署 Overseerr 并与 Plex、Sonarr/Radarr 成功集成的家庭影音环境,尤其适合追求高效媒体管理且偏好语音或快捷命令操作的用户群体。

核心功能特点

  1. 支持自然语言请求电影或电视剧,自动识别标题与类型
  2. 可指定单季或多季请求,灵活满足部分下载需求
  3. 自动检测内容是否已存在于媒体库或已有待处理请求
  4. 处理同名作品歧义问题,主动引导用户选择正确条目
  5. 基于 TMDB ID 精准匹配,优先选择高热度或完全匹配的结果

适用场景

对于拥有自建家庭影院系统的技术爱好者而言,Overseerr Request Media Skill 提供了一种无缝衔接语音助手与媒体服务器的解决方案。例如,当用户在家中客厅使用智能音箱发出‘我想看《黑暗骑士》’时,该技能能迅速定位到对应电影并完成请求,无需手动打开网页或输入复杂参数。这种场景特别适合追求便捷性和沉浸感的现代数字生活,让媒体获取变得像点外卖一样简单直接。 另一个典型应用场景是批量添加经典剧集系列。假设用户希望一次性请求《办公室》的前三季,传统方式可能需要逐个查找并分别提交请求,而使用此技能只需一句‘请求《办公室》第一季到第三季’即可全部搞定。此外,在面对类似《星际穿越》这类既有电影又有相关纪录片的作品时,系统会主动提示用户区分类型,防止误操作。这些设计极大提升了多季剧集管理和模糊查询时的准确性,显著减少人工干预成本。 在日常使用中,无论是临时想看某部热门电影填补空闲时间,还是计划补全某个长期关注的剧集系列,该技能都能快速响应并给出明确反馈。即使搜索结果为空或存在多个相似选项,它也会友好地建议用户提供更多信息或从有限选项中做出选择,确保每次请求都有据可依。因此,它不仅是一个自动化工具,更是一种智能化的媒体管家服务,广泛应用于个人娱乐、家庭共享乃至小型影视工作室的日常运营之中。