[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