API REST/Référence MCP/search_properties

search_properties

5 crédits

Recherche des transactions DVF avec filtres géographiques et par type de bien, prix et surface. Retourne jusqu'à 20 transactions ou un résumé statistique selon le mode choisi.

Paramètres

Au moins un filtre de localisation est requis : code_postal, commune, code_departement ou latitude + longitude.

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. 'LYON', 'PARIS 11'). Utilisez le format arrondissement pour Paris, Lyon, Marseille.
code_departement	string	—	Code département (ex. '69', '75').
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 GPS (max 2000). Au-delà de 1000 m, la requête est auto-limitée aux 12 derniers mois.
type_local	enum	—	Maison \| Appartement \| Terrain \| Local commercial \| Dépendance \| Local industriel
prix_min	number	—	Prix minimum en euros.
prix_max	number	—	Prix maximum en euros.
surface_min	number	—	Surface minimum en m².
surface_max	number	—	Surface maximum en m².
date_debut	string	—	Date de début au format YYYY-MM-DD.
date_fin	string	—	Date de fin au format YYYY-MM-DD.
exclude_bulk_sales	boolean	true	Exclure les ventes en lot (plusieurs biens dans une même mutation).
exclude_outliers	boolean	true	Exclure les prix aberrants (statistiquement hors norme).
limit	number	5	Nombre de transactions à retourner (max 20).
summary_only	boolean	false	Retourner un résumé statistique + 3 exemples au lieu de la liste complète. Recommandé pour éviter de surcharger le contexte LLM.

Demandez à Claude

Connectez Normi à Claude Desktop ou Claude Code, puis posez directement :

Quelles sont les transactions récentes pour des appartements de 60-80m² dans le 11e arrondissement de Paris ?

Exemple de réponse

{
  "total_found": 47,
  "transactions": [
    {
      "id": 2847392,
      "date_mutation": "2024-09-15",
      "commune": "PARIS 11",
      "code_postal": "75011",
      "type_local": "Appartement",
      "valeur_fonciere": 580000,
      "surface_reelle_bati": 68,
      "prix_m2": 8529,
      "nombre_pieces_principales": 3,
      "latitude": 48.8596,
      "longitude": 2.3712,
      "is_bulk_sale": false
    },
    {
      "id": 2847211,
      "date_mutation": "2024-08-22",
      "commune": "PARIS 11",
      "code_postal": "75011",
      "type_local": "Appartement",
      "valeur_fonciere": 495000,
      "surface_reelle_bati": 62,
      "prix_m2": 7984,
      "nombre_pieces_principales": 2,
      "latitude": 48.8573,
      "longitude": 2.3698,
      "is_bulk_sale": false
    }
  ],
  "_credits": { "used": 5, "remaining": 95 },
  "query_time_ms": 134
}

summary_only pour les agents LLM

Passez summary_only=true pour recevoir des statistiques agrégées (médiane, moyenne, prix/m²) accompagnées de 3 transactions représentatives. Cela évite de remplir la fenêtre de contexte avec des dizaines de transactions brutes et réduit la latence.

Serveur MCP — Vue d'ensemble

get_market_stats