overseerr

SKILL.md

Overseerr

Interact with a local/self-hosted Overseerr instance (search + request + status).

Note: This skill targets Overseerr (the current stable project), not the newer "Seerr" rewrite that is in beta.

Setup

Set env vars (recommended via your Clawdbot config):

  • OVERSEERR_URL (example: http://localhost:5055)
  • OVERSEERR_API_KEY (Settings → General → API Key)

Search

node {baseDir}/scripts/search.mjs "the matrix"
node {baseDir}/scripts/search.mjs "bluey" --type tv
node {baseDir}/scripts/search.mjs "dune" --limit 5

Request

# movie
node {baseDir}/scripts/request.mjs "Dune" --type movie

# tv (optionally all seasons, default)
node {baseDir}/scripts/request.mjs "Bluey" --type tv --seasons all

# request specific seasons
node {baseDir}/scripts/request.mjs "Severance" --type tv --seasons 1,2

# 4K request
node {baseDir}/scripts/request.mjs "Oppenheimer" --type movie --is4k

Status

node {baseDir}/scripts/requests.mjs --filter pending
node {baseDir}/scripts/requests.mjs --filter processing --limit 20
node {baseDir}/scripts/request-by-id.mjs 123

Monitor (polling)

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

Notes:

  • This skill uses X-Api-Key auth.
  • Overseerr can also push updates via webhooks; polling is a simple baseline.
Weekly Installs
4
Repository
clawdbot/skills
Installed on
opencode3
windsurf2
clawdbot2
trae2
codex2
claude-code2