detect_flips 10 crédits

Détecte les reventes rapides (« flips ») au sein d'une commune. Un flip est une vente DVF propre suivie d'une revente du même bien 18 à 24 mois plus tard. L'outil renvoie des indicateurs agrégés : fréquence, marge brute et durée de détention médianes.

code_insee est requis pour éviter toute approximation géographique par code postal. code_commune est accepté comme alias compatible avec le vocabulaire DVF.

Paramètres

ParamètreTypeDéfautDescription
code_inseestringCode INSEE de commune à 5 chiffres (ex. '33063' pour Bordeaux) — requis sauf si code_commune est fourni
code_communestringAlias historique à 5 chiffres de code_insee — pas le fragment commune brut de DVF
type_localenumMaison | Appartement — tous les logements par défaut

Exemple

// Demander à Claude :
// "Quel est le taux de flips sur les appartements à Bordeaux ?"

{
  "tool": "detect_flips",
  "arguments": {
    "code_insee": "33063",
    "type_local": "Appartement"
  }
}

Réponse

{
  "code_insee": "33063",
  "commune": "BORDEAUX",
  "periode": { "date_debut": "2023-12-31", "date_fin": "2025-12-31", "mois": 24 },
  "transactions_revente": 1842,
  "flips_detectes": 46,
  "taux_de_flip": 2.5,
  "marge_brute_mediane": 43500,
  "marge_mediane_pct": 18.42,
  "duree_detention_mediane_jours": 643,
  "methodes_detection": { "cadastre": 42, "adresse_surface": 4 },
  "_credits": { "used": 10, "remaining": 490 },
  "query_time_ms": 164
}

Méthodologie

L'appariement cadastral (section + no_plan) est privilégié. En son absence, l'outil utilise uniquement une adresse normalisée, le même type de bien et une surface comparable à ±20 %. methodes_detection permet d'évaluer la composition de l'échantillon.

marge_brute_mediane ne représente pas un bénéfice net : travaux, frais de notaire, intérêts, impôts et frais de vente ne sont pas connus dans DVF et ne peuvent pas être déduits.