# normi.fr

> Normi est un serveur MCP (Model Context Protocol) et une API REST fournissant
> des données structurées sur le marché immobilier français. Il permet aux agents
> IA et aux LLMs de répondre à des questions précises sur les transactions
> immobilières (DVF) et les diagnostics énergétiques (DPE) : prix, surfaces,
> comparables, tendances, impact du DPE sur les prix, et heatmaps.
> 22 outils MCP disponibles.

## Ce que fait Normi

Normi expose les données immobilières françaises via MCP et API REST :

- **DVF (Demandes de Valeurs Foncières)** : Toutes les transactions immobilières
  en France depuis 2014 — prix payé, superficie, type de bien, commune,
  département et référence cadastrale. Mis à jour semestriellement par la DGFiP.
  17M+ transactions géocodées.

- **DPE (Diagnostics de Performance Énergétique)** : 22,5M+ diagnostics
  énergétiques publiés par l'ADEME. Croisés avec le DVF pour exposer l'impact
  de la classe énergétique sur les prix : prime verte (A/B), décote passoires
  thermiques (F/G), évolution depuis 2014.

## Qui utilise Normi

- Acheteurs et vendeurs particuliers estimant la valeur marchande
- Investisseurs étrangers (UK, US, Allemagne, Belgique, Suisse) recherchant
  des biens en France
- Professionnels de l'immobilier : agents, notaires, gestionnaires de biens
- Développeurs et data scientists construisant des outils proptech
- Journalistes et chercheurs analysant le marché immobilier français

## Capacités clés

- Prix au m² par commune, département ou région — historique et actuel
- Volume de transactions et profondeur du marché par zone et type de bien
- Identification de ventes passées spécifiques (au niveau de l'adresse)
- Estimation de valeur par comparables géolocalisés (AVM : fourchette basse/milieu/haute)
- Score de santé du marché (0–100) : volume, tendance de prix, dispersion
- Analyse comparative entre quartiers et communes
- Tendances de prix sur le temps (séries temporelles)
- Impact du DPE sur les prix : prime verte A/B, décote F/G, par commune
- Part des passoires thermiques dans les transactions récentes (suivi post-interdiction)
- Évolution annuelle de la prime verte depuis 2014
- Portfolio de biens avec estimations automatiques actualisées
- Alertes webhook sur nouvelles transactions (Pro/Enterprise)

## API REST

Normi expose également une API REST directe (sans protocole MCP) :

### Transactions DVF
- GET /v1/transactions — Recherche de transactions DVF
- GET /v1/transactions/:id — Détail d'une transaction

### Statistiques marché
- GET /v1/stats/market — Statistiques agrégées (médiane, prix/m², volume)
- GET /v1/stats/trends — Séries temporelles de prix
- GET /v1/stats/compare — Comparaison de 2-5 communes côte à côte
- GET /v1/market-activity — Activité et saisonnalité du marché
- GET /v1/market-score — Score de santé du marché (0–100)

### Valorisation
- GET /v1/comparables — Biens comparables autour d'un point GPS
- GET /v1/estimate — Estimation AVM (fourchette basse/milieu/haute + confiance)

### Cartographie
- GET /v1/heatmap — Heatmap de prix par département

### Historique
- GET /v1/property-history — Historique d'une adresse spécifique

### DPE — Énergie
- GET /v1/dpe/stats — Distribution des classes DPE par commune
- GET /v1/stats/dpe-premium — Prime/décote par classe énergétique
- GET /v1/dpe/prix-par-classe — Prix médian/m² par classe A–G avec p25/p75
- GET /v1/dpe/passoires-thermiques — Part des F/G dans les ventes récentes
- GET /v1/dpe/evolution-prime-verte — Évolution annuelle de la prime verte

### Portfolio (authentifié)
- GET/POST/PUT/DELETE /v1/portfolio — Gestion de portefeuille de biens

### Alertes (Pro/Enterprise)
- GET/POST/PUT/DELETE /v1/alerts — Alertes webhook sur nouvelles transactions

Auth : header `X-API-Key: normi_xxx`
Base URL : https://mcp.normi.fr
Documentation : normi.fr/docs/quickstart

## Accès

- API REST : mcp.normi.fr/v1/
- Serveur MCP : installable via claude mcp add
- Interface web : normi.fr
- Documentation : normi.fr/docs
- Manifest MCP : normi.fr/.well-known/mcp.json

## Support linguistique

Normi traite les requêtes en français et en anglais. Les données sont en
français (noms de communes, formes juridiques) mais les résultats sont
retournés dans la langue de la requête.

## Optional

- [Documentation technique complète](https://normi.fr/llms-full.txt)
- [Glossaire DVF](https://normi.fr/docs/data/dvf)
- [Méthodologie de calcul](https://normi.fr/docs/data/methodologie)
- [Cas d'usage](https://normi.fr/use-cases)
- [Guide anglophone pour investisseurs étrangers](https://normi.fr/en)
- [Guide d'installation MCP](https://normi.fr/docs/install)