Radarr

Interact with Radarr (movie manager) via its REST API. Use when searching for movies, checking missing/wanted titles, triggering downloads, or monitoring que...

Security Scan

Instruction-only Radarr skill that talks to a local Radarr REST API and expects a local API key file — its requirements and instructions are consistent with its stated purpose and it does not request unrelated privileges or external installs.

Purpose & Capability

Name/description match the SKILL.md: all actions are Radarr REST API calls (search, add, queue, wanted). The skill does not request unrelated credentials, binaries, or install steps.

Instruction Scope

Instructions run curl and small python JSON parsers against http://localhost:7878 and read an API key from a local file. This is within scope for a Radarr integration, but the doc uses a placeholder (/path/to/radarr_api_key) while recommending ~/clawd/credentials/radarr_api_key — minor inconsistency the integrator should resolve. The skill assumes Radarr is reachable on localhost:7878.

Install Mechanism

No install spec or code files are present; this is instruction-only so nothing is downloaded or written by the skill itself.

Credentials

No declared environment variables or external credentials are required. Reading a local Radarr API key file is appropriate and proportional for this purpose.

Persistence & Privilege

Skill is not always-enabled and does not request persistent/privileged platform changes. It does execute shell commands at runtime (curl, python) which is expected for this type of integration.

Assessment

This skill appears to do exactly what it says: call a local Radarr REST API and use an API key stored in a local file. Before installing, verify: (1) Radarr is actually reachable at the configured URL (the SKILL.md assumes http://localhost:7878 — change if Radarr is remote); (2) the API key file path is correct (the doc shows a placeholder and also suggests ~/clawd/credentials/radarr_api_key — pick a secure path and fix the instructions); (3) the agent running the skill has appropriate file permissions to read the key but no broader access; (4) you are comfortable with the agent executing curl/python commands locally (the skill performs no external network calls besides the local host). Consider storing the API key in a secrets manager or restricting file permissions (600) if you need stronger protection.

Radarr Skill

Radarr is the *arr-suite manager for movies. It monitors a watchlist, finds releases via indexers (Prowlarr), sends them to a download client, and organises them on disk.

Connection

Radarr runs on Dozo at http://localhost:7878.

RADARR_URL="http://localhost:7878"
RADARR_KEY=$(cat /path/to/radarr_api_key)

See references/api.md for all endpoints.

Core Workflows

Search and add a movie

# 1. Look up by title (returns TMDB results)
curl -s "$RADARR_URL/api/v3/movie/lookup?term=The+Matrix" \
  -H "X-Api-Key: $RADARR_KEY" | python3 -c "
import sys,json
results = json.load(sys.stdin)
for m in results[:5]:
    print(m.get('title'), '| tmdbId:', m.get('tmdbId'), '| year:', m.get('year'))
"

# 2. Get quality profiles and root folders
curl -s "$RADARR_URL/api/v3/qualityprofile" -H "X-Api-Key: $RADARR_KEY"
curl -s "$RADARR_URL/api/v3/rootfolder" -H "X-Api-Key: $RADARR_KEY"

# 3. Add the movie
curl -s -X POST "$RADARR_URL/api/v3/movie" \
  -H "X-Api-Key: $RADARR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tmdbId":603,"title":"The Matrix","qualityProfileId":1,"rootFolderPath":"/movies","monitored":true,"addOptions":{"searchForMovie":true}}'

Check wanted/missing movies

curl -s "$RADARR_URL/api/v3/wanted/missing?pageSize=20" \
  -H "X-Api-Key: $RADARR_KEY" | python3 -c "
import sys,json
d = json.load(sys.stdin)
for m in d.get('records',[]):
    print(m.get('title'), '(', m.get('year'), ')')
"

Trigger search for all missing movies

curl -s -X POST "$RADARR_URL/api/v3/command" \
  -H "X-Api-Key: $RADARR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"MissingMoviesSearch"}'

Check download queue

curl -s "$RADARR_URL/api/v3/queue" -H "X-Api-Key: $RADARR_KEY" | python3 -c "
import sys,json
q = json.load(sys.stdin)
for item in q.get('records',[]):
    print(item.get('title'), '|', item.get('status'), '|', item.get('timeleft','?'))
"

Credentials

Store API key at ~/clawd/credentials/radarr_api_key (single line, no newline). Load with: RADARR_KEY=$(cat /path/to/radarr_api_key)