Overseerr Request Media for Openclaw

A specialized tool for automating movie and TV show requests through your personal Overseerr instance using natural language.

trialskid
v1.0.0
Jan 27, 2026
2
2.2k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install overseerr-request-media

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install overseerr-request-media using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Overseerr Request Media?

The Overseerr Request Media skill allows users to interact with their self-hosted media management stacks using simple voice or text commands. By integrating with Openclaw Skills, this tool bridges the gap between a user's intent and their media server, handling the entire request lifecycle from title search to final confirmation. It simplifies the process of adding content to Sonarr or Radarr without needing to manually log into a web interface.

This integration is a powerful addition to the library of Openclaw Skills, ensuring your media collection stays up to date with minimal effort. Whether you are looking for the latest blockbuster or a specific season of a cult classic, this skill handles the technical heavy lifting of API interaction, metadata matching, and duplicate checking to ensure a seamless experience for home theater enthusiasts.

Overseerr Request Media Use Cases

  • Requesting a specific movie by title quickly through a chat interface.
  • Adding an entire TV series to your automated download queue.
  • Requesting specific seasons of a show, such as "Season 2" or "Seasons 1-3".
  • Checking if a piece of media is already available in Plex or previously requested by another user.

How Overseerr Request Media Works

  1. Parse the user's natural language input to extract the title, media type (movie or tv), and optional season numbers.
  2. Perform a search against the Overseerr API using the urlencoded title to find potential matches.
  3. Resolve ambiguity by asking the user for clarification if multiple high-confidence matches (e.g., a movie and show with the same name) are found.
  4. Select the best match based on popularity and exact title matches while respecting user-provided hints.
  5. Verify the current availability or request status within the Overseerr database to prevent duplicate entries.
  6. Submit the final POST request to the Overseerr API with the appropriate media ID and season metadata.
  7. Provide a clean, short confirmation response indicating the success or status of the request.

Overseerr Request Media Setup

To use this within the ecosystem of Openclaw Skills, you must configure your environment with your specific instance details. Set the following environment variables:

export OVERSEERR_URL="https://overseerr.yourdomain.com"
export OVERSEERR_API_KEY="your_api_key_here"

Ensure your Overseerr instance is correctly networked and has active connections to your Plex, Sonarr, and Radarr servers to ensure requests are processed correctly upon submission.

Overseerr Request Media Data Schema & Taxonomy

The skill interacts with the Overseerr API v1 using structured JSON payloads. Below is the primary schema used for requests:

Field Description Type
mediaType Categorizes the request as either 'movie' or 'tv' String
mediaId The TMDB ID of the selected content Integer
seasons Array of specific season numbers for TV requests Array (Optional)

The skill also parses response metadata to check for library availability and pending request indicators to maintain database integrity.

Overseerr Request Media Advanced Features

  • Intelligent type hinting that automatically switches between movie and TV modes based on context like "seasons".
  • Advanced duplicate prevention logic that inspects current library status before sending new requests.
  • Multi-season range support allowing for granular control over TV show acquisitions.
  • Automated disambiguation workflows that present the 2-4 most relevant options to the user when search results are unclear.
  • Native support for the Openclaw Skills framework for high-speed API interactions.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*