Comment ça marche
Chercher des vols avec les dates du voyage et les aéroports les plus proches
Kokai ne vend pas de billets et ne consulte pas les prix : elle cherche dans sa propre liste de 3 244 aéroports, sans réseau, les plus proches de ta destination et de ton départ, et construit le lien de recherche de sept sites (Google Flights, Skyscanner, Kayak, Momondo, eDreams, Trip.com et Aviasales) avec les dates du voyage et les voyageurs déjà mis. Tant que tu n’en touches pas un, rien ne sort de l’appareil.
En quelques mots
- Où c’est
- Bouton « Chercher des vols » dans le « Résumé » du voyage (s’il n’est pas passé) et dans « Documents ».
- Aéroports
- 3 244, ceux qui ont des vols réguliers et un code IATA, d’OurAirports (domaine public). Ils sont à l’intérieur de l’app.
- Aéroports de la destination
- Ceux qui sont à moins de 150 km de la destination placée sur la carte, jusqu’à quatre ; les petits comptent comme s’ils étaient deux fois plus loin.
- Sites
- Sept : Google Flights, Skyscanner, Kayak, Momondo, eDreams, Trip.com et Aviasales. Aller-retour ou aller simple.
- Ce qui est rempli
- Aéroport de départ et d’arrivée, dates, voyageurs (de 1 à 9) et la monnaie du voyage. Google Flights n’accepte pas les voyageurs dans le lien ; Kayak, Momondo et eDreams utilisent la monnaie de leur site.
- Ce qui sort de l’appareil
- Rien tant que tu ne touches pas un lien. Seulement si tu écris une ville absente de la liste, elle est cherchée sur Nominatim pour trouver ses aéroports.
- Prix
- Gratuit. Kokai ne facture rien et ne prend pas de commission, sauf si un jour un lien est affilié, et alors elle le dit.
Ce qu’elle fait et ce qu’elle ne fait pas
Chercher un vol, c’est presque toujours la même chose : choisir d’où tu pars, où tu vas, les dates et combien vous êtes, et le répéter sur trois ou quatre sites pour comparer. Kokai connaît déjà la destination, les dates et les voyageurs de ton voyage, alors elle t’épargne la partie répétitive : elle ouvre chaque moteur de recherche avec tout ça déjà écrit.
- Oui : elle trouve les aéroports proches de la destination, retient tes aéroports de départ sur cet appareil et ouvre sept moteurs de recherche avec la recherche faite.
- Non : elle n’affiche pas de prix, ne compare ni tarifs ni horaires, n’achète pas de billets et ne prévient pas si un prix baisse. Tout ça, c’est chaque site qui le fait, selon ses conditions.
- Après : quand tu achètes, ajoute le PDF du billet dans Documents. Kokai le lit sur l’appareil, sans IA, et te rappelle le vol la veille.
Pourquoi des liens et pas une recherche dans l’app
Afficher des prix dans Kokai exigerait une API de vols ou la lecture des pages de résultats des autres. Au 17 septembre 2026, aucune des deux voies ne convient à une app qui n’a pas de serveur de recherche et qui ne veut pas que ton voyage passe par un serveur :
| Voie | Ce qui se passe aujourd’hui |
|---|---|
| Amadeus for Developers | Son portail en libre-service, celui qui donnait des clés gratuites, « a été démantelé le 17 juillet » : son site ne propose plus que le portail entreprises. |
| Kiwi.com (Tequila) | Son portail pour développeurs ne laisse pas entrer : il répond par une erreur 403. |
| Skyscanner | Ses API de recherche sont réservées à ses partenaires commerciaux, avec des règles d’usage et de design ; ce qu’il publie pour tout le monde, c’est le format de ses liens. |
| Duffel | C’est une API pour vendre des billets : elle demande un compte, et chaque réservation se paie. Une app qui ne vend rien n’en a pas besoin. |
| Lire les pages de résultats | C’est contraire aux conditions de ces sites, le navigateur l’empêche (les pages d’un autre domaine ne peuvent pas être lues depuis une app web) et il faudrait envoyer ton voyage à un serveur qui le ferait à ta place. |
Un lien, en revanche, n’a besoin de la permission de personne, marche pareil dans le navigateur et sur le téléphone, et n’envoie rien tant que tu ne le touches pas. C’est la même chose que fait Logement avec Booking.com ou Airbnb.
La liste d’aéroports, sans réseau
Kokai embarque la liste d’aéroports d’OurAirports, un projet de données ouvertes du domaine public. De ses plus de 80 000 aérodromes, on garde ceux qui servent à acheter un billet : aéroports grands et moyens, avec vols réguliers et code IATA à trois lettres. Ils sont 3 244.
- Ce qui est gardé de chacun
- Le code IATA, le nom, la ville, le pays, les coordonnées (à trois décimales, environ 100 m) et s’il est grand, plus ses autres noms (« Lisboa » et « Portela » pour celui de Lisbonne, « Londres » pour Heathrow).
- Ce que ça pèse
- 278 Ko, 112 Ko compressée. Elle est chargée seulement à l’ouverture de la recherche de vols, pas à l’ouverture de l’app.
- Comment elle se met à jour
- Avec
npm run aeropuertos, qui retélécharge la liste et la réduit. Celle qui est dans l’app date du 17 septembre 2026.
Les noms arrivent en anglais, tels qu’OurAirports les publie (« Lisbon Humberto Delgado Airport ») ; le pays sort dans la langue de l’app. Le code IATA est ce qui est envoyé à chaque moteur de recherche, et il est le même dans toutes les langues.
Les aéroports les plus proches de la destination
Si la destination du voyage est placée sur la carte, Kokai mesure la distance à vol d’oiseau depuis ce point jusqu’à chaque aéroport de la liste et en propose jusqu’à quatre à moins de 150 km, avec leur distance. Elle choisit le premier d’elle-même.
Un grand aéroport à 40 km a souvent plus de vols qu’un petit à 15, alors au moment de trier, les petits comptent comme s’ils étaient deux fois plus loin. S’il n’y en a aucun à 150 km, le plus proche est proposé, où qu’il soit.
| Destination placée à… | Ce qui est proposé, dans l’ordre |
|---|---|
| Lisbonne | LIS (à 6,6 km) et CAT, Cascais (à 18,7 km) |
| Vilafranca del Penedès | BCN, Barcelone (à 32 km), REU, Reus (à 50 km), GRO, Gérone (à 108 km) et ILD, Lérida (à 106 km) |
| Ciutadella de Minorque | MAH, Minorque (à 36 km) et PMI, Palma (à 106 km) |
| Kyoto | ITM, Osaka Itami (à 39 km), UKB, Kobe (à 65 km), KIX, Kansai (à 81 km) et NGO, Chubu (à 96 km) |
| Île de Flores (Açores) | FLW, Santa Cruz das Flores (à 6 km) |
La distance est à vol d’oiseau, pas par la route. Avant de choisir un aéroport éloigné, regarde comment on rejoint la destination depuis là : parfois le moins cher est celui qui coûte le plus ensuite.
D’où tu pars
Le champ « D’où tu pars » se cherche par code, ville ou nom, sans tenir compte des accents ni des majuscules. D’abord sort le code exact (« MAD »), puis les villes ou les autres noms qui commencent par ce qui est écrit (« Londres » donne Heathrow) et ensuite les aéroports dont un mot commence ainsi (« Humberto » donne Lisbonne) ; à égalité, les grands devant.
La recherche se fait par mots, pas par morceaux : « oporto » ne trouve pas les aéroports italiens dont le nom contient « aeroporto ». Si ce qui est écrit n’est pas dans la liste (une ville sans aéroport, ou un nom dans une autre langue comme « Porto » ou « New York »), apparaît « Chercher des aéroports près de « … » » : Kokai place ce lieu sur la carte avec Nominatim, comme elle le fait avec la destination du voyage, et propose ses aéroports proches.
Les aéroports de départ que tu choisis sont retenus sur cet appareil, jusqu’à six : ils sortent en raccourcis et le dernier est déjà sélectionné. Ils ne sont copiés ni dans ton compte ni sur tes autres appareils.
Les sept sites et le format de chaque lien
Chaque lien a été ouvert dans Chromium le 17 septembre 2026, de Madrid à Lisbonne, du 3 au 8 octobre et avec 2 adultes, en aller-retour et en aller simple, et on a regardé ce que le site remplissait :
| Site | Format | Ce qu’il remplit |
|---|---|---|
| Google Flights | google.com/travel/flights?q=… avec la recherche écrite en anglais : Flights to LIS from MAD on 2026-10-03 through 2026-10-08, et curr pour la monnaie | Aéroports, dates et monnaie. Les voyageurs, non : il cherche pour une personne |
| Skyscanner | skyscanner.net/g/referrals/v1/flights/day-view/ avec origin, destination, outboundDate, inboundDate, adultsv2, locale et currency | Le format est celui qu’il publie dans sa documentation ; son site ne laisse pas entrer un navigateur automatisé et n’a pas pu être ouvert |
| Kayak | kayak.es/flights/MAD-LIS/2026-10-03/2026-10-08/2adults (kayak.com en anglais) | Aéroports, dates et voyageurs. La monnaie, non : elle vient avec le domaine |
| Momondo | momondo.es/flight-search/MAD-LIS/2026-10-03/2026-10-08/2adults | Aéroports, dates et voyageurs. La monnaie, non : elle vient avec le domaine |
| eDreams | edreams.es/travel/#results/type=R;from=MAD;to=LIS;dep=…;ret=…;adults=2 (type=O et sans ret pour l’aller simple) | Aéroports, dates et voyageurs. La monnaie, non : elle vient avec le domaine |
| Trip.com | es.trip.com/flights/showfarefirst avec dcity, acity, ddate, rdate, triptype (rt ou ow), quantity et curr | Aéroports, dates, voyageurs et monnaie |
| Aviasales | aviasales.com/search/MAD0310LIS08102 : origine, jour et mois de l’aller, destination, jour et mois du retour et voyageurs, et ?currency=eur | Aéroports, dates, voyageurs et monnaie (sans elle, des dollars) |
Sont restés dehors Kiwi.com, qui avec des codes d’aéroport ne cherche rien (il veut des noms de ville dans sa langue, comme madrid-espana), et Expedia, qui ne publie pas le format de son lien et n’a pas non plus laissé l’ouvrir. Les sites changent leurs adresses sans prévenir : si un lien ne remplit plus quelque chose, écris par le formulaire de contact.
Dates, aller-retour et voyageurs
- « Aller » et « Retour » démarrent avec les dates du voyage, et peuvent être changés sans toucher au voyage : par exemple, pour voir si c’est moins cher de rentrer un jour plus tard.
- Avec « Aller simple », le retour disparaît. Si le retour tombe avant l’aller, les liens ne sont pas générés tant que ce n’est pas corrigé.
- « Voyageurs » démarre avec ceux du voyage. Les moteurs de recherche reçoivent de 1 à 9, tous comme adultes : enfants et bébés se règlent sur chaque site.
- Sans aéroport de départ ou d’arrivée, ou avec les deux identiques, Kokai dit ce qui manque au lieu d’afficher des liens cassés.
Liens affiliés
Comme ceux du logement, les liens de vols sont prêts pour des programmes d’affiliation, qui versent une commission à qui leur amène un achat sans que le prix change. Ils s’activent à la compilation de l’app (VITE_AFILIADOS), avec les paramètres de chaque programme ou avec le lien d’un réseau qui redirige. Kayak, Trip.com et Google partagent la configuration avec ceux du logement, parce que le programme est le même.
Aujourd’hui l’app est publiée sans affiliation. Si un jour un lien l’est, sous la liste sortira : « Certains sont des liens affiliés : si tu réserves depuis eux, Kokai peut recevoir une commission, sans que ça te coûte plus cher. »
Ce qui sort de ton appareil
| Quand | Qui le reçoit | Quoi |
|---|---|---|
| À l’ouverture de « Chercher des vols » | Personne | La liste d’aéroports est dans l’app, et les plus proches sont calculés sur l’appareil |
| En appuyant sur « Chercher des aéroports près de « … » » | Nominatim, de la Fondation OpenStreetMap | Seulement le texte écrit |
| En touchant un moteur de recherche | Ce site | Les deux codes d’aéroport, les dates, les voyageurs, la langue et la monnaie du voyage, dans l’adresse du lien |
Le reste du voyage (les lieux, le programme, les documents) ne va dans aucun lien. Ce que chaque site fait de ta recherche, ce sont ses conditions et sa politique de confidentialité qui le disent. Plus dans Tes données.
Questions fréquentes
Kokai me dit quel est le vol le moins cher ?
Non. Elle ne consulte pas les prix : elle ouvre chaque moteur de recherche avec ta recherche faite, et la comparaison, c’est chaque site qui la fait. En ouvrir deux ou trois aide à voir si un prix est bon.
Pourquoi Google Flights cherche pour une seule personne ?
Parce que son adresse n’accepte pas le nombre de voyageurs : ça se change sur la page elle-même, en haut, à côté de « Aller-retour ». Le prix de Google Flights est par personne.
Et si ma ville n’a pas d’aéroport ?
Écris-la dans « D’où tu pars » et appuie sur « Chercher des aéroports près de… » : Kokai la place sur la carte et propose les aéroports à moins de 150 km.
Est-ce que ça marche pour des vols avec escales ou à plusieurs destinations ?
Elle cherche d’un aéroport à un autre, en aller-retour ou en aller simple ; les escales, c’est chaque site qui les propose. Les voyages à plusieurs destinations se cherchent, pour l’instant, sur le site.
Est-ce qu’elle garde le vol que j’achète ?
Non, parce que l’achat se fait sur l’autre site. Ajoute le PDF du billet dans « Documents » : il est lu sur l’appareil et 15 compagnies sont reconnues (Ryanair, Vueling, Iberia, TAP Air Portugal…), et la veille l’alerte t’arrive.
Sources et références
La documentation d’origine de ce qui est cité ici, consultée à la date de révision de cette page.
- Open data @ OurAirports OurAirports
- ourairports-data (Unlicense, domaine public) David Megginson, sur GitHub
- Referrals: examples (format des liens) Skyscanner Developers
- Usage guidelines des API Skyscanner Developers
- Avis de fermeture du portail en libre-service Amadeus for Developers
- Trouver des billets d’avion sur Google Flights Aide de Google
- Code AITA des aéroports Wikipédia
- Politique d’usage de Nominatim Fondation OpenStreetMap
À lire ensuite
- LogementComment Kokai organise le logement par nuits : réservations, options à décider, trous et doubles réservations, alertes d’annulation et l’adresse de l’hôtel sans réseau.
- Chercher un logementComment construire le lien de recherche de Booking.com, Airbnb, Expedia, Vrbo, Agoda, Trip.com, Kayak et Google Hotels avec destination, dates et voyageurs.
- 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.
Cette page en Markdown, pour la lire avec d’autres programmes