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.

Visualisation interactive (MCP Apps)

Les hôtes compatibles MCP Apps (Claude, Claude Desktop, etc.) affichent automatiquement une jauge de santé du marché sur ses quatre paliers (Calme, Modéré, Dynamique, Très actif), les chiffres clés, la variation sur un an et la dispersion des prix au m². 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.

score_market_health

Portfolio MCP