Chercher des ventes immobilières | Documentation Prescriptio

Lecture seule, ouvert à tous les comptes, offre gratuite comprise. Chaque appel compte pour une unité de quota.

généré depuis le schéma

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "mode": "liste"
    },
    "name": "carto_transactions"
  }
}

curl -sS https://prescriptio.fr/api/mcp \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"mode":"liste"},"name":"carto_transactions"}}'

Réponsegénérée depuis le schéma

{
  "_meta": {},
  "next_cursor": "<texte>",
  "results": [
    {
      "fields": {},
      "id": "<texte>",
      "resume": "<texte>",
      "titre": "<texte>"
    }
  ],
  "total_estimated": 0
}

Paramètres

anneeentier

Année des ventes (données depuis 2018). (min 2014, max 2035)

cursortexte

Pagination : repasser tel quel le next_cursor de la page précédente. Omettre pour la première page.

limitentier

Résultats par page (défaut 20, max 50). (min 1, max 50)

localisationobjet

Zone géographique. Une granularité : { région } (couvre tous ses départements en un appel, ne jamais les enumerer) ou { dept } ou { commune } (combinable avec dept pour lever un homonyme). National = omettre localisation (jamais dept:"all" ni "france").

Voir les propriétés

communetexte

Nom de commune (accents/casse ignores), code postal ou code INSEE. Arrondissements de Paris/Lyon/Marseille inclus automatiquement.

depttexte

Code département : 2 chiffres ("69"), "2A"/"2B", ou dom "971"-"976".

inseetexte

Code INSEE exact issu de la carte. Prioritaire sur commune; jamais interprété comme code postal. (format ^(?:[0-9]{5}\|2[A-Ba-b][0-9]{3})$)

regiontexte

Nom officiel de région (ex. "Auvergne-Rhone-Alpes", "Ile-de-France").

modeliste · statistiques

Liste (défaut) renvoie une page. Statistiques calcule sur toutes les ventes de la commune les effectifs, médianes et moyennes par année et type. Pour comparer des prix, utiliser statistiques, jamais une moyenne de la page.

querytexte

Raccourci : code postal 5 chiffres (ex. "69006" = Lyon 6e, un arrondissement precis) ou nom de commune. Equivalent a localisation.commune.

type_localmaison · appartement · local · dependance

Type de bien principal de la vente.

Quand l'utiliser

Filtrer par localisation.commune (nom, code postal ou code INSEE : arrondissements de Paris/Lyon/Marseille inclus), localisation.dept ou localisation.région, plus année et type_local (maison, appartement, local, dependance). Une localisation est obligatoire (pas de listing national). La plus-value (fields.plus_value_eur/pct) n'est renseignee que sur parcelle unique avec une vente précédente fiable. Pour des prix moyens, médians ou comparaisons annuelles, demander mode=statistiques avec une commune seule : agrégats exhaustifs serveur, jamais une moyenne de la page. Exemple : { "localisation": { "commune": "Lyon" }, "annee": 2025, "type_local": "appartement" }.

Texte du registre des outils, rendu lisible ; la vue agent le garde tel quel.

Le prompt qui le déclenche

Voir le prompt

Collez ce prompt dans votre agent IA, une fois Prescriptio connecté. Remplacez ce qui est entre crochets.

Avec Prescriptio, quelles ventes de locaux d'activité ont eu lieu à Nantes l'an dernier, et à quel prix ?

Outil : carto_transactions · Portée : mcp:read, lecture seule · Coût : 1 appel, aucune unité de dossier · Limite : 50 résultats par page au plus

En bref

Effets: lecture seule
Portée OAuth: mcp:read
Conditions d’accès: Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas.
Données lues: la donnée publique du bâti — aucune coordonnée personnelle n'est jamais renvoyée
Distribution: MCP historique
En REST: aucune opération : il s'appelle par le connecteur MCP

Réponse

Le résultat arrive dans content[0].text (le JSON sérialisé) et dans structuredContent (le même objet). L'exemple donne les types, jamais des valeurs réelles. Un champ absent ou null n'est ni un zéro ni une estimation : la source ne l'a pas renseigné.

Erreurs et quotas

Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (marches_dce, mairies_deliberations et leurs téléchargements) qui est décomptée.

Les compteurs d’appels et de dossiers sont communs. Chaque action peut aussi être soumise à des droits et plafonds métier : Codes d'erreur et Authentification et quotas.

Les skills qui s'en servent

prescriptio-analyser-territoiresLe skill du plugin qui route cet outil

Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite carto_transactions.

Les ventes immobilières (DVF)Documentation, Les données CartographiesDocumentation, Les modules Les observatoiresDocumentation, Les données PlaybooksIA, Aller plus loin Analyser un territoireIA, Les skills du plugin

Voir aussi

carto_permis_rechercherPermis de construire, d'aménager et de démolir (base officielle Sitadel, historique national)carto_chantiers_rechercherObjets de chantier (chantier / grue / engin) annotés à l'œil sur une image datée, croisés avec un permis…carto_selection_lireLire exactement la sélection cartographique confiée depuis Prescriptio carto_analyse_enregistrerDéposer une analyse privée dans la vue Cartos de votre organisation Catalogue des outilsTous les outils, rangés par module

[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Chercher des ventes immobilières L'outil carto_transactions de Prescriptio cherche les ventes immobilières publiées par l'administration fiscale (DVF), une ligne par vente, par commune, département ou région ; Prescriptio les couvre de juillet 2020 à fin 2025. ### Squelette d'appel, généré depuis le schéma **MCP (JSON-RPC)** ```json { "id": 1, "jsonrpc": "2.0", "method": "tools/call", "params": { "arguments": { "mode": "liste" }, "name": "carto_transactions" } } ``` **HTTP (curl)** ```bash curl -sS https://prescriptio.fr/api/mcp \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"mode":"liste"},"name":"carto_transactions"}}' ``` ### Forme de la réponse, générée depuis le schéma ```json { "_meta": {}, "next_cursor": "<texte>", "results": [ { "fields": {}, "id": "<texte>", "resume": "<texte>", "titre": "<texte>" } ], "total_estimated": 0 } ``` ## Paramètres | Nom | Type | Requis | Description | |---|---|---|---| | `annee` | entier | — | Année des ventes (données depuis 2018). (min 2014, max 2035) | | `cursor` | texte | — | Pagination : repasser tel quel le `next_cursor` de la page précédente. Omettre pour la première page. | | `limit` | entier | — | Résultats par page (défaut 20, max 50). (min 1, max 50) | | `localisation` | objet | — | Zone géographique. UNE granularité : { région } (couvre tous ses départements en un appel — ne jamais les enumerer) OU { dept } OU { commune } (combinable avec dept pour lever un homonyme). National = OMETTRE localisation (jamais dept:"all" ni "france"). | | `localisation.commune` | texte | — | Nom de commune (accents/casse ignores), code postal ou code INSEE. Arrondissements de Paris/Lyon/Marseille inclus automatiquement. | | `localisation.dept` | texte | — | Code département : 2 chiffres ("69"), "2A"/"2B", ou DOM "971"-"976". | | `localisation.insee` | texte | — | Code INSEE exact issu de la carte. Prioritaire sur commune; jamais interprété comme code postal. (format `^(?:[0-9]{5}\|2[A-Ba-b][0-9]{3})$`) | | `localisation.region` | texte | — | Nom officiel de région (ex. "Auvergne-Rhone-Alpes", "Ile-de-France"). | | `mode` | `liste` · `statistiques` | — | liste (défaut) renvoie une page. statistiques calcule sur toutes les ventes de la commune les effectifs, médianes et moyennes par année et type. Pour comparer des prix, utiliser statistiques, jamais une moyenne de la page. | | `query` | texte | — | Raccourci : code postal 5 chiffres (ex. "69006" = Lyon 6e, un arrondissement precis) ou nom de commune. Equivalent a localisation.commune. | | `type_local` | `maison` · `appartement` · `local` · `dependance` | — | Type de bien principal de la vente. | ## Quand l'utiliser Filtrer par localisation.commune (nom, code postal ou code INSEE — arrondissements de Paris/Lyon/Marseille inclus), localisation.dept ou localisation.région, plus année et type_local (maison, appartement, local, dependance). Une localisation est OBLIGATOIRE (pas de listing national). La plus-value (fields.plus_value_eur/pct) n'est renseignee que sur parcelle unique avec une vente précédente fiable. Pour des prix moyens, médians ou comparaisons annuelles, demander mode=statistiques avec une commune seule : agrégats exhaustifs serveur, jamais une moyenne de la page. Exemple : { "localisation": { "commune": "Lyon" }, "annee": 2025, "type_local": "appartement" }. **Prompt prêt à coller : Le prompt qui le déclenche** ```text Avec Prescriptio, quelles ventes de locaux d'activité ont eu lieu à Nantes l'an dernier, et à quel prix ? ``` Outil : `carto_transactions` · Portée : `mcp:read`, lecture seule · Coût : 1 appel, aucune unité de dossier · Limite : 50 résultats par page au plus ## En bref | | | |---|---| | Effets | lecture seule | | Portée OAuth | `mcp:read` | | Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. | | Données lues | la donnée publique du bâti — aucune coordonnée personnelle n'est jamais renvoyée | | Distribution | MCP historique | | En REST | aucune opération : il s'appelle par le connecteur MCP | ## Réponse Le résultat arrive dans `content[0].text` (le JSON sérialisé) et dans `structuredContent` (le même objet). L'exemple donne les **types**, jamais des valeurs réelles. Un champ absent ou `null` n'est ni un zéro ni une estimation : la source ne l'a pas renseigné. ## Erreurs et quotas Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (`marches_dce`, `mairies_deliberations` et leurs téléchargements) qui est décomptée. Les compteurs d’appels et de dossiers sont communs. Chaque action peut aussi être soumise à des droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas). ## Les skills qui s'en servent - [prescriptio-analyser-territoires](https://prescriptio.fr/skills/prescriptio-analyser-territoires) : Le skill du plugin qui route cet outil ## Les pages qui s'en servent Calculé depuis la documentation : chaque page qui cite `carto_transactions`. - [Les ventes immobilières (DVF)](https://prescriptio.fr/docs/donnees/ventes-immobilieres) : Documentation, Les données - [Cartographies](https://prescriptio.fr/docs/cartographies) : Documentation, Les modules - [Les observatoires](https://prescriptio.fr/docs/donnees/observatoires) : Documentation, Les données - [Playbooks](https://prescriptio.fr/agents-ia/playbooks) : IA, Aller plus loin - [Analyser un territoire](https://prescriptio.fr/skills/prescriptio-analyser-territoires) : IA, Les skills du plugin ## Voir aussi - [carto_permis_rechercher](https://prescriptio.fr/docs/api/carto_permis_rechercher) : Permis de construire, d'aménager et de démolir (base officielle Sitadel, historique national) - [carto_chantiers_rechercher](https://prescriptio.fr/docs/api/carto_chantiers_rechercher) : Objets de chantier (chantier / grue / engin) annotés à l'œil sur une image datée, croisés avec un permis… - [carto_selection_lire](https://prescriptio.fr/docs/api/carto_selection_lire) : Lire exactement la sélection cartographique confiée depuis Prescriptio - [carto_analyse_enregistrer](https://prescriptio.fr/docs/api/carto_analyse_enregistrer) : Déposer une analyse privée dans la vue Cartos de votre organisation - [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module