API REST/Référence MCP/get_zonal_price_distribution

get_zonal_price_distribution

15 crédits

Statistiques de prix agrégées par zone (code postal ou commune) — retourne des données JSON pour construire des visualisations de type heatmap. Chaque zone inclut des coordonnées centroïde.

Paramètres

code_departement ou commune est obligatoire.

Paramètre	Type	Défaut	Description
code_departement	string	—	Code département (ex. '75', '92'). Requis si commune non fourni.
commune	string	—	Nom de commune en majuscules (ex. 'MARSEILLE'). Requis si code_departement non fourni.
type_local	enum	—	Maison \| Appartement \| Terrain \| Local commercial \| Dépendance \| Local industriel
group_by	enum	code_postal	Granularité d'agrégation : code_postal \| commune.
min_transactions	number	10	Nombre minimum de transactions pour inclure une zone. Les zones avec moins de transactions sont exclues pour fiabilité statistique.
date_debut	string	—	Date de début au format YYYY-MM-DD.
date_fin	string	—	Date de fin au format YYYY-MM-DD.

Demandez à Claude

Pour couvrir l'Île-de-France, Claude peut appeler l'outil plusieurs fois (un département à la fois) :

Génère une heatmap des prix de l'Île-de-France (département 75, 92, 93, 94) pour les appartements.

Exemple de réponse

{
  "code_departement": "92",
  "type_local": "Appartement",
  "group_by": "code_postal",
  "zones": [
    {
      "code_postal": "92100",
      "commune": "BOULOGNE-BILLANCOURT",
      "count": 1243,
      "prix_m2_median": 8750,
      "prix_m2_moyen": 9020,
      "prix_median": 472000,
      "centroid_lat": 48.8352,
      "centroid_lon": 2.2400,
      "relative_position": "expensive"
    },
    {
      "code_postal": "92120",
      "commune": "MONTROUGE",
      "count": 876,
      "prix_m2_median": 7980,
      "prix_m2_moyen": 8210,
      "prix_median": 398000,
      "centroid_lat": 48.8182,
      "centroid_lon": 2.3201,
      "relative_position": "average"
    },
    {
      "code_postal": "92270",
      "commune": "BOIS-COLOMBES",
      "count": 542,
      "prix_m2_median": 6850,
      "prix_m2_moyen": 7100,
      "prix_median": 342000,
      "centroid_lat": 48.9196,
      "centroid_lon": 2.2717,
      "relative_position": "affordable"
    }
  ],
  "department_summary": {
    "total_zones": 38,
    "prix_m2_median_dept": 7620,
    "prix_m2_range": { "min": 5200, "max": 11400 }
  },
  "_credits": { "used": 15, "remaining": 35 },
  "query_time_ms": 578
}

relative_position : expensive / average / affordable

Chaque zone est classée par rapport à la médiane du département : expensive = prix/m² supérieur de plus de 20 % à la médiane, affordable = inférieur de plus de 20 %, average = dans la fourchette ±20 %. Les coordonnées centroid_lat et centroid_lon permettent d'afficher directement les données sur une carte (Mapbox, Leaflet, etc.).

Visualisation interactive (MCP Apps)

Les hôtes compatibles MCP Apps (Claude, Claude Desktop, etc.) affichent automatiquement une heatmap interactive avec les zones représentées sous forme de bulles colorées (proportionnelles au nombre de transactions). La taille des bulles encode le volume de transactions; la couleur indique la classification relative (affordable/average/expensive). Cette visualisation est additive — les clients sans support MCP Apps reçoivent le JSON textuel exact, sans changement.

Cas d'usage