---
name: videoclub-buscador
description: Buscador interactivo de peliculas y series via Torrentio/RealDebrid con descarga a NAS Synology. Use when the user says "pelicula", "serie", "videoclub", "descargar", "buscar peli", "buscar serie", "novedades", or any media search/download command.
---

# Videoclub — Buscador Interactivo

## Arquitectura
El videoclub es un buscador interactivo que reemplaza el listado diario pasivo.
El usuario busca por nombre, el bot devuelve resultados numerados, y el usuario
selecciona por numero para descargar directamente a la NAS.

## Flujo de usuario
```
/pelicula <nombre>     → Lista peliculas numeradas con enlaces
/serie <nombre>        → Lista serie con temporadas/capitulos numerados
/descargar <numero>    → Descarga el item seleccionado a la NAS
/novedades             → Lista novedades del catalogo
```

## API de Torrentio
- Catalogo: `https://torrentio.strem.fun/<config>/catalog/other/torrentio-realdebrid.json`
- Config incluye token RealDebrid: `language=spanish|realdebrid=<token>`
- Cada item del catalogo tiene: `id`, `name` (nombre del fichero torrent)
- Los enlaces directos de descarga se obtienen de la API de RealDebrid:
  `GET https://api.real-debrid.com/rest/1.0/torrents` con Bearer token

## Clasificacion de titulos
- **Pelicula**: nombre sin marcador SxxExxx ni palabras de serie
- **Serie**: tiene SxxExxx, "Cap", "Temporada", o palabras clave de serie
- **Adulto**: contiene .XXX, brazzers, spankbang, etc. → NUNCA se lista

## Descarga a NAS
- Usar `nas_dl.py` que llama a la API de Synology Download Station
- Primero se desrestricta el enlace RealDebrid con `unrestrict_rd`
- Luego se anade a Download Station con `add_torrent(uri)`

## Formato de respuesta
### Para peliculas:
```
🎬 Resultados para "batman":

1. Batman Begins (2005) — 1080p, castellano
2. The Dark Knight (2008) — 4K, castellano
3. Batman v Superman (2016) — 1080p, dual

Responde con el numero para descargar.
```

### Para series:
```
📺 Breaking Bad — 5 temporadas encontradas:

Temporada 1:
  1. S01E01 — Pilot
  2. S01E02 — Cat's in the Bag
  ...

Temporada 2:
  ...
Responde con el numero de episodio para descargar.
```

## Scripts
- `videoclub/videoclub.py` — catalogo diario + diff novedades
- `videoclub/config.py` — token Torrentio + config
- `vigilancia/nas_dl.py` — descarga NAS via Download Station API
- `vigilancia/pelis.py` — logica de clasificacion y formateo

## Configuracion (.env)
- `TORRENTIO_RD_TOKEN` — token RealDebrid
- `TORRENTIO_CONFIG` — configuracion Torrentio (default: language=spanish)
- `NAS_HOST`, `NAS_PORT`, `NAS_USER`, `NAS_PASS` — credenciales NAS