零依赖的媒体请求管家

基于原生Node.js的Overseerr媒体请求管理工具，零第三方依赖，安全透明，实现电影/剧集搜索、请求提交与状态监控的自动化流程。

基本信息

• 技能名称?overseerr
• 中文名称?零依赖的媒体请求管家
• 作者?j1philli
• 分类?专业技能
• 版本?v0.1.0
• 标签?content-media, automation, api, self-hosted, productivity

使用方法

使用说明
核心用法
Overseerr Skill 是一款面向自托管媒体服务器用户的命令行工具，通过 Node.js 脚本与 Overseerr API 交互，实现媒体内容的搜索、请求提交和状态监控三大核心功能。用户需预先配置 OVERSEERR_URL 和 OVERSEERR_API_KEY 环境变量，即可通过 CLI 完成以下操作：
搜索功能 ：支持电影和电视节目的关键词搜索，可按类型过滤（ --type tv/movie ）并限制返回结果数量（ --limit ）。 请求功能 ：支持精确请求指定媒体内容，包括电影请求、电视剧全季或指定季请求（ --seasons 1,2 ），以及 4K 版本标记（ --is4k ）。 状态监控 ：提供请求列表查询（支持 pending/processing 等状态过滤）、单条请求详情查看，以及定时轮询监控（ --interval 秒级间隔）。
显著优点

1. 零依赖架构 ：仅使用 Node.js 原生内置 API（fetch、process.env 等），无 package.json 和 node_modules，彻底消除供应链攻击风险，代码完全透明可审计。
2. 安全设计完善 ：实现 CSRF 保护、输入参数严格校验（parseArgs/toInt/parseCsvInts）、URL 编码处理（encodeURIComponent），错误处理机制避免敏感信息泄露。
3. 功能边界清晰 ：专注 Overseerr 稳定版 API，明确排除 beta 版 Seerr 重写项目，避免版本兼容性问题。
4. 部署轻量 ：单脚本文件即可运行，适合嵌入式场景和容器化部署。
   潜在缺点与局限性
   来源可信度限制 ：由个人开发者维护（T3 来源），非 Overseerr 官方团队出品，企业级支持能力有限。
   功能覆盖范围 ：仅支持核心请求管理，不包含 Overseerr 的用户管理、通知配置等高级功能。
   交互模式单一 ：纯 CLI 交互，无图形界面或交互式 TUI，对非技术用户不够友好。
   轮询效率 ：监控功能基于客户端轮询，非服务端推送，高频轮询可能对 Overseerr 实例造成轻微负载。
   适合的目标群体
   家庭媒体服务器管理员 ：运行 Jellyfin/Plex + Overseerr 组合的自托管用户
   自动化工作流构建者 ：需要将媒体请求集成到现有脚本或 CI/CD 流程的开发者
   隐私敏感型用户 ：追求零第三方依赖、完全可控的本地工具
   技术爱好者 ：熟悉 Node.js 和命令行操作，希望深度定制媒体管理流程
   使用风险
   配置依赖风险 ：功能完全依赖正确配置的环境变量，配置错误将导致 API 连接失败
   网络暴露风险 ：若 Overseerr 实例通过公网访问，建议强制 HTTPS 并妥善保管 API Key
   版本锁定风险 ：Overseerr API 未来变更可能导致兼容性问题，需关注 skill 更新
   权限边界风险 ：API Key 权限等同于 Overseerr 用户权限，需遵循最小权限原则配置
   content-media automation api self-hosted productivity