iBus CLI — SKILL#

Comando de terminal para consultar paraderos del transporte público chileno en tiempo real.

Requisitos#

• Python 3.9+
• Repo: https://github.com/iiroak/iBus.CL-API

bash

bash <(curl -sSL https://raw.githubusercontent.com/iiroak/iBus.CL-API/main/install.sh)

O manual: pip install . dentro del repositorio.

Comandos#

Consultar un paradero (todos los servicios)#

bash

ibus PA1

Filtrar por servicio específico#

bash

ibus PH123 --servicio 201
ibus PH123 -s 201

Salida JSON cruda (para pipelines y parsing)#

bash

ibus PA1 --raw
ibus PH123 -s 201 --raw

Alternativa sin instalar globalmente#

bash

python -m ibus PA1
python -m ibus PH123 -s 201 --raw

Formato de salida legible#

text

Paradero : PA1
Nombre   : PARADA 6 / (M) QUINTA NORMAL
Hora     : 14:30
------------------------------------------------------------
     507  │  GCBD-65  │ En menos de 2 min         │    502m
          │  TBFX-11  │ Entre 12 Y 16 min         │   3521m
     B28  →  No hay buses que se dirijan al paradero
------------------------------------------------------------

Formato JSON ( --raw)#

json

{
  "paradero": {
    "codigo": "PA1",
    "nombre": "PARADA 6 / (M) QUINTA NORMAL",
    "hora_consulta": "14:30"
  },
  "servicios": [
    {
      "servicio": "507",
      "buses": [
        {"patente": "GCBD-65", "tiempo_llegada": "En menos de 2 min", "distancia": 502},
        {"patente": "TBFX-11", "tiempo_llegada": "Entre 12 Y 16 min", "distancia": 3521}
      ],
      "mensaje": null
    },
    {
      "servicio": "B28",
      "buses": [],
      "mensaje": "No hay buses que se dirijan al paradero"
    }
  ]
}

Campos de respuesta JSON#

CampoTipoDescripciónparadero.codigostringCódigo del paraderoparadero.nombrestringUbicación/nombre del paraderoparadero.hora_consultastringHora de la consulta (HH:MM)servicios[].serviciostringCódigo del recorridoservicios[].buses[].patentestringPatente del busservicios[].buses[].tiempo_llegadastringEstimación de llegadaservicios[].buses[].distanciaintegerDistancia en metros ( 0 = llegando)servicios[].mensajestring|nullMensaje cuando no hay buses

Valores de tiempo_llegada#

• "Llegando" — en el paradero
• "En menos de 2 min" — muy cerca
• "Entre 6 Y 10 min" — rango estimado
• "Mas de 26 min" — lejos

Códigos de salida#

CódigoSignificado0Consulta exitosa1Error (paradero inválido, sin conexión, timeout)

Paradero inválido#

Cuando el paradero no existe, la respuesta incluye:

json

{"servicio": "Indisponible", "buses": [], "mensaje": "Paradero Invalido"}