Prowlarr Search for Openclaw

A specialized skill for searching movie and TV show torrents or magnet links through a Prowlarr instance.

pengzhxyz
v1.0.0
Mar 7, 2026
1
923
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install prowlarr-search

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install prowlarr-search using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Prowlarr Search?

The Prowlarr Search skill empowers your AI agent to interact with Prowlarr, a popular indexer manager for Usenet and BitTorrent. By utilizing this component of Openclaw Skills, developers can automate the discovery of media resources across hundreds of indexers simultaneously. It translates natural language search queries or specific TV metadata into API requests, returning structured data ready for automation.

This tool is essential for anyone looking to bridge the gap between AI-driven requests and self-hosted media servers. Whether you are looking for a specific movie or a high-definition TV episode, this skill provides a programmatic interface to find magnet links and torrent files with ease.

Prowlarr Search Use Cases

  • Finding the best quality torrent for a specific movie title using Openclaw Skills
  • Automating the search for missing TV show episodes by season and episode number
  • Integrating media discovery into private AI-driven homelab dashboards
  • Gathering magnet links for bulk download processing in automated workflows

How Prowlarr Search Works

  1. The user provides a query string and optional parameters like media type (tv) or episode details to the AI agent.
  2. The skill initializes a connection to the Prowlarr API using the configured PROWLARR_BASE_URL and PROWLARR_API_KEY.
  3. Prowlarr performs a cross-indexer search across all enabled torrent and Usenet indexers.
  4. The script captures the raw API response and cleans the metadata into a standardized format.
  5. A JSON array of results is returned, featuring essential details like magnet links, file sizes, and indexer names.

Prowlarr Search Setup

To use this skill within the Openclaw Skills framework, ensure you have python3 installed. You must configure your environment variables to connect to your Prowlarr server:

export PROWLARR_BASE_URL="http://your-prowlarr-ip:9696"
export PROWLARR_API_KEY="your_api_key_here"

Run a general search query via the command line:

python3 scripts/prowlarr-search.py "Your Search Query"

For TV show specific searches:

python3 scripts/prowlarr-search.py "Show Name" --type tv --season 1 --ep 5

Prowlarr Search Data Schema & Taxonomy

The skill returns a structured JSON array of objects. Each object follows this schema:

  • title: The release title of the file (e.g., Movie.Title.2024.1080p).
  • size: Human-readable file size (e.g., 2.50 GB).
  • indexer: The source indexer name that provided the link.
  • guid: The magnet link or download URL for the resource.
  • publishDate: The timestamp indicating when the item was indexed.

Prowlarr Search Advanced Features

  • Support for TV-specific search parameters including season and episode numbers for precise discovery
  • Broad compatibility with both torrent and Usenet indexers managed via a single Prowlarr instance
  • Seamless integration into automated media download pipelines using Openclaw Skills
  • High-performance result filtering based on real-time indexer availability and metadata

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins python3
Github Stars: 0
forks: 0

Featured*