Overseerr影视请求

技能简介

通过Overseerr API实现电影和电视剧的请求提交、搜索查询及状态跟踪，适用于自建媒体库环境下的内容管理。

业务背景

自建媒体库团队常面临成员分散提交需求、进度不透明的问题。该技能打通Overseerr与协作平台，让业务人员无需登录多个系统即可统一提交影视请求、实时追踪处理状态，减少沟通成本，提升内容获取效率。

落地案例：市场部策划季度观影活动，需批量准备经典商战剧集。成员在聊天窗口直接搜索《广告狂人》，指定第1-3季及4K画质提交请求；系统自动返回请求ID并定时轮询，当状态变为"已完成"时自动提醒负责人，无需反复登录媒体库后台确认。

能做什么

• 搜索电影和电视剧信息
• 提交影视内容下载请求（支持指定季数、4K画质）
• 查看请求处理状态（待处理/处理中/已完成）
• 定时轮询监控请求进度

使用说明

环境配置

在Clawdbot配置中设置以下环境变量：

• OVERSEERR_URL：实例地址，如 http://localhost:5055
• OVERSEERR_API_KEY：从Overseerr后台「Settings → General → API Key」获取

安装依赖

需预先安装 Node.js 运行时环境。

基本操作

搜索内容：

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

# 4K画质请求
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

定时监控（每30秒轮询）：

node {baseDir}/scripts/monitor.mjs --interval 30 --filter pending

输入与输出

见下方输入与输出表格。

风险提示

• API密钥需妥善保管，避免泄露导致未授权访问
• 轮询频率过高可能增加服务器负载，建议根据实际需求调整间隔
• 该技能仅兼容稳定版Overseerr，不支持beta版Seerr重写项目
• Webhook推送方式未在本技能中实现，如需实时通知需额外配置

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/j1philli/overseerr/SKILL.md
来源类型：GitHub仓库