核心用法
Seerr skill 是一套面向家庭媒体服务器的自动化请求工具,基于 Overseerr 的 API 封装而成。用户通过自然语言指令即可完成电影/剧集的搜索、状态查询和下载请求,全程无需登录 Web 界面。
典型交互流程:
1. 用户发送"下载《沙丘2》"或"找一下继承之战"
2. Skill 调用 /api/v1/search 检索 TMDB 数据,返回前3个匹配结果
3. 向用户展示标题、年份、简介及当前状态(未请求/处理中/已可用)
4. 确认后通过 POST /api/v1/request 提交请求,电影路由至 Radarr,剧集路由至 Sonarr
5. 对于剧集会询问全季或指定季,支持 seasons: "all" 或 seasons: [1,3] 两种模式
Discord 增强体验: 支持 Discord 交互卡片,以 URL 按钮直接跳转 Seerr 请求页,配合状态徽章(✅/⏳/🔄)实现零输入操作。
显著优点
- 生态整合度极高:原生对接 Radarr/Sonarr/Plex/Emby 全家桶,是 *arr 生态的标准前端
- 权限体系完善:Seerr 内置用户等级、配额、审批流,Skill 继承其安全边界
- 状态追踪透明:
mediaInfo.status字段实时反馈 5 级状态,避免重复请求 - 多模态交互:同时支持文本对话和 Discord 富媒体卡片,适应不同场景
- 零代码配置:仅需 URL 和 API Key 两个环境变量,无复杂认证流程
潜在局限与风险
- 依赖自托管基础设施:必须已有 Seerr+Radarr/Sonarr 运行实例,纯云用户无法使用
- 网络暴露面:若 SEERR_URL 指向公网,API Key 泄露可导致媒体库被恶意填充
- 下载合法性边界:Skill 本身不校验内容版权,最终下载行为由后端 *arr 工具执行,用户需自行确保合规
- TMDB 数据延迟:搜索依赖 TheMovieDatabase,中文译名匹配偶有偏差
- 无原生删除/管理功能:仅支持请求新增,无法通过 Skill 取消或管理已有任务
适合人群
- 已搭建 *arr 媒体栈的 NAS/服务器用户
- 希望通过聊天机器人简化家庭影院管理的进阶用户
- Discord 社群管理员,希望为成员提供自助媒体请求通道
常规风险提示
- 建议使用反向代理 + HTTPS 保护 SEERR_URL,避免明文传输 API Key
- 定期轮换 API Key,尤其在 Discord 等公共频道启用交互功能时
- 配合 Seerr 的"请求审批"功能使用,防止自动化滥用
- 注意 Radarr/Sonarr 的下载目录权限,避免容器/系统层面的越权访问