overseerr

用途：通过 Overseerr API 管理媒体请求，可搜索电影与电视剧、提交新请求、查看请求状态（pending、processing、available）、监控请求进度，并支持 4K 请求。该技能面向 Overseerr 稳定版，而非处于测试阶段的新版 Seerr 重写版。\n\n主要能力：搜索电影或剧集（可过滤类型与结果数量）；按剧集类型、季数或 4K 提交请求；查询待处理、处理中、可用等状态的请求；按请求 ID 获取详情；获取带媒体元数据的增强请求信息；以轮询方式持续监控状态。\n\n使用方式：先将凭据加入 ~/.homelab-skills/.env，设置 OVERSEERR_URL（无尾斜杠）与 OVERSEERR_API_KEY（Overseerr 设置 → 常规 → API Key 获取）。命令均通过 Node.js 脚本运行并返回 JSON，例如：node scripts/search.mjs "the matrix"、node scripts/request.mjs "Dune" --type movie、node scripts/request.mjs "Bluey" --type tv --seasons all、node scripts/requests.mjs --filter pending、node scripts/monitor.mjs --interval 30 --filter pending。请求流程为：搜索、展示 TMDB/TVDB 链接供用户确认、提交请求、随后查询状态或等待通知。多个服务器可通过覆盖 OVERSEERR_URL 与 OVERSEERR_API_KEY 环境变量实现。\n\n限制与注意：需要能访问 Overseerr 服务器网络，使用 X-Api-Key 头认证；实际下载由 Overseerr 协调 Sonarr/Radarr 完成；4K 请求需在 Overseerr 中配置好 4K 质量配置文件；轮询是基础方案，也可用 webhook 推送状态。资料未提供离线使用或价格信息。