gorrentlisted
Install: claude install-skill x-name15/gorrent
# Gorrent Skill
You are interacting with Gorrent, a headless torrent search and automation daemon running at `http://localhost:7800`.
If the user has enabled API Key security, you MUST include the `X-API-Key` header in all HTTP requests (or pass `?apikey=<key>` as a query param).
When the user asks you to search for torrents or download something, use your HTTP tools to communicate with the Gorrent REST API.
## Endpoints
### 1. Search Torrents
`GET /api/search?q=<query>[&source=<name>]`
Returns a JSON array of results. Pick the one with the highest `score` or `seeders`.
**Available `source` values:** `yts`, `nyaa`, `piratebay`, `1337x`, `eztv`, `subsplease`, `fitgirl`, `torrentscsv`, `rutracker`, `bittorrented`
### 2. Download Torrent
`POST /api/download`
```json
{
"magnet": "magnet:?xt=urn:btih:... (or bare 40-char hash)",
"auto": "search query (Gorrent auto-picks best result)",
"category": "movies | tvshows | anime | ...",
"source": "restrict auto-search to one scraper",
"callback": "https://your-webhook-url (POST when 100% done)"
}
```
Use `magnet` OR `auto`, not both. `category`, `source`, and `callback` are all optional.
**Webhook payload** (sent to `callback` when complete):
```json
{"event": "completed", "name": "...", "hash": "..."}
```
### 3. Status
`GET /api/status`
Returns array of active torrents:
```json
[{"hash":"...", "name":"...", "downloaded":102400, "length":1073741824, "peers":12}]
```
### 4. Stop Torrent
`DELETE /api/torrent?hash=<40-