get_market_overview

10 crédits

Vue complète d'un marché immobilier en un seul appel — statistiques de prix, tendance annuelle et score de santé (0–100).

Outil composite — remplace 3 appels

get_market_overview exécute en parallèle analyze_market_statistics, analyze_price_trends et score_market_health. Utilisez-le comme premier outil pour toute question du type « comment se porte le marché ? » — il économise 15 à 25 crédits par rapport à ces appels séparés.

Paramètres

Au moins un filtre de localisation est requis. Le score de santé ( health) n'est disponible que pour les filtres administratifs (code_postal, commune, code_departement) — pas pour les recherches lat+lon.

Paramètre	Type	Défaut	Description
code_postal	string	—	Code postal (ex. '75011'). Au moins un filtre de localisation est requis.
commune	string	—	Nom de commune en MAJUSCULES (ex. 'PARIS 11', 'LYON', 'BORDEAUX').
code_departement	string	—	Code département (ex. '75', '69', '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 géographique.
type_local	enum	—	Maison \| Appartement \| Terrain \| Local commercial \| Dépendance \| Local industriel

Demandez à Claude

Comment se porte le marché immobilier dans le 11e arrondissement de Paris pour les appartements ?

Exemple de réponse

Résultat pour commune: "PARIS 11", type_local: "Appartement".

{
  "location": {
    "code_postal": null,
    "commune": "PARIS 11",
    "code_departement": null
  },
  "property_type": "Appartement",
  "stats": {
    "count": 1842,
    "price": {
      "min": 120000,
      "max": 2100000,
      "avg": 518400,
      "median": 480000
    },
    "price_per_m2": {
      "min": 3200,
      "max": 18500,
      "avg": 9840,
      "median": 9650
    },
    "surface": {
      "min": 9,
      "max": 210,
      "avg": 52,
      "median": 48
    }
  },
  "trend": {
    "direction": "decreasing",
    "change_1y_pct": -4.2,
    "overall_change_pct": -4.2,
    "last_period": "2025"
  },
  "health": {
    "score": 58,
    "label": "Modéré",
    "data_quality": {
      "count_6m": 312,
      "sufficient": true
    }
  },
  "_credits": { "used": 10, "remaining": 90 },
  "query_time_ms": 487
}

Interpréter les résultats

trend.direction : dérivé de overall_change_pct — "increasing" si >+2%, "decreasing" si <-2%, "stable" sinon.
trend.change_1y_pct : variation YoY de la dernière période annuelle disponible.
Score de santé : 0–30 Calme · 31–60 Modéré · 61–80 Dynamique · 81–100 Très actif.
health: null si la zone n'a pas assez de transactions récentes (<10 sur 6 mois) ou si seule une recherche lat+lon a été fournie.
Pour les détails complets (séries temporelles, composantes du score), utilisez analyze_price_trends et score_market_health séparément.

score_market_health

Portfolio MCP