API REST/Référence MCP/analyze_market_statistics

analyze_market_statistics

5 crédits

Statistiques agrégées de marché : prix médian, prix moyen, prix au m², volume de transactions et distribution des surfaces sur une zone et une période données.

Paramètres

Au moins un filtre de localisation est requis : code_postal, commune, code_departement ou coordonnées GPS.

Paramètre	Type	Défaut	Description
code_postal	string	—	Code postal (ex. '33000'). Au moins un filtre de localisation est requis.
commune	string	—	Nom de commune en majuscules (ex. 'BORDEAUX', 'PARIS 01').
code_departement	string	—	Code département (ex. '33').
latitude	number	—	Latitude WGS84. Nécessite aussi longitude.
longitude	number	—	Longitude WGS84. Nécessite aussi latitude.
radius_m	number	500	Rayon en mètres pour la recherche GPS (max 2000).
type_local	enum	—	Maison \| Appartement \| Terrain \| Local commercial \| Dépendance \| Local industriel
date_debut	string	—	Date de début au format YYYY-MM-DD. Par défaut : 3 ans en arrière.
date_fin	string	—	Date de fin au format YYYY-MM-DD. Par défaut : aujourd'hui.
exclude_bulk_sales	boolean	true	Exclure les ventes en lot.
exclude_vefa	boolean	true	Exclure les ventes en VEFA (neuf).
include_terrain	boolean	false	Inclure les terrains dans le calcul des statistiques.

exclude_outliers est obsolète

Les prix aberrants sont retirés à l'ingestion : aucune transaction publiée n'en est un. Le paramètre exclude_outliers n'a donc aucun effet. Il reste accepté pour ne pas casser les appels existants, mais il est ignoré. Voir qualité des données.

Demandez à Claude

Connectez Normi à Claude Desktop ou Claude Code, puis posez directement :

Quel est le prix médian au m² pour les maisons à Bordeaux ?

Exemple de réponse

{
  "location": {
    "commune": "BORDEAUX",
    "code_departement": "33"
  },
  "type_local": "Maison",
  "period": {
    "date_debut": "2021-03-01",
    "date_fin": "2024-03-01"
  },
  "stats": {
    "count": 1842,
    "prix_median": 425000,
    "prix_moyen": 468200,
    "prix_m2_median": 3850,
    "prix_m2_moyen": 4120,
    "surface_mediane": 105,
    "prix_min": 95000,
    "prix_max": 2100000
  },
  "_credits": { "used": 5, "remaining": 90 },
  "query_time_ms": 211
}

Fenêtre temporelle par défaut : 3 ans

Si vous n'indiquez pas date_debut, l'outil couvre automatiquement les 3 dernières années. Pour cibler le marché récent (12 derniers mois), passez date_debut explicitement. Un champ notice apparaît dans la réponse quand une limite automatique a été appliquée.

Visualisation interactive (MCP Apps)

Les hôtes compatibles MCP Apps (Claude, Claude Desktop, etc.) affichent automatiquement les prix médians et, pour le prix au m², le prix de vente et la surface, une bande minimum → maximum où la médiane et la moyenne sont repérées (valeurs au survol). L'écart entre les deux montre combien quelques ventes hors norme tirent la moyenne. Cette visualisation est additive — les clients sans support MCP Apps reçoivent le JSON textuel exact, sans changement. L'interface s'affiche en français, avec une bascule FR / EN.

search_property_transactions

analyze_purchasing_power