Releases: seifreed/renfecli
Release list
v1.0.0 — primera versión
Primera versión pública de renfecli, una CLI no oficial para consultar horarios y tarifas reales de Renfe desde la terminal.
Habla los mismos endpoints HTTP que usa venta.renfe.com, sin navegador headless y sin raspar HTML renderizado, así que las tarifas son las que cotiza la web en ese momento.
Es de solo lectura. Busca, tarifica y consulta tu propia cuenta. Nunca reserva, ni paga, ni modifica nada: la compra la terminas tú en renfe.com.
Qué trae
- Tarifas en vivo — todos los tipos de tarifa por tren (Básico, Elige, Prémium…), no solo el precio de portada.
- Calendario de precios — la tira de precio mínimo por día que Renfe manda con cada búsqueda, sin coste de una petición extra. Responde a «¿qué día sale más barato?».
- Ida y vuelta en una sola petición, avisando si la vuelta en el día es realmente posible: los dos sentidos se listan por separado, y en un trayecto largo la mitad de las vueltas salen antes de que puedas llegar.
- Paradas intermedias y prestaciones a bordo, tramo a tramo en los enlaces. Muestra el viaje que pediste, no el recorrido entero del tren: si tu AVE sigue hasta Figueres, las paradas terminan en tu estación.
- Catálogo de 1367 estaciones con búsqueda difusa y caché: valen
madrid,Barcelona-Santso el código71801. Incluye Francia y Portugal, con los nombres españoles habituales aliasados (Marsella, Perpiñán, Oporto). - Tu cuenta +Renfe — tarjeta y próximos viajes, a partir de una sesión que ya tienes en el navegador.
session keepla mantiene viva. - Salida para agentes y scripts —
--jsony--toonen todos los comandos, datos a stdout y diagnósticos a stderr. Se incluye una skill de Claude Code en.claude/skills/renfe-trains/. - Filtros por franja horaria, viajes directos, mascota, bicicleta o plaza de silla de ruedas; ordenación por precio y ocultación de lo que no se puede comprar.
Qué conviene saber
- Los precios son por pasajero, nunca el total del grupo, y son tarifas base: Dorada, Carné Joven y Familia Numerosa se aplican más adelante en la compra.
- La ventana de venta de Renfe es corta (unos 83 días en Madrid–Barcelona) y avanza a tramos con el horario.
- Cercanías no se vende por este flujo, y otros operadores (Ouigo, Iryo) le son invisibles: una comparación aquí es solo de Renfe.
Instalación
Binarios para Linux, macOS (Intel y Apple Silicon) y Windows, cada uno con su fichero SHA256SUMS al lado:
tar xzf renfe_v1.0.0_darwin_arm64.tar.gz
shasum -c renfe_v1.0.0_darwin_SHA256SUMS
./renfe search madrid barcelona --date tomorrowO con Go (1.26.6 o superior):
go install github.com/seifreed/renfecli/cmd/renfe@v1.0.0Compilado sin CGO y con -trimpath en las tres plataformas. Probado en Linux, macOS y Windows; análisis de CodeQL, gosec y govulncheck en verde.
Sin afiliación con Renfe ni respaldo por su parte.