Chercher des projets | 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": {},
    "name": "projets_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":{},"name":"projets_rechercher"}}'

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

{
  "action": "<texte>",
  "download_url": "<texte>",
  "fields": {},
  "files": [
    {}
  ],
  "ok": false,
  "page": 0,
  "pages_total": 0,
  "quota": {},
  "texte": "<texte>"
}

Paramètres

query_stringtexte

Filtres de l’URL /projets, par exemple dept=69&dept=38&stade=preparation&fresh=90&page=2. Ajouter vue=acteurs pour les agrégats d’acteurs. (max. Caractères 16000)

Quand l'utiliser

Fournir query_string depuis l’URL de la sélection (sans le ?). Paramètrès répétés pour dept, insee (codes exacts), stade, segment, source, role. Fresh=0 pour tout l’historique, sinon 365 jours par défaut. Vue=acteurs agrège les intervenants sans double compter les logements. Acteur=ma-base restreint aux projets où une entreprise de la base de l’appelant intervient. Les informations absentes restent inconnues. Une attribution ne prouve pas le démarrage du chantier. Réutiliser la query retournée pour paginer. Ma base est limitée à l’organisation de l’appelant.

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, montre les projets du bâti du Rhône apparus ces 90 derniers jours, avec leurs intervenants.

Outil : projets_rechercher · Portée : mcp:read, lecture seule · Coût : 1 appel, aucune unité de dossier · Limite : 100 appels par 24 heures en compte gratuit, 5 000 abonné

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-suivre-projetsLe skill du plugin qui route cet outil

Les pages qui s'en servent

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

ProjetsDocumentation, Les modules Radar réseaux sociauxDocumentation, Les modules Les permis de construire (Sitadel)Documentation, Les données Suivre les projets de construction d'un territoire et leurs acteursGuides, Prescripteur de matériaux Prompts du prescripteur de matériauxIA, Prompts par métier Prompts du bureau d'étudesIA, Prompts par métier Rechercher et suivre des projetsIA, Les skills du plugin Comment repérer un projet de construction avant l'appel d'offres ?Base de connaissances, Repérer les affaires

Voir aussi

projets_fiche_lireLire une fiche projet fusionnée par son UUID : résumé factuel, preuves datées et références sources,…projets_suivi_modifierAgir sur un projet dans votre organisation avec la même transaction que l’interface projets_analyseAnalyse du secteur dans l’écran Projets Catalogue des outilsTous les outils, rangés par module

[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Chercher des projets L'outil projets_rechercher de Prescriptio cherche les projets du bâti reconstitués par Prescriptio, avec les filtres des vues Liste, Carte et Acteurs : département, stade, source, rôle, fraîcheur. ### Squelette d'appel, généré depuis le schéma **MCP (JSON-RPC)** ```json { "id": 1, "jsonrpc": "2.0", "method": "tools/call", "params": { "arguments": {}, "name": "projets_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":{},"name":"projets_rechercher"}}' ``` ### Forme de la réponse, générée depuis le schéma ```json { "action": "<texte>", "download_url": "<texte>", "fields": {}, "files": [ {} ], "ok": false, "page": 0, "pages_total": 0, "quota": {}, "texte": "<texte>" } ``` ## Paramètres | Nom | Type | Requis | Description | |---|---|---|---| | `query_string` | texte | — | Filtres de l’URL /projets, par exemple dept=69&dept=38&stade=preparation&fresh=90&page=2. Ajouter vue=acteurs pour les agrégats d’acteurs. (max. caractères 16000) | ## Quand l'utiliser Fournir query_string depuis l’URL de la sélection (sans le ?). Paramètrès répétés pour dept, insee (codes exacts), stade, segment, source, role. fresh=0 pour tout l’historique, sinon 365 jours par défaut. vue=acteurs agrège les intervenants sans double compter les logements. acteur=ma-base restreint aux projets où une entreprise de la base de l’appelant intervient. Les informations absentes restent inconnues. Une attribution ne prouve pas le démarrage du chantier. Réutiliser la query retournée pour paginer. Ma base est limitée à l’organisation de l’appelant. **Prompt prêt à coller : Le prompt qui le déclenche** ```text Avec Prescriptio, montre les projets du bâti du Rhône apparus ces 90 derniers jours, avec leurs intervenants. ``` Outil : `projets_rechercher` · Portée : `mcp:read`, lecture seule · Coût : 1 appel, aucune unité de dossier · Limite : 100 appels par 24 heures en compte gratuit, 5 000 abonné ## 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-suivre-projets](https://prescriptio.fr/skills/prescriptio-suivre-projets) : Le skill du plugin qui route cet outil ## Les pages qui s'en servent Calculé depuis la documentation : chaque page qui cite `projets_rechercher`. - [Projets](https://prescriptio.fr/docs/projets) : Documentation, Les modules - [Radar réseaux sociaux](https://prescriptio.fr/docs/radar-reseaux-sociaux) : Documentation, Les modules - [Les permis de construire (Sitadel)](https://prescriptio.fr/docs/donnees/permis-de-construire) : Documentation, Les données - [Suivre les projets de construction d'un territoire et leurs acteurs](https://prescriptio.fr/docs/guides/suivre-les-projets-d-un-territoire) : Guides, Prescripteur de matériaux - [Prompts du prescripteur de matériaux](https://prescriptio.fr/docs/prompts/prescripteur-materiaux) : IA, Prompts par métier - [Prompts du bureau d'études](https://prescriptio.fr/docs/prompts/bureau-etudes) : IA, Prompts par métier - [Rechercher et suivre des projets](https://prescriptio.fr/skills/prescriptio-suivre-projets) : IA, Les skills du plugin - [Comment repérer un projet de construction avant l'appel d'offres ?](https://prescriptio.fr/docs/connaissances/reperer-projet-avant-appel-offres) : Base de connaissances, Repérer les affaires ## Voir aussi - [projets_fiche_lire](https://prescriptio.fr/docs/api/projets_fiche_lire) : Lire une fiche projet fusionnée par son UUID : résumé factuel, preuves datées et références sources,… - [projets_suivi_modifier](https://prescriptio.fr/docs/api/projets_suivi_modifier) : Agir sur un projet dans votre organisation avec la même transaction que l’interface - [projets_analyse](https://prescriptio.fr/docs/api/projets_analyse) : Analyse du secteur dans l’écran Projets - [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module