`analyze_purchasing_power` 5 crédits

Ratio prix/revenu (« pouvoir d'achat immobilier ») : combien d'années de revenu médian faut-il pour acheter le bien médian dans la zone demandée. Croise les médianes de prix/m² et de surface DVF avec le revenu médian disponible par unité de consommation publié par l'INSEE (dispositif Filosofi).

ratio_prix_revenu s'interprète directement : une valeur de 11.86 signifie qu'il faut 11,86 années de revenu médian pour acheter le bien médian de la zone.

Au moins un filtre est requis : code_postal, commune, ou code_commune. code_departement seul et les recherches par rayon (latitude/longitude) ne sont pas supportés — un département regroupe des centaines de communes sans revenu médian unique représentatif. Utilisez analyze_market_statistics ou find_property_comparables pour ces échelles.

Paramètres

Paramètre	Type	Défaut	Description
code_postal	string	—	Code postal (ex. '75011')
commune	string	—	Commune en majuscules (ex. 'LYON', 'PARIS 11')
code_commune	string	—	Code INSEE à 5 chiffres — court-circuite la résolution par commune (ex. '75111')
type_local	enum	—	Maison \| Appartement — filtre le côté DVF du croisement
date_debut	string	—	Date de début (YYYY-MM-DD) — soumise à un plafond automatique sur les grandes zones
date_fin	string	—	Date de fin (YYYY-MM-DD)

Exemple

// Demander à Claude :
// "Combien d'années de revenu médian faut-il pour acheter à Lyon ?"

{
  "tool": "analyze_purchasing_power",
  "arguments": {
    "commune": "LYON"
  }
}

Réponse

{
  "count": 7675,
  "prix_m2_median": 4631.22,
  "surface_median": 54.02,
  "code_commune": "69388",
  "annee_reference": 2021,
  "revenu_median_annuel_uc": 21100,
  "nb_menages_fiscaux": 36868,
  "prix_bien_median": 250179,
  "ratio_prix_revenu": 11.86,
  "filters": { "code_postal": null, "commune": "LYON", "code_commune": null, "type_local": null },
  "notice": "Applied date_debut=2024-07-18 automatically (1-year cap for this scope)",
  "_credits": { "used": 5, "remaining": 495 },
  "query_time_ms": 87
}

Lecture du résultat

ratio_prix_revenu

(prix_m2_median × surface_median) / revenu_median_annuel_uc. Vaut null quand l'INSEE applique le secret statistique sur le revenu de la commune (petites communes rurales) ou quand aucune donnée Filosofi n'est chargée pour ce code INSEE — un message explicite accompagne alors la réponse.

annee_reference

Millésime des données Filosofi (généralement 2 à 3 ans en retard par rapport à l'année en cours — c'est la cadence normale de publication INSEE, pas un signe de donnée périmée).

code_commune spanning plusieurs communes

Pour un code_postal couvrant plusieurs communes, le revenu retourné est celui de l'une des communes correspondantes (résolution rapide, pas nécessairement la commune majoritaire en volume de transactions) — approximation acceptée en v1. Utilisez code_commune pour cibler précisément une commune ou un arrondissement.

Cet outil s'appuie sur une fenêtre de dates plafonnée automatiquement (1 an pour une commune sans type_local, 2 ans sinon) pour éviter les timeouts sur les grandes villes — un notice apparaît dans la réponse quand ce plafond est appliqué.

analyze_market_statistics

find_property_comparables

analyze_purchasing_power 5 crédits