¿Qué guagua cojo?
Las guaguas de España desde la terminal. Busca horarios y precios, elige asiento, usa tu Abono Único y paga con la tarjeta que ya tienes guardada. Todo en JSON, para ti y para tu asistente de IA.
uv tool install 'queguagua[checkout] @ git+https://github.com/joseluissaorin/queguagua'
Python 3.12 y uv. La orden es queguagua, o qg si tienes prisa.
Así se usa
Pregunta y te contesta. Esto es una búsqueda de verdad, con el Abono Único sacado de la cuenta:
$ qg alsa search Granada Madrid -d 2026-12-04 --after 07:00 -n 1 --abono
{
"trip": "one_way",
"promo": { "abono_unico": true, "valid": true },
"journeys": [
{
"departure": "2026-12-04T07:00:00+01:00",
"arrival": "2026-12-04T12:00:00+01:00",
"service": ["Comfort"],
"available": true,
"fares": [{ "name": "Abono Único", "price": 0.0 }]
}
]
}
Y antes de comprar, siempre el presupuesto. Con --yes compra; si hay que pagar con tarjeta, te abre la página del banco para que lo confirmes tú.
$ qg alsa buy Granada Madrid -d 2026-12-04 -t 08:00 \
--seat-pref window --extra insurance
{
"status": "reviewed",
"quote": {
"package": { "name": "Flexible" },
"seats": [{ "seat": 107 }],
"management_fee": 0.0,
"total": 25.53
},
"saved_card": { "type": "MasterCard", "last4": "1234" },
"next": "Nothing was booked or charged. …"
}
Qué hace
- Busca
- Horarios y precios de cualquier ruta, de ida o de ida y vuelta, con adultos, jóvenes, mayores, niños y bebés. Paquetes Básica, Flexible y Superflexible, paradas intermedias y plazas para silla de ruedas.
- Elige
- El asiento en el plano del autobús (ventanilla o pasillo), extras para todos o para un viajero: mascota, bici, seguro, el asiento de al lado. Descuentos de familia numerosa y de discapacidad.
- Paga
- Con la tarjeta que ya tienes guardada en tu cuenta, con tus puntos (solos o con dinero), con el monedero, con una tarjeta nueva, PayPal, Bizum, Google Pay o Klarna. Sin
--yesno compra nada: te enseña el desglose. - Abono Único
- Lo lee de tu cuenta y reserva los Comfort a 0 €. Te dice cuántos días le quedan y te cotiza el siguiente.
- Después
- Tus viajes, cada billete con su asiento, su dársena y el estado del bus, el PDF, el QR de embarque y la anulación con el reembolso a la vista antes de confirmar.
- Para agentes
- Todo sale en JSON, con códigos de salida claros. Un asistente de IA puede buscarte la guagua y dejártela lista para que la pagues tú.
Empresas
- ALSA larga distancia, regionales y aeropuertos, en España, Portugal, Francia y Marruecos ya
- Las siguientes guaguas cada empresa entra como un grupo de órdenes nuevo, sin tocar las demás cuando toque
Preguntas
- ¿Es oficial?
- No. Habla con alsa.es igual que lo hace su propia web, sin acuerdo con ALSA. Si la web cambia, queguagua puede dejar de funcionar hasta que se arregle.
- ¿Y mi contraseña?
- Se queda en el llavero de tu Mac (o en variables de entorno). La CLI no la escribe en ningún fichero ni la manda a otro sitio que no sea ALSA.
- ¿Puede comprar sin querer?
- No. Sin
--yestodo se queda en presupuesto. Los pagos con tarjeta los confirmas tú en la página del banco. - ¿Qué falta?
- Cambiar un billete (anular, sí), la vuelta abierta (la propia web de ALSA no la vende ahora) y Apple Pay. Y las demás empresas: de momento, solo ALSA.