search_businesses & get_business_detail
Deux outils MCP pour explorer l'annuaire professionnel de l'immobilier à partir des données SIRENE (INSEE). Trouvez les acteurs locaux — agences, notaires, promoteurs, marchands de biens — et croisez leur présence avec les volumes de transactions DVF pour de l'intelligence concurrentielle.
Source : INSEE SIRENE — ~500 000 établissements des secteurs immobiliers (NAF 6831Z, 6910Z, 6832A/B, 6810Z, 4110A–D, 6612Z, 6820A). Données géocodées par l'INSEE via BAN.
search_businesses
Recherche géographique d'établissements actifs dans un rayon autour d'un point GPS. Retourne les résultats triés par distance croissante.
Coût : 5 crédits | Cache : 1h
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| latitude* | number | — | Latitude du centre de recherche (WGS84) |
| longitude* | number | — | Longitude du centre de recherche (WGS84) |
| radius_m | number | — | Rayon en mètres (100–5000, défaut : 1000) |
| type | enum | — | agence | notaire | promoteur | gestionnaire | marchand | courtier | bailleur | all |
| limit | number | — | Nombre de résultats (1–50, défaut : 20) |
| include_dvf_stats | boolean | — | Enrichir avec le volume DVF et le prix médian /m² de la zone (24 derniers mois) |
Types d'établissement
agence— Agences immobilières (NAF 6831Z)notaire— Notaires et activités juridiques (NAF 6910Z)promoteur— Promoteurs immobiliers (NAF 4110A–D)gestionnaire— Gestionnaires de biens et syndics (NAF 6832A/B)marchand— Marchands de biens immobiliers (NAF 6810Z)courtier— Courtiers en crédit immobilier (NAF 6612Z)bailleur— Bailleurs de logements (NAF 6820A)
Exemples d'utilisation
// Trouver les agences dans un rayon de 500m autour d'un bien
search_businesses({
latitude: 48.8566,
longitude: 2.3522,
radius_m: 500,
type: "agence",
limit: 10
})Réponse
{
"businesses": [
{
"siret": "12345678900012",
"siren": "123456789",
"denomination": "ORPI REPUBLIQUE",
"naf_code": "6831Z",
"business_type": "agence",
"adresse": "12 RUE DE LA REPUBLIQUE",
"code_postal": "75011",
"commune": "PARIS",
"latitude": 48.8572,
"longitude": 2.3538,
"date_creation": "2005-03-14",
"is_siege": true,
"distance_m": 187
}
],
"count": 8,
"filters": { "latitude": 48.8566, "longitude": 2.3522, "radius_m": 500, "type": "agence" },
"_credits": { "used": 5, "remaining": 495 },
"query_time_ms": 43
}include_dvf_stats retourne les statistiques DVF du code postal de chaque établissement — pas sa zone de chalandise individuelle. Utile pour contextualiser le marché local, pas pour mesurer des parts de marché.get_business_detail
Récupère les détails complets d'un établissement via l'API ouverte INSEE (en temps réel). Utile pour obtenir la dénomination légale, le statut administratif et l'adresse exacte d'une enseigne identifiée par son numéro SIREN.
Coût : 2 crédits (remboursés si SIREN introuvable)
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| siren* | string | — | Numéro SIREN (9 chiffres) |
Exemple
// Détail d'une enseigne par son SIREN
get_business_detail({ siren: "123456789" })Cet outil effectue un appel en direct à l'API INSEE. Il nécessite que
INSEE_API_TOKEN soit configuré côté serveur. Sans token, il retourne une erreur 503.