Données immobilières DVF pour vos agents IA
Interrogez 17 millions de transactions immobilières françaises via API REST ou MCP. Compatible curl, Claude Desktop, Cline, Cursor, VSCode et backends.
curl "https://mcp.normi.fr/v1/stats/market?commune=PARIS+01" \ -H "X-API-Key: normi_xxx"
Modes d'accès
REST API, STDIO, HTTP streamable
Outils DVF exposés
search_properties, market_stats + 6 analyses avancées
Prompts guides
quickstart, data quality, best practices
Qualité DVF
x
dedup + outliers filtrés + typage
Pourquoi Normi DVF
11 ans de marché immobilier français, à portée de prompt
17,4 millions de transactions DVF nettoyées, géocodées et accessibles via API REST ou MCP. Ventes réelles — pas des estimations, pas des annonces.
Plug and play DVF
REST API + STDIO + HTTP streamable pour tous vos outils : Claude Desktop, Cline, Cursor, VSCode, backends et scripts curl.
Analyses avancées de marché
Comparables, tendances de prix, heatmap de quartier et historique d'adresse pour des insights actionnables.
Données nettoyées, pas brutes
~6 % de ventes en bloc filtrées, ~3 % d'outliers exclus, géocodage à l'adresse. Le DVF brut contient du bruit — Normi l'élimine.
Transactions DVF par année (en milliers)
Source : DVF, data.gouv.fr, 2014-2024
17,4M+
Transactions géocodées
2014-2024 · 98 départements
36 000+
Communes couvertes
France métropolitaine
< 200 ms
Réponse API médiane
Requête P50 typique
En pratique
Vos données, à l'œuvre
Prompts réels. Sorties réelles. Données DVF authentiques.
Estimations & comparaisons
“Trouve des comparables pour un T3 de 65m² à Lyon 6e et estime le prix médian.”
Analyse de marché
get_price_trends“Évolution du prix m² à Bordeaux entre 2019 et 2024.”
Bordeaux · appartements · 2019–2024
Études & rapports
compare_neighborhoods“Compare Vincennes, Montreuil, Pantin et Bagnolet.”
Paris Est · 2024 · appartements
Intégration REST & MCP
Appel MCP
{
"tool": "search_properties",
"params": {
"commune": "PARIS 15",
"type_local": "Appartement",
"surface_min": 55,
"surface_max": 75
}
}Réponse DVF
{
"total": 47,
"median_prix_m2": 10240,
"transactions": [
{ "adresse": "14 r. Labrouste",
"surface": 62,
"prix_m2": 10240,
"date": "2024-09" }
],
"_credits": { "used": 5, "remaining": 95 }
}Modes d'accès
3 modes d'accès
REST API universelle, STDIO pour vos clients IA locaux, HTTP streamable pour les agents distants. Mêmes données DVF, 3 façons d'y accéder.
- ✓STDIO local — zéro latence réseau
- ✓Fonctionne sans connexion
- ✓Aucun serveur à héberger
{
"mcpServers": {
"normi": {
"command": "npx",
"args": ["-y", "@normi/mcp-dvf"],
"env": { "NORMI_API_KEY": "normi_xxx" }
}
}
}Outils DVF
19 outils MCP
Recherche, statistiques, estimation, score marché, portefeuille et alertes webhook.
search_properties
Recherche DVF avec filtres localisation, prix, surface, date, type de bien et dedup auto.
communetype_localsurface_min/max“Montre les T3 vendus à Nantes en 2024”
market_stats
Stats marché : médiane, moyenne, prix m2, surfaces et volume de transactions sur une zone.
communedate_debuttype_local“Prix médian au m² à Lyon 3e en 2024”
find_comparables
Sélection de biens comparables avec score de similarité et estimation de valeur.
latitudelongitudesurface_min/max“Comparables à 500m pour un T3 de 65m²”
estimate_property
Estimation automatisée (AVM) : fourchette basse/médiane/haute à partir des comparables DVF.
latitudelongitudesurface“Estime un appartement de 65m² à Paris 11”
get_price_trends
Séries temporelles (mois/trimestre/année) avec tendances et YoY.
communegranularitydate_debut“Évolution annuelle à Bordeaux 2019–2024”
get_market_score
Score de santé du marché (0–100) basé sur le volume, la tendance et la dispersion des prix.
code_postalcommunecode_departement“Score de santé du marché à Bordeaux”
compare_neighborhoods
Comparaison de 2 à 5 quartiers avec rankings multi-critères.
locations[]type_local“Compare Montreuil, Vincennes et Pantin”
get_market_activity
Indice d'activité marché (hot/normal/slow) par zone et période.
communemonths“Saisonnalité des ventes à Marseille”
get_market_heatmap
Agrégé par zone avec centroïde GPS pour cartographier le marché.
code_departementcommune“Carte de chaleur du département 75”
get_property_history
Historique d'une adresse avec évolution des prix et transactions associées.
addresscode_postal“Historique du 14 rue de la Paix 75001”
portfolio (×5)
CRUD sur un portefeuille de biens avec estimations DVF automatiques (5 outils).
latitudelongitudetype_localsurface“Ajoute ce bien à mon portefeuille et estime-le”
alert_* (×4)
Alertes webhook sur nouvelles transactions DVF — plan Pro/Enterprise requis (4 outils).
webhook_urlcode_postaltype_local“Alerte dès qu'un appartement se vend > 500k€ à Lyon”
Prompts guides
Guidage IA intégré
3 prompts interactifs pour explorer les données DVF sans mémoriser la doc.
get_started
Pas à pas pour la première requête DVF et les filtres clés.
Cherchez des transactions par lieu, type, prix et date. Exemples concrets inclus pour démarrer en 30 secondes.
explain_data_quality
Explication du nettoyage DVF (dedup, outliers, typage).
Normi fournit des données nettoyées : dédoublonnage, filtrage des outliers, mapping des types — vs DVF brut.
get_query_tips
Bonnes pratiques pour optimiser vos requêtes DVF.
Optimisez vos requêtes : summary_only pour les aperçus, bon outil pour chaque cas, filtres précis pour éviter les timeouts.
Installation express
3 étapes pour démarrer
Token gratuit, config JSON, première requête DVF.
1. Récupérer un token
Générez un token gratuit (normi_xxx) sur la page get-token. Il sert dans NORMI_API_KEY (STDIO) ou Authorization Bearer (HTTP).
2. Configurer votre client MCP
STDIO pour clients locaux (Claude Desktop). HTTP streamable pour Cline/Cursor/VSCode et vos backends (Authorization Bearer).
3. Tester une requête DVF
Demandez : Trouve des appartements vendus entre 2023 et 2024 à Lyon entre 200k et 400k.
"mcpServers": {
"normi": {
"command": "npx",
"args": ["-y", "@normi/mcp-dvf"],
"env": { "NORMI_API_KEY": "normi_xxx" }
}
}Requête test
“Trouve les ventes de maisons entre 2023 et 2024 à Bordeaux entre 250k et 450k avec prix m2.”
FAQ
Questions fréquentes
Réponses aux questions les plus courantes sur l'API Normi DVF.
Qu'est-ce que le serveur MCP DVF Normi ?
Un serveur MCP specialise DVF qui expose 19 outils (search_properties, market_stats, find_comparables, estimate_property, get_price_trends, get_market_score, compare_neighborhoods, get_market_heatmap, get_market_activity, get_property_history, portfolio x5, alerts x4) avec donnees DVF nettoyees et prompts guides.
Comment installer Normi MCP DVF dans Claude Desktop ?
Ajoutez l'entree mcpServers avec la commande npx -y @normi/mcp-dvf et le token NORMI_API_KEY. Le token gratuit se genere sur la page get-token puis vous redemarrez Claude Desktop.
Puis-je utiliser le serveur MCP DVF via HTTP ou derriere un proxy ?
Oui. Le transport streamable-http (/mcp) accepte les proxies et les headers Authorization Bearer normi_xxx. C'est recommande pour Cline, Cursor, VSCode et les backends.
Comment utiliser le HTTP streamable en direct (API) ?
Faites un POST /mcp avec method initialize, recuperez le mcp-session-id, puis tools/list ou tools/call. Ajoutez Authorization Bearer et Accept application/json, text/event-stream (le serveur corrige si besoin).
Comment sont fiabilisees les donnees DVF ?
Deduplication automatique des ventes fractionnees, filtrage des outliers, typage intelligent des biens et valeurs medianes calculees avant envoi dans MCP.
Quelles analyses avancees sont disponibles avec MCP DVF ?
Comparables de biens, tendances de prix, heatmap de marche, historique d'adresse, comparaison de quartiers et analyse d'activite du volume de transactions.