iBus CLI — SKILL\r

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

Requisitos\r

\r

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

bash \x3C(curl -sSL https://raw.githubusercontent.com/iiroak/iBus.CL-API/main/install.sh)\r
```\r
\r
O manual: `pip install .` dentro del repositorio.\r
\r
## Comandos\r
\r
### Consultar un paradero (todos los servicios)\r
\r
```bash\r
ibus PA1\r
```\r
\r
### Filtrar por servicio específico\r
\r
```bash\r
ibus PH123 --servicio 201\r
ibus PH123 -s 201\r
```\r
\r
### Salida JSON cruda (para pipelines y parsing)\r
\r
```bash\r
ibus PA1 --raw\r
ibus PH123 -s 201 --raw\r
```\r
\r
### Alternativa sin instalar globalmente\r
\r
```bash\r
python -m ibus PA1\r
python -m ibus PH123 -s 201 --raw\r
```\r
\r
## Formato de salida legible\r
\r
```\r
Paradero : PA1\r
Nombre   : PARADA 6 / (M) QUINTA NORMAL\r
Hora     : 14:30\r
------------------------------------------------------------\r
     507  │  GCBD-65  │ En menos de 2 min         │    502m\r
          │  TBFX-11  │ Entre 12 Y 16 min         │   3521m\r
     B28  →  No hay buses que se dirijan al paradero\r
------------------------------------------------------------\r
```\r
\r
## Formato JSON (`--raw`)\r
\r
```json\r
{\r
  "paradero": {\r
    "codigo": "PA1",\r
    "nombre": "PARADA 6 / (M) QUINTA NORMAL",\r
    "hora_consulta": "14:30"\r
  },\r
  "servicios": [\r
    {\r
      "servicio": "507",\r
      "buses": [\r
        {"patente": "GCBD-65", "tiempo_llegada": "En menos de 2 min", "distancia": 502},\r
        {"patente": "TBFX-11", "tiempo_llegada": "Entre 12 Y 16 min", "distancia": 3521}\r
      ],\r
      "mensaje": null\r
    },\r
    {\r
      "servicio": "B28",\r
      "buses": [],\r
      "mensaje": "No hay buses que se dirijan al paradero"\r
    }\r
  ]\r
}\r
```\r
\r
## Campos de respuesta JSON\r
\r
| Campo | Tipo | Descripción |\r
|-------|------|-------------|\r
| `paradero.codigo` | string | Código del paradero |\r
| `paradero.nombre` | string | Ubicación/nombre del paradero |\r
| `paradero.hora_consulta` | string | Hora de la consulta (HH:MM) |\r
| `servicios[].servicio` | string | Código del recorrido |\r
| `servicios[].buses[].patente` | string | Patente del bus |\r
| `servicios[].buses[].tiempo_llegada` | string | Estimación de llegada |\r
| `servicios[].buses[].distancia` | integer | Distancia en metros (`0` = llegando) |\r
| `servicios[].mensaje` | string\|null | Mensaje cuando no hay buses |\r
\r
## Valores de tiempo_llegada\r
\r
- `"Llegando"` — en el paradero\r
- `"En menos de 2 min"` — muy cerca\r
- `"Entre 6 Y 10 min"` — rango estimado\r
- `"Mas de 26 min"` — lejos\r
\r
## Códigos de salida\r
\r
| Código | Significado |\r
|--------|-------------|\r
| 0 | Consulta exitosa |\r
| 1 | Error (paradero inválido, sin conexión, timeout) |\r
\r
## Paradero inválido\r
\r
Cuando el paradero no existe, la respuesta incluye:\r
```json\r
{"servicio": "Indisponible", "buses": [], "mensaje": "Paradero Invalido"}\r
```\r