Com funciona
Cercar vols amb les dates del viatge i els aeroports més propers
Kokai no ven bitllets ni consulta preus: cerca a la seva pròpia llista de 3.244 aeroports, sense xarxa, els més propers a la destinació i el de la teva sortida, i construeix l’enllaç de cerca de set webs (Google Vuelos, Skyscanner, Kayak, Momondo, eDreams, Trip.com i Aviasales) amb les dates del viatge i els viatgers ja posats. Fins que no en toques un, no surt res del dispositiu.
En poques paraules
- On és
- Botó «Buscar vuelos» («Cercar vols») al «Resumen» («Resum») del viatge (si encara no ha passat) i a «Documentos» («Documents»).
- Aeroports
- 3.244, els que tenen vols regulars i codi IATA, d’OurAirports (domini públic). Van dins de l’app.
- Aeroports de la destinació
- Els que hi ha a menys de 150 km de la destinació situada al mapa, fins a quatre; els petits compten com si fossin al doble de lluny.
- Webs
- Set: Google Vuelos, Skyscanner, Kayak, Momondo, eDreams, Trip.com i Aviasales. Anada i tornada o només anada.
- Què s’omple
- Aeroport de sortida i d’arribada, dates i viatgers (d’1 a 9). Google Vuelos no admet viatgers a l’enllaç.
- Què surt del dispositiu
- Res fins que toques un enllaç. Només si escrius una ciutat que no és a la llista es cerca a Nominatim per trobar-ne els aeroports.
- Preu
- Gratis. Kokai no cobra res ni s’emporta cap comissió, llevat que algun dia un enllaç sigui d’afiliat, i aleshores ho diu.
Què fa i què no fa
Cercar un vol és gairebé sempre el mateix: triar d’on surts, on vas, les dates i quants viatgeu, i repetir-ho en tres o quatre webs per comparar. Kokai ja sap la destinació, les dates i els viatgers del teu viatge, així que t’estalvia la part repetida: obre cada cercador amb tot això escrit.
- Sí: troba els aeroports propers a la destinació, recorda el teu aeroport de sortida en aquell dispositiu i obre set cercadors amb la cerca feta.
- No: no mostra preus, no compara tarifes ni horaris, no compra bitllets i no avisa si baixa un preu. Tot això ho fa cada web, sota les seves condicions.
- Després: quan compris, afegeix el PDF del bitllet a Documents. Kokai el llegeix al dispositiu, sense IA, i et recorda el vol la vigília.
Per què enllaços i no una cerca dins de l’app
Mostrar preus dins de Kokai exigiria una API de vols o llegir les pàgines de resultats d’altres. Revisat el 17 de setembre de 2026, cap de les dues vies serveix per a una app que no té servidor de cerca ni vol que el teu viatge passi per un:
| Via | Què passa avui |
|---|---|
| Amadeus for Developers | El seu portal d’autoservei, el que donava claus gratis, «es va desmantellar el 17 de juliol»: el seu web ja només ofereix el portal d’empreses. |
| Kiwi.com (Tequila) | El seu portal per a desenvolupadors no deixa entrar: respon amb un error 403. |
| Skyscanner | Les seves API de cerca són per als seus socis comercials, amb normes d’ús i de disseny; el que sí que publica per a tothom és el format dels seus enllaços. |
| Duffel | És una API per vendre bitllets: demana compte, i cada reserva es paga. Una app que no ven res no la necessita. |
| Llegir les pàgines de resultats | Va contra les condicions d’aquestes webs, el navegador ho impedeix (les pàgines d’un altre domini no es poden llegir des d’una app web) i obligaria a enviar el teu viatge a un servidor que ho fes per tu. |
Un enllaç, en canvi, no necessita permís de ningú, funciona igual al navegador i al mòbil, i no envia res fins que el toques. És el mateix que fa Allotjament amb Booking.com o Airbnb.
La llista d’aeroports, sense xarxa
Kokai porta dins la llista d’aeroports d’OurAirports, un projecte de dades obertes de domini públic. Dels seus més de 80.000 aeròdroms es queden els que serveixen per comprar un bitllet: aeroports grans i mitjans, amb vols regulars i amb codi IATA de tres lletres. Són 3.244.
- Què en desa de cadascun
- El codi IATA, el nom, la ciutat, el país, les coordenades (amb tres decimals, uns 100 m) i si és gran, i els seus altres noms («Lisboa» i «Portela» al de Lisboa, «Londres» a Heathrow).
- Quant ocupa
- 278 KB, 112 KB comprimida. Es carrega només en obrir la cerca de vols, no en obrir l’app.
- Com s’actualitza
- Amb
npm run aeropuertos, que torna a baixar la llista i la retalla. La que va a l’app és del 17 de setembre de 2026.
Els noms venen en anglès, tal com els publica OurAirports («Lisbon Humberto Delgado Airport»); el país surt en l’idioma de l’app. El codi IATA és el que s’envia a cada cercador, i és igual en tots els idiomes.
Els aeroports més propers a la destinació
Si la destinació del viatge està situada al mapa, Kokai mesura la distància en línia recta des d’aquest punt fins a cada aeroport de la llista i n’ofereix fins a quatre a menys de 150 km, amb la seva distància. Tria el primer pel seu compte.
Un aeroport gran a 40 km sol tenir més vols que un de petit a 15, així que, en ordenar, els petits compten com si fossin al doble de lluny. Si no n’hi ha cap en 150 km, s’ofereix el més proper, sigui on sigui.
| Destinació situada a… | El que ofereix, en ordre |
|---|---|
| Lisboa | LIS (a 6,6 km) i 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) i ILD, Lleida (a 106 km) |
| Ciutadella de Menorca | MAH, Menorca (a 36 km) i PMI, Palma (a 106 km) |
| Kyoto | ITM, Osaka Itami (a 39 km), UKB, Kobe (a 65 km), KIX, Kansai (a 81 km) i NGO, Chubu (a 96 km) |
| Illa de Flores (Açores) | FLW, Santa Cruz das Flores (a 6 km) |
La distància és en línia recta, no per carretera. Abans de triar un aeroport llunyà, mira com s’arriba des d’allà a la destinació: de vegades el més barat és el que més costa després.
D’on surts
El camp «Desde dónde sales» («D’on surts») es cerca per codi, ciutat o nom, sense tenir en compte accents ni majúscules. Primer surt el codi exacte («MAD»), després les ciutats o els altres noms que comencen pel que has escrit («Londres» dona Heathrow) i després els aeroports amb alguna paraula que comenci així («Humberto» dona Lisboa); en igualtat, els grans al davant.
Es cerca per paraules, no per trossos: «oporto» no troba els aeroports italians que porten «aeroporto» al nom. Si el que has escrit no és a la llista (una ciutat sense aeroport, o un nom en un altre idioma com «Oporto» o «Nueva York»), apareix «Buscar aeropuertos cerca de «…»» («Cercar aeroports a prop de «…»»): Kokai situa aquest lloc al mapa amb Nominatim, com fa amb la destinació del viatge, i n’ofereix els aeroports propers.
L’aeroport de sortida es recorda en aquell dispositiu per al viatge següent. No es copia al teu compte ni als teus altres dispositius.
Les set webs i el format de cada enllaç
Cada enllaç es va obrir a Chromium el 17 de setembre de 2026, de Madrid a Lisboa, del 3 al 8 d’octubre i amb 2 adults, d’anada i tornada i només d’anada, i es va mirar què omplia el web:
| Web | Format | Què omple |
|---|---|---|
| Google Vuelos | google.com/travel/flights?q=… amb la cerca escrita en anglès: Flights to LIS from MAD on 2026-10-03 through 2026-10-08 | Aeroports i dates. Els viatgers, no: cerca per a una persona |
| Skyscanner | skyscanner.net/g/referrals/v1/flights/day-view/ amb origin, destination, outboundDate, inboundDate, adultsv2 i locale | El format és el que publica a la seva documentació; el seu web no deixa entrar un navegador automàtic i no es va poder obrir |
| Kayak | kayak.es/flights/MAD-LIS/2026-10-03/2026-10-08/2adults (kayak.com en anglès) | Aeroports, dates i viatgers |
| Momondo | momondo.es/flight-search/MAD-LIS/2026-10-03/2026-10-08/2adults | Aeroports, dates i viatgers |
| eDreams | edreams.es/travel/#results/type=R;from=MAD;to=LIS;dep=…;ret=…;adults=2 (type=O i sense ret per a només anada) | Aeroports, dates i viatgers |
| Trip.com | es.trip.com/flights/showfarefirst amb dcity, acity, ddate, rdate, triptype (rt o ow) i quantity | Aeroports, dates i viatgers |
| Aviasales | aviasales.com/search/MAD0310LIS08102: origen, dia i mes d’anada, destinació, dia i mes de tornada i viatgers | Aeroports, dates i viatgers |
Van quedar fora Kiwi.com, que amb codis d’aeroport no cerca res (vol noms de ciutat en el seu idioma, com madrid-espana), i Expedia, que no publica el format del seu enllaç i tampoc no el va deixar obrir. Les webs canvien les adreces sense avisar: si un enllaç deixa d’omplir alguna cosa, escriu pel formulari de contacte.
Dates, anada i tornada i viatgers
- «Ida» («Anada») i «Vuelta» («Tornada») comencen amb les dates del viatge, i es poden canviar sense tocar el viatge: per exemple, per mirar si surt més barat tornar un dia després.
- Amb «Solo ida» desapareix la tornada. Si la tornada queda abans de l’anada, els enllaços no es generen fins que s’arregla.
- «Viajeros» («Viatgers») comença amb els del viatge. Els cercadors en reben d’1 a 9, tots com a adults: nens i nadons s’ajusten a cada web.
- Sense aeroport de sortida o d’arribada, o amb tots dos iguals, Kokai diu el que falta en lloc de mostrar enllaços trencats.
Enllaços d’afiliat
Com els d’allotjament, els enllaços de vols estan preparats per a programes d’afiliats, que paguen una comissió a qui els porta una compra sense que el preu canviï. S’activen en compilar l’app (VITE_AFILIADOS), amb els paràmetres de cada programa o amb l’enllaç d’una xarxa que redirigeix. Kayak, Trip.com i Google comparteixen configuració amb els d’allotjament, perquè el programa és el mateix.
Avui l’app es publica sense afiliats. Si algun dia un enllaç ho és, sota la llista surt: «Algunos son enlaces de afiliado: si reservas desde ellos, Kokai puede recibir una comisión, sin que te cueste más.» («Alguns són enllaços d’afiliat: si reserves des d’aquests, Kokai pot rebre una comissió, sense que et costi més.»)
Què surt del teu dispositiu
| Quan | Qui ho rep | Què |
|---|---|---|
| En obrir «Buscar vuelos» | Ningú | La llista d’aeroports va dins de l’app, i els propers es calculen al dispositiu |
| En prémer «Buscar aeropuertos cerca de «…»» | Nominatim, de la Fundació OpenStreetMap | Només el text escrit |
| En tocar un cercador | Aquell web | Els dos codis d’aeroport, les dates, els viatgers i l’idioma, a l’adreça de l’enllaç |
La resta del viatge (els llocs, el pla, els documents) no va a cap enllaç. El que faci cada web amb la teva cerca ho diuen les seves condicions i la seva política de privacitat. Més informació a Les teves dades.
Preguntes freqüents
Kokai em diu quin és el vol més barat?
No. No consulta preus: obre cada cercador amb la teva cerca feta, i la comparació la fa cada web. Obrir-ne dos o tres ajuda a veure si un preu és bo.
Per què Google Vuelos cerca per a una persona?
Perquè la seva adreça no admet el nombre de viatgers: es canvia a la mateixa pàgina, a dalt, al costat de «Anada i tornada». El preu de Google Vuelos és per persona.
I si la meva ciutat no té aeroport?
Escriu-la a «Desde dónde sales» i prem «Buscar aeropuertos cerca de…»: Kokai la situa al mapa i ofereix els aeroports a menys de 150 km.
Serveix per a vols amb escales o de diverses destinacions?
Cerca d’un aeroport a un altre, d’anada i tornada o només d’anada; les escales les proposa cada web. Els viatges de diverses destinacions, de moment, es cerquen al web.
Desa el vol que compro?
No, perquè la compra es fa a l’altre web. Afegeix el PDF del bitllet a «Documentos»: es llegeix al dispositiu i es reconeixen 15 aerolínies (Ryanair, Vueling, Iberia, TAP Air Portugal…), i la vigília t’arriba l’avís.
Fonts i referències
La documentació original del que se cita aquí, consultada en la data de revisió d’aquesta pàgina.
- Open data @ OurAirports OurAirports
- ourairports-data (Unlicense, domini públic) David Megginson, a GitHub
- Referrals: examples (format dels enllaços) Skyscanner Developers
- Usage guidelines de les API Skyscanner Developers
- Avís del tancament del portal d’autoservei Amadeus for Developers
- Cercar bitllets d’avió a Google Vols Ajuda de Google
- Codi d’aeroports IATA Viquipèdia
- Política d’ús de Nominatim Fundació OpenStreetMap
Continua llegint
- AllotjamentCom Kokai organitza l’allotjament per nits: reserves, opcions per comparar, nits sense cobrir, reserves dobles, avisos de cancel·lació i l’adreça sense xarxa.
- Cercar allotjamentCom cercar hotel amb dates a Booking.com, Airbnb, Expedia, Vrbo, Agoda, Trip.com, Kayak i Google Hoteles amb un enllaç: destinació, dates, viatgers i exemples.
- DocumentsCom desa Kokai bitllets, reserves i passaport amb el PDF o la foto per obrir-los sense xarxa, què t’avisa abans que caduquin i què no surt del dispositiu.
- Reserves en PDFQuè treu Kokai del PDF d’una reserva sense IA ni xarxa: 65 marques, 8 classes, etiquetes en 7 idiomes, dates, preu, cancel·lació, amb un exemple de Booking.com.
- Les teves dadesQuè desa Kokai al dispositiu, què va a la còpia del teu compte, quins serveis reben alguna cosa i quan, què no surt mai i com exportar-ho o esborrar-ho tot.
- Planificar un viatgeItinerari de cinc nits per Lisboa i Sintra preparat de principi a fi: llocs, allotjament, pla amb temps, documents, maleta, avisos i el mode En ruta.
Aquesta pàgina en Markdown, per llegir-la amb altres programes