`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_median": 245000,
  "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": 245000,
  "ratio_prix_revenu": 11.61,
  "dvf_period": { "date_debut": "2025-01-01", "date_fin": "2025-12-31" },
  "vintage_gap_years": 4,
  "vintage_note": "Prices are 2025–2025 sales; income is INSEE Filosofi 2021, 4 year(s) older. Incomes have risen since, so the ratio overstates today's effort.",
  "filters": { "code_postal": null, "commune": "LYON", "code_commune": null, "type_local": null },
  "notice": "Applied date_debut=2025-01-01 automatically (1-year cap for this scope)",
  "_credits": { "used": 5, "remaining": 495 },
  "query_time_ms": 87
}

Lecture du résultat

ratio_prix_revenu

prix_median / revenu_median_annuel_uc : le prix de vente médian (mêmes ventes et même fenêtre que analyze_market_statistics, VEFA exclue) divisé par le revenu médian. vintage_gap_years donne l'écart entre l'année des ventes et le millésime Filosofi : un revenu plus ancien gonfle le ratio. 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

analyze_rental_yield

analyze_purchasing_power 5 crédits