Aller au contenu
Andiamo
Guide d'intégration

Brancher Andiamo sur ton assistant

Un seul connecteur donne accès au train, au bus et à la résolution de lieux. Les outils personnels (profil, surveillances, vols) demandent une URL MCP liée à ton compte.

01

Claude · connecteur personnalisé

#

RéglagesConnecteurs Ajouter un connecteur personnalisé, puis colle l'URL. Transport HTTP streamable, sans authentification. Dans ChatGPT, le même connecteur passe par le mode développeur (abonnement Plus ou Pro).

https://getandiamo.app/api/mcp
claude mcp add --transport http andiamo https://getandiamo.app/api/mcp
02

Train · TGV Max

#

Plusieurs gares de départ, une destination, une date ou une plage. Les directs et les trajets à 1 correspondance, avec le prix : 0 € si TGV Max, sinon la fourchette officielle de l'axe.

La recherche train : plusieurs gares de départ, directs et correspondances, fenêtres horaires. Places TGV Max à 0 €, ou tous les trains avec la fourchette de prix officielle SNCF.

origins · destination · date · depart_after · arrive_before · tgvmax_only

La prochaine place TGV Max sur un trajet, en balayant les ~30 jours du dataset. Pour « quand est-ce que je peux partir à Bordeaux ? ».

origin · destination

Train annulé ou raté ? Les solutions restantes aujourd'hui (à partir de maintenant) et demain matin, toutes gares de départ confondues.

origins · destination · arrive_before
Limite

Les places bougent vite : une disponibilité vue à l'instant T peut avoir disparu au moment de réserver. Le dataset ne couvre que ~30 jours glissants.

SNCF Open Data, dataset tgvmax, ~30 jours glissants

03

Train · tous tarifs

#

Pas d'abonnement TGV Max ? Andiamo élargit la recherche à tous les trains et affiche la fourchette de prix publiée par SNCF, profil Normal ou carte Avantage.

La recherche train : plusieurs gares de départ, directs et correspondances, fenêtres horaires. Places TGV Max à 0 €, ou tous les trains avec la fourchette de prix officielle SNCF.

origins · destination · date · depart_after · arrive_before · tgvmax_only

Résout un nom de ville ou de gare vers les libellés exacts du dataset SNCF : indispensable pour désambiguïser « Paris » ou « Lyon ».

query · limit
Limite

La fourchette vaut pour l'axe en 2ᵉ classe, tous trains confondus : ce n'est pas le prix du train précis. Le prix ferme reste celui du site de vente.

SNCF Open Data, dataset tarifs TGV inOui / Ouigo

04

Bus longue distance

#

Liaisons directes FlixBus et BlaBlaCar Bus entre deux villes, bus de nuit inclus (arrivée le lendemain signalée par arrival_day_offset). Horaires officiels GTFS, sans prix.

Les bus longue distance FlixBus et BlaBlaCar Bus (horaires officiels GTFS), bus de nuit compris. Moins cher, plus lent : les prix ne sont pas publiés en open data.

from_city · to_city · date · depart_after · arrive_before · max_results
Limite

Ces réseaux ne desservent qu'environ 200 villes françaises et n'assurent pas toutes les paires. Hors couverture, l'outil renvoie une explication, pas un vide. Les tarifs ne sont pas publiés en open data.

GTFS transport.data.gouv.fr, ~35 jours glissants

05

Lieux et approche

#

« Fréjus », « 12 rue des Lilas, Bordeaux », « Chamonix » → gares utilisables et temps pour les rejoindre. Dans les 15 agglomérations couvertes, l'approche vient des horaires urbains réels (ligne et arrêt nommés) ; ailleurs, elle est estimée. À appeler avant toute recherche quand l'utilisateur cite un lieu sans nommer de gare.

Convertit une ville, une adresse ou un lieu-dit en gares utilisables, avec la distance et le temps d'approche estimé (marche ou transport local).

query · max_stations · max_km

Métro, tram et bus urbain pour rejoindre une gare depuis une adresse, aux horaires réels : 15 agglomérations couvertes, liaisons directes. Hors couverture, l'approche reste estimée.

from · station · date · arrive_before

Stratégies combinées : train + bus + approche locale dans un même plan porte-à-porte scoré, au lieu d'une comparaison mode par mode. L'outil à appeler en premier.

from · to · date · arrive_before · tgvmax_only
Limite

Les horaires urbains ne couvrent que 15 agglomérations, en liaison directe et sans temps réel ; ailleurs l'approche reste estimée à vol d'oiseau. La sortie de gare est toujours estimée.

Base adresse nationale, référentiel de gares, GTFS urbains du PAN

06

Avion

#

Prix en euros, horaires, escales et émissions CO₂ via Google Flights, pour trancher honnêtement quand le train est long.

search_flightsURL personnelle

Les vols via Google Flights : prix en euros, horaires, escales, émissions CO₂. À comparer au train sans oublier l'accès à l'aéroport.

origin · destination · date
Limite

API payante : 15 recherches par compte et par tranche de 24 h, aller simple uniquement. Le temps d'accès à l'aéroport est à compter en plus.

Google Flights, URL MCP personnelle requise

07

Profil voyageur

#

Ce que l'agent retient de toi entre deux conversations. Appliqué par défaut à chaque recherche lancée depuis ton URL MCP personnelle.

get_my_profileURL personnelle

Lit ton profil voyageur (abonnement TGV Max, cartes de réduction, gares habituelles, préférence) avant de chercher.

update_my_profileURL personnelle

Enregistre tes contraintes au fil de la conversation : plus besoin de les répéter à chaque recherche.

has_tgvmax · discount_cards · home_city · favorite_stations · preference
08

Surveillances et alertes

#

Un trajet complet ? Andiamo repasse toutes les 15 minutes et dépose une alerte dès qu'une place s'ouvre. Les alertes sont dédupliquées.

create_watchURL personnelle

Surveille un trajet sur une période : Andiamo vérifie toutes les 15 minutes et enregistre une alerte dès qu'une place apparaît.

origin · destination · date_from · date_to · notify_email
list_watchesURL personnelle

Tes surveillances en cours : trajet, période, statut, dernière vérification.

delete_watchURL personnelle

Arrête une surveillance et supprime ses alertes.

watch_id
list_alertsURL personnelle

Les disponibilités détectées par tes surveillances, aussi consultables sur le dashboard.

limit · unseen_only
09

Carte des stratégies

#

Chaque recherche renvoie un champ map_url. Le lien contient les trajets dans son fragment : rien n'est envoyé ni stocké côté serveur, et la page reste lisible hors ligne une fois chargée. Ouvre-le pour voir les stratégies sur la carte. La couleur y porte le rang : cuivre plein pour la meilleure stratégie, filet clair pour la troisième. Le pointillé signale une approche locale ou à pied.

10

Prompts à essayer

#

Une fois le connecteur en place, ces phrases suffisent : l'agent choisit lui-même les outils à enchaîner.

  • « Je dois être à Chamonix le 20 août avant 18 h, je pars de Bordeaux. Quelles stratégies ? »

  • « Trouve un TGV Max Paris → Marseille samedi, départ après 9 h. »

  • « Je peux partir de Lille ou de Paris : meilleur plan pour Bordeaux vendredi ? »

  • « Y a-t-il un bus de nuit Lyon → Toulouse cette semaine ? »

  • « Quelles gares sont utilisables depuis 12 rue des Lilas, Bordeaux ? »

  • « Surveille Paris → Nice du 10 au 15 septembre et préviens-moi dès qu'une place TGV Max s'ouvre. »

11

Sources de données

#
Trains, places et tarifs
SNCF Open Data : datasets tgvmax et tarifs TGV inOui / Ouigo (ODbL)
Bus longue distance
GTFS FlixBus et BlaBlaCar Bus via transport.data.gouv.fr
Vols
Google Flights
Adresses et gares
Base adresse nationale + référentiel embarqué de 342 gares

Andiamo est gratuit et n'est affilié à aucun transporteur. Les réseaux de bus ne desservent qu'environ 200 villes françaises, et les vols sont plafonnés à 15 recherches par compte et par 24 h. Pas encore de connecteur ? Teste la recherche dans le playground.

12

Questions fréquentes

#
D'où viennent les données ?

De jeux de données officiels : SNCF Open Data pour les trains et les fourchettes de prix, le GTFS FlixBus et BlaBlaCar Bus publié sur transport.data.gouv.fr pour les bus, la base adresse nationale pour les lieux, Google Flights pour les vols. Andiamo les interroge à chaque recherche, avec un cache très court.

Faut-il un compte ?

Pas pour chercher : l'URL publique du connecteur suffit. Un compte gratuit donne une URL MCP personnelle, qui débloque en plus le profil voyageur, les surveillances, les alertes et la recherche de vols. Traite cette URL comme un mot de passe.

Andiamo réserve-t-il les billets ?

Non. Il cherche, compare et classe les stratégies ; l'achat se fait chez le transporteur : SNCF Connect, FlixBus, BlaBlaCar Bus ou la compagnie aérienne.

Les prix affichés sont-ils fermes ?

Non. 0 €vaut pour une place TGV Max ; sinon Andiamo affiche la fourchette officielle publiée pour l'axe en 2ᵉ classe, tous trains confondus, pas le prix du train précis. Une estimation est précédée de . Le prix ferme reste celui du site de vente.

Quelles sont les limites actuelles ?

Le dataset TGV Max ne couvre qu'environ 30 jours glissants et les places bougent vite. Les réseaux de bus desservent environ 200 villes françaises et n'assurent pas toutes les paires. Les distances d'approche sont à vol d'oiseau et les temps estimés. Les vols sont plafonnés à 15 recherches par compte et par 24 h.

Mes recherches sont-elles stockées ?

Depuis l'URL publique, rien n'est rattaché à toi. Depuis ton URL personnelle, les appels d'outils sont journalisés pour alimenter l'historique du dashboard. Le lien de carte, lui, ne transite jamais : tout tient dans le fragment de l'URL.