| name | prowlarr |
| description | This skill should be used when the user asks to search indexers, find a release, check indexer status, list indexers, sync indexers to Sonarr or Radarr, connect Prowlarr to another app, or mentions Prowlarr or indexer management. |
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
./scripts/prowlarr-api.sh search "ubuntu 22.04"
./scripts/prowlarr-api.sh search "ubuntu" --torrents
./scripts/prowlarr-api.sh search "ubuntu" --usenet
./scripts/prowlarr-api.sh search "inception" --category 2000
./scripts/prowlarr-api.sh tv-search --tvdb 71663 --season 1 --episode 1
./scripts/prowlarr-api.sh movie-search --imdb tt0111161
./scripts/prowlarr-api.sh movie-search --tmdb 27205
./scripts/prowlarr-api.sh search "ubuntu" --limit 25 --type search
List Indexers
./scripts/prowlarr-api.sh indexers
./scripts/prowlarr-api.sh indexers --verbose
Indexer Health & Stats
./scripts/prowlarr-api.sh stats
./scripts/prowlarr-api.sh test-all
./scripts/prowlarr-api.sh test <indexer-id>
Indexer Management
./scripts/prowlarr-api.sh enable <indexer-id>
./scripts/prowlarr-api.sh disable <indexer-id>
./scripts/prowlarr-api.sh delete <indexer-id>
App Sync
./scripts/prowlarr-api.sh sync
./scripts/prowlarr-api.sh apps
System
./scripts/prowlarr-api.sh status
./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:
- "Search for a torrent" → Run
search "<query>" and present results with download links
- "Find Breaking Bad S01E01" → Run
tv-search --tvdb <id> --season 1 --episode 1
- "Which indexers are working?" → Run
stats to show indexer health and usage
- "Test all my indexers" → Run
test-all to verify connectivity
- "Sync indexers to Sonarr" → Run
sync to push configuration changes
- "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