# Readarr Ops

> Manage Readarr library, search for books, and monitor downloads. Handles service health checks and API interactions.

- Skill: `majiayu000/readarr-ops` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/readarr-ops`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/readarr-ops/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/readarr-ops

---


# readarr-ops

**Manage Readarr library, search for books, and monitor downloads.**

## Commands

- `search <term>`: Search for books/authors in Readarr.
- `nzb-search <term>`: Direct Usenet search via NZBGeek.
- `add <term>`: Search and add the first matching book (Auto-Learn).
- `health`: Check if Readarr is running and healthy.
- `ensure-running`: Start Readarr if not running.

## Usage

```bash
# Check health
./run.sh health

# Search for a book
./run.sh search "The Art of Exploitation"

# Add a book
./run.sh add "Hacking: The Art of Exploitation"
```

## Configuration

- **Readarr Path**: `~/workspace/experiments/Readarr/Readarr`
- **Data Path**: `~/workspace/experiments/Readarr/data`
- **Port**: 8787
- **API Key**: `READARR_API_KEY` env var (optional for localhost in some configs)