prowlarr

name

prowlarr

description

This skill should be used when the user asks to search torrent or usenet indexers, find a release (by title, TVDB/IMDB/TMDB id), list or check indexer health/status, test indexers, enable/disable/delete an indexer, sync indexers to Sonarr or Radarr, connect Prowlarr to another app, or mentions Prowlarr or indexer management. Only use this if the yarr MCP server is unavailable — prefer the consolidated `yarr` skill when it's configured and reachable.

Prowlarr Skill

Search across all your indexers and manage Prowlarr via API.

Purpose

This skill provides read and write access to your Prowlarr indexer aggregation:

• Search for releases across all configured indexers
• Filter searches by protocol (torrent/usenet) and category
• List and monitor indexer health and statistics
• Enable/disable/delete indexers
• Sync indexer configurations to connected apps (Sonarr, Radarr)
• Test indexer connectivity

Operations include both read and write actions. Always confirm before deleting or disabling indexers.

Setup

Credentials are configured in the plugin settings (userConfig). The plugin setup script writes them to ~/.config/lab-prowlarr/config.json, which the scripts parse automatically — no manual file editing. Variables used:

PROWLARR_URL="http://localhost:9696"
PROWLARR_API_KEY="your-api-key"

Get your API key from: Prowlarr → Settings → General → Security → API Key

---

Quick Reference

Search Releases

# Basic search across all indexers
./scripts/prowlarr-api.sh search "ubuntu 22.04"

# Search torrents only
./scripts/prowlarr-api.sh search "ubuntu" --torrents

# Search usenet only
./scripts/prowlarr-api.sh search "ubuntu" --usenet

# Search specific categories (2000=Movies, 5000=TV, 3000=Audio, 7000=Books)
./scripts/prowlarr-api.sh search "inception" --category 2000

# TV search with TVDB ID
./scripts/prowlarr-api.sh tv-search --tvdb 71663 --season 1 --episode 1

# Movie search with IMDB ID
./scripts/prowlarr-api.sh movie-search --imdb tt0111161

# Movie search with TMDB ID
./scripts/prowlarr-api.sh movie-search --tmdb 27205

# Cap results / set the search type
./scripts/prowlarr-api.sh search "ubuntu" --limit 25 --type search

List Indexers

# All indexers
./scripts/prowlarr-api.sh indexers

# With status details
./scripts/prowlarr-api.sh indexers --verbose

Indexer Health & Stats

# Usage stats per indexer
./scripts/prowlarr-api.sh stats

# Test all indexers
./scripts/prowlarr-api.sh test-all

# Test specific indexer
./scripts/prowlarr-api.sh test <indexer-id>

Indexer Management

# Enable/disable an indexer
./scripts/prowlarr-api.sh enable <indexer-id>
./scripts/prowlarr-api.sh disable <indexer-id>

# Delete an indexer
./scripts/prowlarr-api.sh delete <indexer-id>

App Sync

# Sync indexers to Sonarr/Radarr/etc
./scripts/prowlarr-api.sh sync

# List connected apps
./scripts/prowlarr-api.sh apps

System

# System status
./scripts/prowlarr-api.sh status

# Health check
./scripts/prowlarr-api.sh health

---

Search Categories

ID	Category
2000	Movies
5000	TV
3000	Audio
7000	Books
1000	Console
4000	PC
6000	XXX

Sub-categories: 2010 (Movies/Foreign), 2020 (Movies/Other), 2030 (Movies/SD), 2040 (Movies/HD), 2045 (Movies/UHD), 2050 (Movies/BluRay), 2060 (Movies/3D), 5010 (TV/WEB-DL), 5020 (TV/Foreign), 5030 (TV/SD), 5040 (TV/HD), 5045 (TV/UHD), etc.

---

Common Use Cases

"Search for the latest Ubuntu ISO"

./scripts/prowlarr-api.sh search "ubuntu 24.04"

"Find Game of Thrones S01E01"

./scripts/prowlarr-api.sh tv-search --tvdb 121361 --season 1 --episode 1

"Search for Inception in 4K"

./scripts/prowlarr-api.sh search "inception 2160p" --category 2045

"Check if my indexers are healthy"

./scripts/prowlarr-api.sh stats
./scripts/prowlarr-api.sh test-all

"Push indexer changes to Sonarr/Radarr"

./scripts/prowlarr-api.sh sync

Workflow

When the user asks about indexers or searches:

1. "Search for a torrent" → Run search "<query>" and present results with download links
2. "Find Breaking Bad S01E01" → Run tv-search --tvdb <id> --season 1 --episode 1
3. "Which indexers are working?" → Run stats to show indexer health and usage
4. "Test all my indexers" → Run test-all to verify connectivity
5. "Sync indexers to Sonarr" → Run sync to push configuration changes
6. "List available indexers" → Run indexers or indexers --verbose

Notes

• Requires network access to your Prowlarr server
• Uses Prowlarr API v1
• All data operations return JSON
• Search operations query external indexers - respect rate limits
• Indexer deletion is permanent - always confirm before removing
• Sync operations push indexer configs to all connected apps (Sonarr, Radarr, Lidarr, etc.)
• Category IDs follow Newznab/Torznab standards

Local References

• references/quick-reference.md — common Prowlarr curl and helper examples
• references/api-endpoints.md — endpoint catalog and request shapes
• references/troubleshooting.md — connectivity, auth, and indexer failure diagnosis

---