Prowlarr

Search indexers and manage Prowlarr. Use when the user asks to "search for a torrent", "search indexers", "find a release", "check indexer status", "list indexers", "prowlarr search", "sync indexers", or mentions Prowlarr/indexer management.

Security Scan

The skill appears to do what it claims (talk to a Prowlarr instance using an API key) but the package metadata omits required config/credentials and necessary binaries (curl, jq), so the bundle is inconsistent and needs verification before use.

Purpose & Capability

The name/description match the code: the script talks to a Prowlarr API and supports searches, indexer management, and syncs. However, the registry metadata lists no required config paths or env vars while SKILL.md and the script both require a config file (~/.clawdbot/credentials/prowlarr/config.json) or PROWLARR_URL/PROWLARR_API_KEY — this mismatch is an inconsistency.

Instruction Scope

SKILL.md explicitly instructs creating/reading a credentials file and gives CLI examples that run the included script. The runtime instructions stay within the stated purpose (only call the Prowlarr API). They do, however, direct the agent/user to read/create a specific config path that was not declared in metadata.

Install Mechanism

There is no install step or external download; this is an instruction-only skill with an included bash helper. No third-party packages are fetched at install time, which reduces supply-chain risk.

Credentials

The only secret needed is the Prowlarr API key (provided via config file or PROWLARR_API_KEY), which is appropriate for the stated functionality. However, the registry metadata declared no required env vars or config paths even though the skill clearly needs them. Also the script requires curl and jq, but the metadata lists no required binaries.

Persistence & Privilege

The skill does not request always:true and does not modify other skills or system-wide settings. It simply reads a local credentials file or environment variables and makes API calls to the configured Prowlarr URL.

What to consider before installing

This skill's code matches its description: it calls a Prowlarr instance using a URL and API key. However, the package metadata omits the config file path and required tools (curl, jq) that the script uses. Before installing: 1) review the included scripts yourself (they are present and readable) to confirm behavior; 2) only provide an API key for a Prowlarr instance you trust and prefer using environment variables with restricted file permissions if you store a config file (~/.clawdbot/credentials/prowlarr/config.json should be readable only by you); 3) ensure curl and jq are available on the agent runtime; 4) confirm the PROWLARR_URL points to an internal/trusted host (the script will send the API key to that URL); 5) ask the publisher to update metadata to list required config paths and binaries so the skill's declared requirements match what it actually needs. These inconsistencies are likely sloppy packaging rather than malicious, but verify before granting access to your Prowlarr API key.

Prowlarr Skill

Search across all your indexers and manage Prowlarr via API.

Setup

Config: ~/.clawdbot/credentials/prowlarr/config.json

{
  "url": "https://prowlarr.example.com",
  "apiKey": "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

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