# Overseerr

> Request movies/TV and monitor request status via the Overseerr API (stable Overseerr, not the beta Seerr rewrite).

- Skill: `modbender/overseerr` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add modbender/overseerr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/overseerr/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/overseerr

---


# 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

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

## Request

```bash
# 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

```bash
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)

```bash
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.