Cómo funciona
Buscar vuelos con las fechas del viaje y los aeropuertos más cercanos
Kokai no vende billetes ni consulta precios: busca en su propia lista de 3.244 aeropuertos, sin red, los más cercanos a tu destino y el de tu salida, y construye el enlace de búsqueda de siete webs (Google Vuelos, Skyscanner, Kayak, Momondo, eDreams, Trip.com y Aviasales) con las fechas del viaje y los viajeros ya puestos. Hasta que tocas uno no sale nada del dispositivo.
En pocas palabras
- Dónde está
- Botón «Buscar vuelos» en el «Resumen» del viaje (si no ha pasado) y en «Documentos».
- Aeropuertos
- 3.244, los que tienen vuelos regulares y código IATA, de OurAirports (dominio público). Van dentro de la app.
- Aeropuertos del destino
- Los que hay a menos de 150 km del destino situado en el mapa, hasta cuatro; los pequeños cuentan como si estuvieran al doble de lejos.
- Webs
- Siete: Google Vuelos, Skyscanner, Kayak, Momondo, eDreams, Trip.com y Aviasales. Ida y vuelta o solo ida.
- Qué se rellena
- Aeropuerto de salida y de llegada, fechas y viajeros (de 1 a 9). Google Vuelos no admite viajeros en el enlace.
- Qué sale del dispositivo
- Nada hasta que tocas un enlace. Solo si escribes una ciudad que no está en la lista se busca en Nominatim para encontrar sus aeropuertos.
- Precio
- Gratis. Kokai no cobra nada ni se lleva comisión, salvo que algún día un enlace sea de afiliado, y entonces lo dice.
Qué hace y qué no hace
Buscar un vuelo es casi siempre lo mismo: elegir de dónde sales, adónde vas, las fechas y cuántos viajáis, y repetirlo en tres o cuatro webs para comparar. Kokai ya sabe el destino, las fechas y los viajeros de tu viaje, así que te ahorra la parte repetida: abre cada buscador con todo eso escrito.
- Sí: encuentra los aeropuertos cercanos al destino, recuerda tu aeropuerto de salida en ese dispositivo y abre siete buscadores con la búsqueda hecha.
- No: no enseña precios, no compara tarifas ni horarios, no compra billetes y no avisa si baja un precio. Todo eso lo hace cada web, bajo sus condiciones.
- Después: cuando compres, añade el PDF del billete en Documentos. Kokai lo lee en el dispositivo, sin IA, y te recuerda el vuelo la víspera.
Por qué enlaces y no una búsqueda dentro de la app
Enseñar precios dentro de Kokai exigiría una API de vuelos o leer las páginas de resultados de otros. Revisado el 17 de septiembre de 2026, ninguna de las dos vías sirve para una app que no tiene servidor de búsqueda ni quiere que tu viaje pase por uno:
| Vía | Qué pasa hoy |
|---|---|
| Amadeus for Developers | Su portal de autoservicio, el que daba claves gratis, «se desmanteló el 17 de julio»: su web solo ofrece ya el portal de empresas. |
| Kiwi.com (Tequila) | Su portal para desarrolladores no deja entrar: contesta con un error 403. |
| Skyscanner | Sus API de búsqueda son para sus socios comerciales, con normas de uso y diseño; lo que sí publica para cualquiera es el formato de sus enlaces. |
| Duffel | Es una API para vender billetes: pide cuenta, y cada reserva se paga. Una app que no vende nada no la necesita. |
| Leer las páginas de resultados | Va contra las condiciones de esas webs, el navegador lo impide (las páginas de otro dominio no se pueden leer desde una app web) y obligaría a mandar tu viaje a un servidor que lo hiciera por ti. |
Un enlace, en cambio, no necesita permiso de nadie, funciona igual en el navegador y en el móvil, y no manda nada hasta que lo tocas. Es lo mismo que hace Alojamiento con Booking.com o Airbnb.
La lista de aeropuertos, sin red
Kokai lleva dentro la lista de aeropuertos de OurAirports, un proyecto de datos abiertos de dominio público. De sus más de 80.000 aeródromos se quedan los que sirven para comprar un billete: aeropuertos grandes y medianos, con vuelos regulares y con código IATA de tres letras. Son 3.244.
- Qué guarda de cada uno
- El código IATA, el nombre, la ciudad, el país, las coordenadas (con tres decimales, unos 100 m) y si es grande, y sus otros nombres («Lisboa» y «Portela» en el de Lisboa, «Londres» en Heathrow).
- Cuánto ocupa
- 278 KB, 112 KB comprimida. Se carga solo al abrir la búsqueda de vuelos, no al abrir la app.
- Cómo se actualiza
- Con
npm run aeropuertos, que vuelve a bajar la lista y la recorta. La que va en la app es del 17 de septiembre de 2026.
Los nombres vienen en inglés, como los publica OurAirports («Lisbon Humberto Delgado Airport»); el país sale en el idioma de la app. El código IATA es lo que se manda a cada buscador, y es igual en todos los idiomas.
Los aeropuertos más cercanos al destino
Si el destino del viaje está situado en el mapa, Kokai mide la distancia en línea recta desde ese punto a cada aeropuerto de la lista y ofrece hasta cuatro a menos de 150 km, con su distancia. Elige el primero por su cuenta.
Un aeropuerto grande a 40 km suele tener más vuelos que uno pequeño a 15, así que al ordenar, los pequeños cuentan como si estuvieran al doble de lejos. Si no hay ninguno en 150 km, se ofrece el más cercano, esté donde esté.
| Destino situado en… | Lo que ofrece, en orden |
|---|---|
| Lisboa | LIS (a 6,6 km) y CAT, Cascais (a 18,7 km) |
| Vilafranca del Penedès | BCN, Barcelona (a 32 km), REU, Reus (a 50 km), GRO, Girona (a 108 km) y ILD, Lleida (a 106 km) |
| Ciutadella de Menorca | MAH, Menorca (a 36 km) y PMI, Palma (a 106 km) |
| Kioto | ITM, Osaka Itami (a 39 km), UKB, Kobe (a 65 km), KIX, Kansai (a 81 km) y NGO, Chubu (a 96 km) |
| Isla de Flores (Azores) | FLW, Santa Cruz das Flores (a 6 km) |
La distancia es en línea recta, no por carretera. Antes de elegir un aeropuerto lejano, mira cómo se llega desde él al destino: a veces el más barato es el que más cuesta después.
Desde dónde sales
El campo «Desde dónde sales» se busca por código, ciudad o nombre, sin tener en cuenta tildes ni mayúsculas. Primero sale el código exacto («MAD»), luego las ciudades o los otros nombres que empiezan por lo escrito («Londres» da Heathrow) y luego los aeropuertos con alguna palabra que empiece así («Humberto» da Lisboa); a igualdad, los grandes delante.
Se busca por palabras, no por trozos: «oporto» no encuentra los aeropuertos italianos cuyo nombre lleva «aeroporto». Si lo escrito no está en la lista (una ciudad sin aeropuerto, o un nombre en otro idioma como «Oporto» o «Nueva York»), aparece «Buscar aeropuertos cerca de «…»»: Kokai sitúa ese lugar en el mapa con Nominatim, como hace con el destino del viaje, y ofrece sus aeropuertos cercanos.
El aeropuerto de salida se recuerda en ese dispositivo para el siguiente viaje. No se copia a tu cuenta ni a tus otros dispositivos.
Las siete webs y el formato de cada enlace
Cada enlace se abrió en Chromium el 17 de septiembre de 2026, de Madrid a Lisboa, del 3 al 8 de octubre y con 2 adultos, de ida y vuelta y solo de ida, y se miró qué rellenaba la web:
| Web | Formato | Qué rellena |
|---|---|---|
| Google Vuelos | google.com/travel/flights?q=… con la búsqueda escrita en inglés: Flights to LIS from MAD on 2026-10-03 through 2026-10-08 | Aeropuertos y fechas. Los viajeros, no: busca para una persona |
| Skyscanner | skyscanner.net/g/referrals/v1/flights/day-view/ con origin, destination, outboundDate, inboundDate, adultsv2 y locale | El formato es el que publica en su documentación; su web no deja entrar a un navegador automático y no se pudo abrir |
| Kayak | kayak.es/flights/MAD-LIS/2026-10-03/2026-10-08/2adults (kayak.com en inglés) | Aeropuertos, fechas y viajeros |
| Momondo | momondo.es/flight-search/MAD-LIS/2026-10-03/2026-10-08/2adults | Aeropuertos, fechas y viajeros |
| eDreams | edreams.es/travel/#results/type=R;from=MAD;to=LIS;dep=…;ret=…;adults=2 (type=O y sin ret para solo ida) | Aeropuertos, fechas y viajeros |
| Trip.com | es.trip.com/flights/showfarefirst con dcity, acity, ddate, rdate, triptype (rt u ow) y quantity | Aeropuertos, fechas y viajeros |
| Aviasales | aviasales.com/search/MAD0310LIS08102: origen, día y mes de ida, destino, día y mes de vuelta y viajeros | Aeropuertos, fechas y viajeros |
Quedaron fuera Kiwi.com, que con códigos de aeropuerto no busca nada (quiere nombres de ciudad en su idioma, como madrid-espana), y Expedia, que no publica el formato de su enlace y tampoco dejó abrirlo. Las webs cambian sus direcciones sin avisar: si un enlace deja de rellenar algo, escribe por el formulario de contacto.
Fechas, ida y vuelta y viajeros
- «Ida» y «Vuelta» empiezan con las fechas del viaje, y se pueden cambiar sin tocar el viaje: por ejemplo, para mirar si sale más barato volver un día después.
- Con «Solo ida» desaparece la vuelta. Si la vuelta queda antes que la ida, los enlaces no se generan hasta arreglarla.
- «Viajeros» empieza con los del viaje. Los buscadores reciben de 1 a 9, todos como adultos: niños y bebés se ajustan en cada web.
- Sin aeropuerto de salida o de llegada, o con los dos iguales, Kokai dice lo que falta en lugar de enseñar enlaces rotos.
Enlaces de afiliado
Como los de alojamiento, los enlaces de vuelos están preparados para programas de afiliados, que pagan una comisión a quien les lleva una compra sin que el precio cambie. Se activan al compilar la app (VITE_AFILIADOS), con los parámetros de cada programa o con el enlace de una red que redirige. Kayak, Trip.com y Google comparten configuración con los de alojamiento, porque el programa es el mismo.
Hoy la app se publica sin afiliados. Si algún día un enlace lo es, debajo de la lista sale: «Algunos son enlaces de afiliado: si reservas desde ellos, Kokai puede recibir una comisión, sin que te cueste más.»
Qué sale de tu dispositivo
| Cuándo | Quién lo recibe | Qué |
|---|---|---|
| Al abrir «Buscar vuelos» | Nadie | La lista de aeropuertos va dentro de la app, y los cercanos se calculan en el dispositivo |
| Al pulsar «Buscar aeropuertos cerca de «…»» | Nominatim, de la Fundación OpenStreetMap | Solo el texto escrito |
| Al tocar un buscador | Esa web | Los dos códigos de aeropuerto, las fechas, los viajeros y el idioma, en la dirección del enlace |
El resto del viaje (los sitios, el plan, los documentos) no va en ningún enlace. Lo que haga cada web con tu búsqueda lo dicen sus condiciones y su política de privacidad. Más en Tus datos.
Preguntas frecuentes
¿Kokai me dice cuál es el vuelo más barato?
No. No consulta precios: abre cada buscador con tu búsqueda hecha, y la comparación la hace cada web. Abrir dos o tres ayuda a ver si un precio es bueno.
¿Por qué Google Vuelos busca para una persona?
Porque su dirección no admite el número de viajeros: se cambia en la propia página, arriba, junto a «Ida y vuelta». El precio de Google Vuelos es por persona.
¿Y si mi ciudad no tiene aeropuerto?
Escríbela en «Desde dónde sales» y pulsa «Buscar aeropuertos cerca de…»: Kokai la sitúa en el mapa y ofrece los aeropuertos a menos de 150 km.
¿Sirve para vuelos con escalas o de varios destinos?
Busca de un aeropuerto a otro, de ida y vuelta o solo de ida; las escalas las propone cada web. Los viajes de varios destinos, de momento, se buscan en la web.
¿Guarda el vuelo que compro?
No, porque la compra se hace en la otra web. Añade el PDF del billete en «Documentos»: se lee en el dispositivo y se reconocen 15 aerolíneas (Ryanair, Vueling, Iberia, TAP Air Portugal…), y la víspera te llega el aviso.
Fuentes y referencias
La documentación original de lo que se cita aquí, consultada en la fecha de revisión de esta página.
- Open data @ OurAirports OurAirports
- ourairports-data (Unlicense, dominio público) David Megginson, en GitHub
- Referrals: examples (formato de los enlaces) Skyscanner Developers
- Usage guidelines de las API Skyscanner Developers
- Aviso del cierre del portal de autoservicio Amadeus for Developers
- Encontrar billetes de avión en Google Vuelos Ayuda de Google
- Código de aeropuertos de IATA Wikipedia
- Política de uso de Nominatim Fundación OpenStreetMap
Sigue leyendo
- AlojamientoCómo Kokai organiza el alojamiento por noches: reservas, opciones sin decidir, huecos y dobles reservas, avisos de cancelación y la dirección del hotel sin red.
- Buscar alojamientoCómo construir el enlace de búsqueda de Booking.com, Airbnb, Expedia, Vrbo, Agoda, Trip.com, Kayak y Google Hoteles con destino, fechas y viajeros, y ejemplos.
- DocumentosCómo guarda Kokai billetes, reservas y pasaporte con su PDF o foto para abrirlos sin red, qué avisa antes de que caduquen y qué no sale del dispositivo.
- Reservas en PDFQué saca Kokai del PDF de una reserva sin IA ni red: 65 marcas, 8 clases, etiquetas en 7 idiomas, fechas, precio y cancelación, con un ejemplo de Booking.com.
- Tus datosQué guarda Kokai en tu dispositivo, qué va a la copia de tu cuenta, qué servicios reciben algo y cuándo, qué no sale nunca y cómo exportar o borrar todo.
- Planificar un viajeUn viaje de cinco noches a Lisboa y Sintra preparado de principio a fin: sitios, alojamiento, plan con tiempos, documentos, maleta, avisos y el modo En ruta.