[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Chercher des chantiers détectés

L'outil carto_chantiers_rechercher de Prescriptio cherche les objets de chantier (grue, engin, emprise) repérés sur une image datée et croisés avec un permis de construire ; c'est un échantillon de territoires, pas une carte de France.

### Squelette d'appel, généré depuis le schéma

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "type": "chantier"
    },
    "name": "carto_chantiers_rechercher"
  }
}
```

**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":{"type":"chantier"},"name":"carto_chantiers_rechercher"}}'
```

### 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 |
|---|---|---|---|
| `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"). |
| `type` | `chantier` · `grue` · `engin` | — | Type d'objet detecte. Omettre pour tous les types. |

## Quand l'utiliser

Une annotation ne prouve pas que le chantier est encore en cours : citer detected_at, la date du relevé, et ne pas lire confidence comme une probabilité. Filtrer par localisation (commune / dept / région) et type d'objet. Prolonger avec carto_permis_rechercher (fiche du permis via fields.numero_permis) ou annuaire_entreprises. Exemple : { "localisation": { "dept": "38" }, "type": "grue" }.

**Prompt prêt à coller : Le prompt qui le déclenche**

```text
Avec Prescriptio, y a-t-il des grues détectées dans les Bouches-du-Rhône, et à quels permis sont-elles rattachées ?
```

Outil : `carto_chantiers_rechercher` · 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_chantiers_rechercher`.

- [Cartographies](https://prescriptio.fr/docs/cartographies) : Documentation, Les modules
- [Les chantiers détectés](https://prescriptio.fr/docs/donnees/chantiers-detectes) : 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_transactions](https://prescriptio.fr/docs/api/carto_transactions) : Ventes immobilières officielles (DVF) : ~8 millions de mutations depuis 2018, dédupliquées par vente (1…
- [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