核心用法
Overseerr 技能通过 Node.js 脚本与自托管的 Overseerr 实例交互，提供完整的影视内容管理流水线：
- 搜索发现：支持电影/剧集模糊搜索，可按类型过滤并限制返回结果数量
- 智能请求：支持标准/4K 画质请求，电视剧可指定全季或特定季数
- 状态追踪：查看待处理、处理中、已完成等请求状态，支持按 ID 查询详情
- 轮询监控：内置定时轮询机制，可自动跟踪请求进度变化
显著优点
1. 生态兼容：直接对接 Overseerr 稳定版（非 beta 的 Seerr 重写版），与主流媒体栈（Plex、Radarr、Sonarr）无缝协作
2. 请求精细化：支持分季请求和 4K 分离策略，避免存储浪费
3. 低门槛部署：纯 Node.js 实现，仅需 URL 和 API Key 即可运行
4. Webhook 就绪：虽默认使用轮询，但架构预留 webhook 扩展能力
潜在缺点
- 仅限自托管：无法用于公共 Overseerr 实例，需用户自行部署完整媒体自动化链路
- 轮询效率：默认 30 秒间隔可能产生多余 API 调用，高频监控场景建议改 webhook
- 无内置审批：脚本直接提交请求，绕过了 Overseerr 的网页端人工审核流程
- Node 依赖：运行环境需预装 Node.js，轻量场景略显沉重
适合人群
- 已搭建 Plex/Emby + Radarr/Sonarr 链路的家庭 NAS 用户
- 希望用命令行/自动化脚本批量管理媒体请求的技术爱好者
- 需要为家人/朋友提供简化请求入口而不暴露完整管理后台的管理员
常规风险
| 风险项 | 说明 |
|--------|------|
| 密钥暴露 | `OVERSEERR_API_KEY` 需妥善保管，泄露可能导致未授权请求 |
| 存储膨胀 | 自动化脚本可能误触大容量 4K 请求，建议配合 Overseerr 用户配额 |
| 网络暴露 | 若 `OVERSEERR_URL` 使用公网地址且未配 TLS，API 通信可能被窃听 |
| 请求冲突 | 多人同时自动化请求可能触发 Overseerr 的速率限制或重复下载 |