Location Lookup : résoudre un lieu en location_id via MCP et REST, gratuitement
Location Lookup est le produit CASAFARI qui résout un nom de lieu en location_id. Qu’il s’agisse d’une commune, d’un arrondissement ou d’un code postal, les produits qui raisonnent par zone, comme Area Insights et Property Sourcing, requièrent cet identifiant unique. Accessible gratuitement à 0 token via le serveur MCP https://platform.casafari.com/mcp/locations avec l’outil locations_search ou via REST, Location Lookup constitue l’étape préalable essentielle de toute requête immobilière.
Pourquoi « Saint-Denis » ne suffit pas à une machine
Lorsqu’un utilisateur demande à un assistant les prix immobiliers à Saint-Denis, la machine fait face à une ambiguïté immédiate : s’agit-il de Saint-Denis en Seine-Saint-Denis ou de Saint-Denis à La Réunion ? De la même manière, poser une question sur Montreuil sans précision laisse le choix entre la Seine-Saint-Denis et le Pas-de-Calais. Les mêmes défis se posent en Belgique ou au Luxembourg, où une entité administrative peut désigner indifféremment une ville, un canton ou une région.
La France comptait 34 875 communes au 1er janvier 2025 selon la DGCL. Le Luxembourg recense de son côté les 100 communes du Luxembourg depuis 2023. À cela s’ajoutent les homonymies fréquentes, les codes postaux partagés par plusieurs villages et le découpage spécifique des arrondissements de Paris, Lyon et Marseille. Pour éviter toute erreur d’interprétation, les outils de recherche immobilière n’acceptent pas un nom en texte libre : comme l’indique le dépôt public Casafari MCP sur GitHub (en anglais) mis à jour en octobre 2026, les moteurs requièrent des identifiants précis, un cercle géographique ou un polygone.
Qu’est-ce que Location Lookup et que renvoie-t-il ?
Location Lookup est le produit CASAFARI qui résout un nom de lieu en location_id. Il sert de dictionnaire universel de localisation pour l’ensemble du système. Il accepte des requêtes textuelles courantes et renvoie une liste de candidats structurés, assortis de leur hiérarchie géographique et de leur identifiant unique.
Selon la documentation de la plateforme, l’outil recherche un lieu par son nom ou son code postal, renvoie un lieu avec ses parents, liste ses lieux enfants et retrouve les lieux qui contiennent un point de coordonnées. En cas d’homonymie, l’agent IA reçoit plusieurs options classées et peut soit sélectionner le lieu le plus pertinent selon le contexte, soit demander confirmation à l’utilisateur. Si une zone spécifique semble introuvable, il est utile de consulter le guide que faire si un lieu précis est introuvable.
Une fois le location_id obtenu, l’agent accède directement aux données du secteur dans le graphe de biens CASAFARI (en anglais) qui rassemble, en octobre 2026, l’historique complet des prix et des statuts des biens résidentiels et commerciaux à la vente et à la location à travers 16 pays (États-Unis : lancement en cours, certains États, immobilier commercial uniquement, via Claro AI).
Comment appeler locations_search via MCP ?
L’intégration avec les assistants intelligents s’appuie sur le protocole Model Context Protocol. La plateforme met à disposition un serveur MCP dédié par produit, accessible via l’architecture décrite sur la page Connect sur developers.casafari.com (en anglais) (octobre 2026). Le serveur dédié à la localisation est hébergé à l’adresse https://platform.casafari.com/mcp/locations et expose l’outil locations_search.
La connexion s’effectue en Streamable HTTP avec une authentification OAuth 2.1 dans le navigateur. Il n’y a aucune clé API à copier manuellement : le compte peut être créé lors de la première connexion. La configuration est compatible avec de nombreux clients, notamment Claude (sur le web, sur bureau, sur mobile et via connecteur personnalisé), ChatGPT (en mode développeur), Claude Code, Cursor, VS Code, Codex CLI, Gemini CLI, Devin Desktop, Visual Studio, Zed, Cline, JetBrains Junie, Kiro, Warp ou goose.
Il convient de distinguer les « access tokens » OAuth, qui gèrent l’authentification sécurisée de la session, des « tokens » de consommation qui décomptent l’utilisation des services. Pour en savoir plus sur l’écosystème d’intégration, vous pouvez consulter la page CASAFARI MCP, données immobilières pour les agents IA.
Et via REST, pour un service ou un script ?
Si vous développez une application web, un service d’arrière-plan ou un script d’automatisation, la résolution géographique s’appuie sur les mêmes identifiants. Vous pouvez interroger le dictionnaire via HTTP et obtenir exactement les mêmes identifiants location_id qu’un agent conversationnel, ce qui garantit la cohérence entre vos interfaces assistants et vos traitements automatisés.
L’opération correspondante est GET https://platform.casafari.com/v1/locations/search, avec une clé API de la plateforme ; les paramètres d’appel sont détaillés dans le guide de connexion à la plateforme sur developers.casafari.com (en anglais). Pour une vue d’ensemble, consultez les API de données immobilières CASAFARI. Si vous débutez dans l’intégration de flux de données, prenez le temps de relire ce qu’est une API immobilière pour structurer au mieux vos appels.
Une bonne pratique d’architecture consiste à conserver en cache local les location_id correspondant à vos zones d’intervention habituelles. Bien que l’appel à Location Lookup soit gratuit et rapide, la mise en cache réduit la latence globale de vos traitements automatisés.
Combien coûte Location Lookup ? 0 token, et ce que cela change
Conformément à la FAQ des plans et des tokens (en anglais) mise à jour en octobre 2026, l’appel à Location Lookup coûte exactement 0 token. Cette gratuité s’applique à tous les niveaux d’abonnement :
- Plan Free : 1 000 tokens offerts pour 30 jours, accessible sans carte bancaire.
- Plan Agent : 49 € par mois en facturation annuelle (ou 70 € par mois en engagement mensuel), hors TVA.
- Plan Custom : sur mesure par contrat pour les grands volumes. Sur chaque plan, l’usage supplémentaire se règle en crédits prépayés.
Cette tarification à 0 token modifie la conception de vos flux d’agents IA. En demandant à l’agent de valider systématiquement le lieu au préalable, vous évitez de lancer une requête d’analyse payante sur un secteur erroné. Pour comprendre l’ensemble des bénéfices économiques de cette architecture, découvrez les avantages d’une API de données immobilières.
Résoudre d’abord, interroger ensuite : la règle à donner à votre agent
Pour maximiser la fiabilité de vos assistants, il est recommandé d’inscrire la règle suivante dans les instructions système ou le prompt de votre agent : « Avant tout appel aux outils Area Insights, résous systématiquement le lieu avec locations_search et utilise le location_id renvoyé. »
Cette consigne garantit trois avantages majeurs : une précision géographique absolue, une gestion budgétaire optimale sans gaspillage de tokens et un suivi rigoureux dans vos journaux d’exécution grâce à l’usage d’identifiants uniques.
Les autres produits ont leur propre façon de nommer un lieu : Comparables cherche autour d’un point, d’une adresse ou d’une référence cadastrale ; AgentGraph dispose de son propre outil find_location pour l’Allemagne ; Claro, qui couvre les locaux commerciaux en Espagne et en Allemagne ainsi que les terrains commerciaux en Allemagne, prend les villes et les provinces par leur nom.
Pour tester dès aujourd’hui la résolution de lieux et configurer vos premiers connecteurs, rendez-vous sur la console platform.casafari.com pour essayer sur l’offre Free.
Questions fréquentes
Qu’est-ce que Location Lookup de CASAFARI ?
Location Lookup est le service de CASAFARI qui convertit un nom de lieu (ville, arrondissement, quartier, code postal) en un identifiant unique appelé location_id. Cet identifiant est indispensable pour alimenter les produits qui raisonnent par zone, comme Area Insights ou Property Sourcing. L’outil est accessible par MCP et REST, et son utilisation coûte 0 token selon la FAQ officielle d’octobre 2026.
Comment obtenir un location_id Casafari depuis Claude ou ChatGPT ?
Pour obtenir un location_id, il suffit de connecter le serveur MCP https://platform.casafari.com/mcp/locations à votre client (connecteur personnalisé dans Claude ou mode développeur dans ChatGPT) et de vous authentifier via OAuth 2.1 dans votre navigateur. Demandez ensuite simplement à l’assistant de rechercher un lieu : il exécutera automatiquement l’outil locations_search pour vous retourner les identifiants correspondants.
Combien coûte un appel à Location Lookup ?
Un appel à Location Lookup coûte 0 token, quelle que soit la formule d’abonnement utilisée. Vous pouvez en profiter sur le plan Free (qui offre 1 000 tokens pendant 30 jours sans carte bancaire) ou sur le plan Agent (proposé à 49 € par mois en facturation annuelle ou 70 € par mois en facturation mensuelle, hors TVA).
Pourquoi un agent IA doit-il résoudre le lieu avant d’interroger les données ?
Un agent IA doit résoudre le lieu au préalable car les moteurs d’analyse de CASAFARI requièrent un identifiant structuré, un cercle ou un polygone, et non un libellé textuel. La France comptant 34 875 communes au 1er janvier 2025 (selon la DGCL), les homonymies comme Saint-Denis ou Montreuil sont nombreuses. Résoudre le lieu gratuitement évite de dépenser des tokens sur des requêtes ciblant une mauvaise commune.
Location Lookup fonctionne-t-il pour la Belgique et le Luxembourg ?
Location Lookup résout les lieux du graphe de biens CASAFARI, qui s’étend sur 16 pays selon la documentation officielle d’octobre 2026, dont la Belgique et le Luxembourg, tous deux couverts par Property Sourcing. Vous pouvez consulter les guides dédiés pour vérifier les pays où les données CASAFARI sont disponibles. La documentation ne publie pas de liste de pays par outil ; en cas de doute, lancez une recherche : elle coûte 0 token.