queguagua de momento, ALSA

¿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 --yes no 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

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 --yes todo 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.