Plateforme API et MCP CASAFARI : les données immobilières pour vos agents IA
Découvrez la plateforme API et MCP CASAFARI, qui permet de connecter Claude, ChatGPT ou vos scripts aux données immobilières de 16 pays (États-Unis : lancement en cours, certains États, immobilier commercial uniquement, via Claro AI) via un seul compte.
La plateforme API et MCP CASAFARI (platform.casafari.com) est la plateforme en libre-service où les agents IA et leurs utilisateurs accèdent aux données immobilières de CASAFARI : un index dédoublonné de biens résidentiels et commerciaux dans 16 pays, dont la France, la Belgique et le Luxembourg. Cinq serveurs MCP et deux API REST sont accessibles via un seul compte et un unique solde de tokens, avec une inscription sans carte bancaire et une authentification OAuth sécurisée.
Qu'est-ce que la plateforme API et MCP CASAFARI ?
Imaginez un responsable data au sein d'un réseau immobilier à Lyon. Un lundi matin, il demande à Claude d'analyser le marché du 6e arrondissement : obtenir l'évolution récente des prix au mètre carré et sélectionner trois biens comparables pour un appartement de 85 m². Sans ouvrir un seul portail immobilier ni copier la moindre clé d'accès, son agent interroge directement la plateforme CASAFARI, récupère des données consolidées et formule une synthèse précise. Le professionnel conserve le contrôle final sur les documents générés et signés.
La plateforme centralise la gestion des comptes, des clés d'accès REST et des identifiants OAuth. Derrière cette interface unique se trouve le graphe immobilier de CASAFARI, recensant des millions de biens résidentiels et commerciaux. Selon la documentation officielle du graphe immobilier CASAFARI (octobre 2026), chaque propriété constitue un enregistrement unique qui regroupe l'ensemble des annonces issues de multiples sources, avec l'historique complet des variations de prix, des changements de statut et des retraits du marché.
Pour vos projets d'automatisation, vous pouvez consulter la page produit Casafari MCP, données immobilières pour les agents IA ou vous orienter vers les API de données immobilières CASAFARI pour des intégrations sur mesure.
Pourquoi CASAFARI est conçue pour les agents IA
Conçue dès l'origine pour les architectures agentiques (« AI-agent native »), la plateforme répond aux besoins d'intégration des assistants modernes à travers cinq fonctionnalités clés :
- Un compte unique : une seule inscription permet de piloter la consommation des agents IA comme celle des requêtes développeurs.
- Connexion OAuth sans clé à manipuler : l'utilisateur s'authentifie dans son navigateur, évitant toute exposition manuelle de clés de sécurité.
- Outils en lecture seule : sur les 21 outils MCP documentés en octobre 2026, 19 sont strictement limités à la lecture de données.
- Documentation lisible par la machine : des fiches structurées en Markdown, des spécifications OpenAPI et des guides dédiés (auth.md et llms.txt) permettent aux agents de comprendre de manière autonome la structure de l'API.
- Tarification transparente en tokens : chaque outil affiche le nombre exact de tokens consommés par appel dans sa description.
CASAFARI est d'ailleurs référencée dans le registre officiel MCP sous l'identifiant com.casafari, figure dans le répertoire Cursor Directory et le service Claro AI est disponible dans le répertore de connecteurs de Claude.
Les serveurs MCP, un par produit
La plateforme met à disposition cinq serveurs MCP distincts, utilisant le protocole de transport Streamable HTTP et le standard d'autorisation OAuth 2.1. Chaque produit dispose de sa propre adresse de serveur sous platform.casafari.com/mcp/.
Location Lookup
Accessible à l'adresse https://platform.casafari.com/mcp/locations, Location Lookup constitue la première étape de la plupart des requêtes. Cet outil gratuit convertit un nom de lieu usuel (comme « Lyon 6e », « Ixelles » ou « Esch-sur-Alzette ») en identifiant de zone CASAFARI. Ces recherches d'emplacements restent gratuites même après l'épuisement de la période d'essai.
Area Insights
Disponible via https://platform.casafari.com/mcp/area-insights, ce serveur regroupe 7 outils d'analyse territoriale. Il fournit des séries temporelles de prix, des répartitions par tranche de prix, par nombre de pièces ou par durée de commercialisation, ainsi que des calculs statistiques (taux de croissance annuel composé, volatilité) et des cartes thermiques par quartier. Vous trouverez des informations détaillées sur Insights de Zone, l'analyse de marché par quartier.
Comparables
Proposé à l'adresse https://platform.casafari.com/mcp/comparables, ce serveur permet d'extraire des biens similaires à un logement cible et d'obtenir une estimation statistique de valeur. Utilisé par des experts en évaluation ou des établissements bancaires, cet outil permet à l'agent IA d'effectuer le travail préparatoire de collecte avant validation humaine. Pour en savoir plus sur l'impact de l'automatisation dans les réseaux, découvrez notre article sur l'IA agentique au service des réseaux immobiliers ainsi que l'étude de cas Porta da Frente Christie's sur l'IA agentique.
AgentGraph AI
Situé à l'adresse https://platform.casafari.com/mcp/agentgraph, AgentGraph AI comporte 13 outils dédiés à l'analyse des agences et agents immobiliers sur le marché allemand. Réservé aux entreprises vérifiées, il permet de filtrer des profils d'acteurs, de consulter des cartes de sectorisation et d'interagir avec des notes de partenariat. Il contient les 2 seuls outils d'écriture de la plateforme (gestion de listes de suivi), qui nécessitent systématiquement une confirmation explicite de l'utilisateur.
Claro AI
Accessible via https://platform.casafari.com/mcp/claro, Claro AI est spécialisé dans la recherche de locaux commerciaux (à louer ou à vendre) en Espagne et de terrains commerciaux en Allemagne à partir de requêtes en langage naturel. Il intègre des données de Location Intelligence (flux piétons, démographie, sociologie des résidents). Selon les données de github.com/casafari/casafari-mcp enregistrées le 16 octobre 2026, Claude a par exemple sélectionné les 6 meilleurs locaux pour un café spécialisé à Valence parmi 546 résultats, ou réduit un panel de 1 279 terrains industriels en Allemagne à 6 sites pour un centre de contrôle technique.
Les produits REST sur le même compte : Property Sourcing et High Potential Seller Leads
Outre les serveurs MCP, la plateforme donne accès à deux produits au format REST traditionnel via l'adresse https://platform.casafari.com/v1/<produit> :
- Property Sourcing : permet d'effectuer des recherches directes dans le graphe immobilier, de consulter l'historique complet d'un bien ou de convertir le lien d'une annonce de portail vers sa fiche unique.
- High Potential Seller Leads : identifie les propriétaires ayant effectué des baisses de prix répétées sur leur bien. Les réponses contiennent exclusivement les caractéristiques techniques du bien et l'historique des prix, à l'exclusion de tout nom, numéro de téléphone ou adresse e-mail.
L'authentification s'effectue au moyen d'une clé d'API (cf_sk_…) transmise dans l'en-tête Authorization: Bearer. Pour en savoir plus sur les principes de base, vous pouvez consulter ce qu'est une API immobilière.
Inscription, plans et tokens : comment cela fonctionne
L'accès à la plateforme s'effectue en ouvrant un compte sur la console CASAFARI, sans qu'aucune carte bancaire ne soit requise au départ.
Les modalités de consommation s'organisent comme suit :
- Plan Free : attribue un solde de 1 000 tokens valable durant les 30 premiers jours. Les requêtes sur Location Lookup restent gratuites au-delà de cette période.
- Plan Agent : formule d'abonnement mensuel pour un usage régulier.
- Plan Custom : ajusté sur mesure par contrat pour les clients grands comptes.
- Tokens prépayés : permettent d'ajouter des tokens selon les besoins.
Chaque appel à un outil MCP ou à un point d'entrée REST consomme un nombre fixe de tokens, précisé dans la documentation de l'outil. En cas d'épuisement du solde, seul l'utilisateur humain peut recharger le compte depuis la console. Pour consulter le détail des formules, référez-vous à la FAQ des plans et des tokens sur developers.casafari.com (en anglais).
Comment connecter votre agent : Claude, ChatGPT, Claude Code, Gemini CLI et les autres
La connexion d'un assistant aux serveurs MCP CASAFARI s'effectue en quelques étapes :
- Claude (claude.ai, application Desktop et mobile) : rendez-vous dans Personnaliser → Connecteurs → Ajouter un connecteur personnalisé, collez l'URL du serveur MCP souhaité et validez l'authentification dans votre navigateur. Pour les formules Team et Enterprise, l'ajout est réalisé par le propriétaire de l'organisation, comme indiqué dans l'aide de Claude sur les connecteurs personnalisés (en anglais).
- ChatGPT : activez le mode développeur puis créez un connecteur avec l'URL du serveur MCP et le protocole OAuth, conformément aux directives de l'aide d'OpenAI sur le mode développeur de ChatGPT (en anglais).
- Claude Code et Gemini CLI : utilisez les commandes d'ajout de serveur (
claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables) ou passez par le dépôt GitHub casafari/casafari-mcp.
Les environnements tels que Cursor, VS Code, Zed, Cline ou JetBrains sont également pris en charge. Pour retrouver les instructions complètes, consultez le guide de connexion sur developers.casafari.com (en anglais).
Sécurité : ce que votre agent peut faire, et ce qu'il ne peut pas
La sécurité de la plateforme repose sur la norme OAuth 2.1 avec vérification PKCE et enregistrement dynamique des clients. Le client ne traite à aucun moment les identifiants principaux de l'utilisateur.
Selon la page Sécurité de la plateforme (en anglais) :
- Les access tokens émis sont restreints à un seul serveur (conformément à la norme RFC 8707) et disposent d'une durée de validité de 15 minutes. Les jetons de rafraîchissement (refresh tokens) sont renouvelés à chaque utilisation.
- Pour les agents fonctionnant sans supervision, la connexion s'appuie sur une clé d'API ou un client confidentiel configuré depuis la console.
- 19 des 21 outils MCP documentés fonctionnent exclusivement en lecture seule. Les deux outils de modification (listes de suivi d'AgentGraph AI) demandent une validation préalable de l'utilisateur.
- Les clés d'accès circulent uniquement dans l'en-tête HTTP
Authorizationet ne sont jamais transmises dans les URL. Les réponses des outils sont traitées strictement comme des structures de données afin d'éviter les injections d'instructions (prompt injection).
Et ensuite ? Documentation, cas d'usage et pages produits
Pour poursuivre la mise en place de vos agents, vous pouvez vous référer aux ressources techniques de developers.casafari.com (en anglais), consulter les exemples Claro AI rédigés par Claude (en anglais) ou parcourir les points d'entrée lisibles par la machine pour les agents (en anglais).
Vous pouvez dès à présent créer un compte sur la console CASAFARI, sans carte bancaire pour tester les fonctionnalités et connecter vos premiers agents.
Questions fréquentes
Qu'est-ce qu'un serveur MCP et à quoi sert-il dans l'immobilier ?
Le protocole MCP (Model Context Protocol) est un standard ouvert permettant à un assistant IA comme Claude ou ChatGPT de se connecter de manière sécurisée à des sources de données externes. Chez CASAFARI, chaque produit est disponible sous forme de serveur MCP spécialisé (Location Lookup, Area Insights, Comparables, AgentGraph AI, Claro AI). Cela permet à un agent d'analyser directement des tendances de marché ou des biens comparables sans nécessiter de saisie manuelle.
Comment connecter Claude ou ChatGPT aux données immobilières de CASAFARI ?
Dans Claude, la connexion s'effectue en accédant au menu Personnaliser, puis Connecteurs, et en saisissant l'URL du serveur MCP visé (par exemple pour le serveur Comparables). Dans ChatGPT, l'intégration s'opère via le mode développeur en renseignant l'adresse du serveur et le mode d'authentification OAuth. La validation s'effectue dans le navigateur sans qu'aucune clé d'accès ne soit copiée manuellement.
Combien coûte l'utilisation de la plateforme API et MCP CASAFARI ?
L'inscription est accessible sans carte bancaire et donne accès au plan Free, qui comprend un solde de 1 000 tokens valable durant 30 jours, les recherches de lieux restant gratuites par la suite. La plateforme propose ensuite un plan Agent sous forme d'abonnement mensuel, des plans Custom pour les clients sous contrat, ainsi que des recharges de tokens prépayés. Chaque appel d'outil consomme un nombre fixe de tokens indiqué dans sa documentation.
Les données CASAFARI couvrent-elles la France, la Belgique et le Luxembourg ?
Oui, les données du graphe immobilier CASAFARI couvrent 16 pays (États-Unis : lancement en cours, certains États, immobilier commercial uniquement, via Claro AI), incluant la France, la Belgique et le Luxembourg pour les outils Location Lookup, Area Insights, Comparables, Property Sourcing et High Potential Seller Leads. Seules certaines fonctionnalités spécifiques ont une couverture ciblée : AgentGraph AI couvre uniquement l'Allemagne pour les entreprises vérifiées, tandis que Claro AI traite les locaux commerciaux en Espagne et les terrains commerciaux en Allemagne. Vous pouvez consulter la liste des pays couverts par les données CASAFARI pour plus de précisions.
Un agent IA peut-il dépenser de l'argent ou modifier des données avec mon compte ?
Non, les agents IA ne disposent d'aucun moyen pour effectuer des achats ou ajouter des tokens sur votre compte : en cas de solde insuffisant, seul un utilisateur humain peut intervenir depuis la console. De plus, 19 des 21 outils MCP documentés sont strictement restreints à la lecture de données. Les deux seuls outils autorisant une écriture nécessitent une validation préalable de l'utilisateur.
L'utilisation de CASAFARI par un agent IA est-elle compatible avec le RGPD ?
La plateforme repose sur des mécanismes de sécurité stricts, incluant une authentification OAuth 2.1 et des outils opérant principalement en lecture seule. Les flux de prospection issus de High Potential Seller Leads ne transmettent aucun nom, numéro de téléphone ni adresse e-mail, la prise de contact restant entièrement à la charge de l'utilisateur. Il appartient à chaque organisation d'évaluer la conformité globale de ses propres traitements et agents IA.