Skip to content

Releases: seifreed/renfecli

v1.0.0 — primera versión

Choose a tag to compare

@github-actions github-actions released this 20 Sep 20:23

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-Sants o el código 71801. 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 keep la mantiene viva.
  • Salida para agentes y scripts — --json y --toon en 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 tomorrow

O con Go (1.26.6 o superior):

go install github.com/seifreed/renfecli/cmd/renfe@v1.0.0

Compilado 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.