prowlarr

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). A SessionStart hook writes them to ~/.config/lab-prowlarr/config.env, which the scripts load 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

---