Seerr server manager

Seerr媒体请求管理API的命令行工具。搜索电影和电视节目,创建和管理媒体请求,管理用户,跟踪问题,以及管理Seerr。

安装

概览

什么是Seerr server manager

Seerr server manager(简称 seerr-cli)是一款专为 Seerr 媒体请求管理系统设计的命令行接口工具,旨在为开发者、系统管理员和高级用户提供对 Seerr 实例的自动化操作能力。Seerr 本身是一个基于 Radarr/Sonarr 的媒体请求管理平台,允许用户通过网页界面提交电影或电视剧的请求,并由自动化流程处理下载与整理。而 seerr-cli 则将这些功能封装为可直接在终端中执行的指令,极大提升了批量管理、脚本集成和远程运维的效率。该工具支持 Linux 和 macOS 平台(包括 amd64 和 arm64 架构),可通过预编译二进制文件直接安装,也提供 Docker 容器化部署方案,便于在各类环境中快速启动服务。无论是本地开发调试还是生产环境中的 CI/CD 集成,seerr-cli 都能无缝对接现有的媒体服务器生态。其核心设计理念是简洁高效——所有命令均返回结构化 JSON 数据,方便与其他工具链联动,同时支持详细日志输出以辅助故障排查。

核心功能特点

  1. 支持搜索电影、电视节目、人物及制作公司等 TMDB 元数据,支持分页与多维度筛选(如类型、工作室、网络等)
  2. 可创建和管理媒体请求,包括按季请求剧集、指定 4K 版本、审批/拒绝/重试现有请求等完整生命周期控制
  3. 具备用户管理功能,支持从 Plex/Jellyfin 导入用户、设置配额、重置密码以及批量更新权限
  4. 提供问题追踪机制,允许创建、评论、解决与删除媒体相关的问题报告
  5. 支持 watchlist(想看清单)与 blocklist(屏蔽列表)管理,增强个性化推荐过滤能力
  6. 内置 MCP(Model Context Protocol)服务端模式,可将 Seerr API 暴露为 AI 助手可调用的工具集,适用于 Claude Desktop 等智能体场景

适用场景

seerr-cli 特别适合需要高频次或自动化操作的媒体服务器运维场景。例如,家庭影院管理员希望每周自动抓取热门新片并批量提交请求,可通过编写 shell 脚本调用 `search trending` 获取趋势影片,再结合 `request create` 完成自动化入库;或者当某部剧集因质量不佳被多次投诉时,管理员可用 `issue create` 记录问题并通知维护人员,后续通过 `issue update-status` 跟踪处理进度。对于拥有多个用户账户的共享媒体库,管理员可通过 `users import-from-plex` 快速同步家庭成员信息,并利用 `users quota` 限制每位用户的年度请求次数,避免资源滥用。此外,在构建智能家居自动化系统时,seerr-cli 的 MCP 模式尤为实用:用户可在不暴露主 API 密钥的前提下,让家中的智能音箱或语音助手通过 Claude 代理间接发起媒体请求,实现‘Hey Siri, 我想看《黑镜》’这类自然语言交互体验。Docker 部署方式也让其在 Kubernetes 或 Home Assistant 等容器编排平台中轻松集成,形成端到端的媒体管理解决方案。