biblioteca_conocimiento_laboratorio/.opencode/skill/videoclub-buscador/SKILL.md

name, description

name	description
videoclub-buscador	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