Overseerr 技能用于与本地或自托管的 Overseerr 实例进行交互,主要覆盖搜索、请求和状态查询三类操作。该技能面向当前稳定版 Overseerr 项目,而非处于测试阶段的新版 Seerr 重写版本。
用途 该技能适合在自托管媒体环境中,通过命令行脚本快速搜索影视内容、向 Overseerr 提交媒体请求,并跟踪请求的处理状态。
主要能力
- 搜索:可按关键词搜索影视内容,支持指定类型(如 tv)和结果数量限制。
- 请求:可发起电影或剧集请求,剧集支持请求全部季(默认)或指定季(如 1,2),并支持 4K 请求。
- 状态查询:可按状态筛选请求列表(如 pending、processing),支持数量限制,也可按请求 ID 查询单条请求。
- 监控:提供轮询脚本,可按指定间隔和状态筛选持续监控请求。
使用方式 首先设置环境变量,推荐通过 Clawdbot 配置完成:
- OVERSEERR_URL(示例:http://localhost:5055)
- OVERSEERR_API_KEY(在 Settings → General → API Key 中获取)
搜索示例: node {baseDir}/scripts/search.mjs "the matrix" node {baseDir}/scripts/search.mjs "bluey" --type tv node {baseDir}/scripts/search.mjs "dune" --limit 5
请求示例: node {baseDir}/scripts/request.mjs "Dune" --type movie node {baseDir}/scripts/request.mjs "Bluey" --type tv --seasons all node {baseDir}/scripts/request.mjs "Severance" --type tv --seasons 1,2 node {baseDir}/scripts/request.mjs "Oppenheimer" --type movie --is4k
状态查询示例: node {baseDir}/scripts/requests.mjs --filter pending node {baseDir}/scripts/requests.mjs --filter processing --limit 20 node {baseDir}/scripts/request-by-id.mjs 123
监控示例: node {baseDir}/scripts/monitor.mjs --interval 30 --filter pending
适用场景 适用于已部署 Overseerr 的自托管媒体服务器用户,希望通过脚本或自动化方式搜索媒体、提交请求并跟踪请求进度。
限制 该技能使用 X-Api-Key 认证。Overseerr 也支持通过 webhook 推送更新,但本技能采用轮询作为简单基线方案。该技能针对稳定版 Overseerr,不适用于测试版 Seerr 重写版本。