Chercher des chantiers détectés | 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": {
      "type": "chantier"
    },
    "name": "carto_chantiers_rechercher"
  }
}

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"}}'

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

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").

typechantier · 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" }.

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, 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 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_chantiers_rechercher.

CartographiesDocumentation, Les modules Les chantiers détectésDocumentation, 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_transactionsVentes immobilières officielles (DVF) : ~8 millions de mutations depuis 2018, dédupliquées par vente (1…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 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