overseerr-request-mediaRequest movies or TV shows on Overseerr by title and optional season, checking availability before forwarding the request to Sonarr or Radarr.
Install via ClawdBot CLI:
clawdbot install trialskid/overseerr-request-mediaRequest a movie or TV show using the user's Overseerr instance. Overseerr forwards the request to Sonarr/Radarr.
Environment variables:
Authentication header:
Overseerr can detect if media is already available or already requested based on your configured Plex + Sonarr/Radarr connections.
User examples:
Extract:
GET:
$OVERSEERR_URL/api/v1/search?query=
Example:
curl -s -H "X-Api-Key: $OVERSEERR_API_KEY" \
"$OVERSEERR_URL/api/v1/search?query=interstellar"
If the search results include BOTH:
with the same (or extremely similar) title,
THEN ask the user to choose before requesting.
Show 2-4 options max, like:
If the user provided an obvious hint like "movie", "show", "tv", "season 2", then pick the matching type automatically.
Rules:
Before creating a request:
If the API response does NOT clearly indicate status:
POST:
$OVERSEERR_URL/api/v1/request
Movie JSON:
{
"mediaType": "movie",
"mediaId":
}
TV JSON (full series):
{
"mediaType": "tv",
"mediaId":
}
TV JSON (specific seasons):
{
"mediaType": "tv",
"mediaId":
"seasons": [2,3]
}
Examples:
Movie:
curl -s -X POST \
-H "X-Api-Key: $OVERSEERR_API_KEY" \
-H "Content-Type: application/json" \
"$OVERSEERR_URL/api/v1/request" \
-d '{"mediaType":"movie","mediaId":157336}'
TV (full):
curl -s -X POST \
-H "X-Api-Key: $OVERSEERR_API_KEY" \
-H "Content-Type: application/json" \
"$OVERSEERR_URL/api/v1/request" \
-d '{"mediaType":"tv","mediaId":71912}'
TV (season 2):
curl -s -X POST \
-H "X-Api-Key: $OVERSEERR_API_KEY" \
-H "Content-Type: application/json" \
"$OVERSEERR_URL/api/v1/request" \
"$OVERSEERR_URL/api/v1/request" \
-d '{"mediaType":"tv","mediaId":71912,"seasons":[2]}'
Short confirmations:
Generated Mar 1, 2026
A user with a personal Plex media server uses this skill to request movies and TV shows via voice or text commands. They integrate Overseerr with Sonarr/Radarr for automated downloading, streamlining their media library expansion without manual searches.
A small office or coworking space employs this skill to allow employees to request media for shared entertainment areas. It ensures efficient management through Overseerr's duplicate detection, preventing redundant requests and optimizing resource usage.
A school or university uses the skill to request educational films and documentaries for classroom use. Librarians or teachers can quickly add media to their digital library, with Overseerr handling availability checks to avoid duplicates.
A hotel or vacation rental implements this skill for guests to request movies or shows during their stay. Staff can manage requests via Overseerr, enhancing guest experience by providing on-demand entertainment without manual intervention.
A community center or library uses the skill to let members request media for public screenings or lending. It automates the request process through Overseerr, ensuring efficient tracking and integration with existing media management systems.
Offer this skill as part of a premium subscription for home media enthusiasts, providing automated request handling and integration with Overseerr. Revenue comes from monthly fees, with tiers based on request limits or priority support.
License the skill to businesses in hospitality or corporate sectors for use in their internal systems. Charge a one-time setup fee plus annual maintenance, with customization options for branding and workflow integration.
Provide a basic version of the skill for free to individual users, with advanced features like bulk requests or analytics available in a paid tier. Monetize through upsells and partnerships with media management platforms.
π¬ Integration Tip
Ensure environment variables are securely configured and test Overseerr API connectivity before deployment to avoid request failures.
Terminal Spotify playback/search via spogo (preferred) or spotify_player.
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
Download videos from YouTube, Bilibili, Twitter, and thousands of other sites using yt-dlp. Use when the user provides a video URL and wants to download it, extract audio (MP3), download subtitles, or select video quality. Triggers on phrases like "δΈθ½½θ§ι’", "download video", "yt-dlp", "YouTube", "Bη«", "ζι³", "ζει³ι’", "extract audio".
Search and add movies to Radarr. Supports collections, search-on-add option.
Control Spotify playback on macOS. Play/pause, skip tracks, control volume, play artists/albums/playlists. Use when a user asks to play music, control Spotify, change songs, or adjust Spotify volume.
Search and add TV shows to Sonarr. Supports monitor options, search-on-add.