[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Lire un dossier de consultation L'outil marches_dce de Prescriptio lit les pièces d'un dossier de consultation (RC, CCTP, CCAP, DPGF, BPU) : il cherche un terme dans un dossier ou dans tous les dossiers, et rend le texte de la pièce, tranche par tranche ; la page du PDF n'est déduite que pour une analyse enregistrée. ### Exemple d'appel, synthétique **MCP (JSON-RPC)** ```json { "id": 1, "jsonrpc": "2.0", "method": "tools/call", "params": { "arguments": { "marche_id": "fixture-dce-001", "type": "rc" }, "name": "marches_dce" } } ``` **HTTP (curl)** ```bash curl -sS https://prescriptio.fr/api/mcp \ -H 'Authorization: Bearer ' \ -H 'Content-Type: application/json' \ -d '{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"marche_id":"fixture-dce-001","type":"rc"},"name":"marches_dce"}}' ``` ### Forme de la réponse, générée depuis le schéma ```json { "action": "sommaire_dce", "count": 0, "doc_type": "", "fichiers": [ { "filename": "", "pages_estimees": 0, "parties": 0 } ], "fields": {}, "filename": "", "hint": "", "marche_id": "", "ok": true, "page": 0, "pages_total": 0, "query": "", "results": [ { "acheteur": "", "doc_type": "", "extrait": "", "filename": "", "lieu": "", "marche_id": "", "titre": "" } ], "texte": "", "titre": "" } ``` ## Paramètres | Nom | Type | Requis | Description | |---|---|---|---| | `filename` | texte | — | Nom de la pièce a lire dans un dossier MULTI-LOTS. Un nom approximatif suffit (ex "CCTP lot 12", "chape") : il est resolu contre les pièces réelles. Omis sur un dossier multi-lots, l'outil renvoie la TABLE DES MATIERES au lieu de coller tous les fichiers bout a bout. | | `marche_id` | texte | — | Identifiant du dossier : marche_id (UUID) OU annonce_id betterplace (ex "2833189") — les deux sont acceptes. Requis en mode lecture. | | `page` | entier | — | Page de lecture (~8000 caracteres) DANS la pièce choisie. pages_total indique le total ; demander page:2, 3... pour la suite. Ne PAS feuilleter un dossier entier page par page : utiliser filename, ou query pour localiser. (min 1, défaut `1`) | | `query` | texte | — | Avec marche_id : cherche DANS ce dossier et renvoie les pièces qui parlent du terme (le moyen rapide de trouver le bon lot). Sans marche_id : recherche semantique globale dans tous les DCE. | | `type` | `rc` · `cctp` · `ccap` · `dpgf` · `bpu` | — | Pièce a lire : rc (reglement de consultation), cctp (clauses techniques), ccap (clauses administratives), dpgf/bpu (prix). Requis en lecture ; en recherche, restreint a ce type. | ## Quand l'utiliser marche_id accepte un UUID de marché OU l'annonce_id betterplace. TROIS modes. SOMMAIRE : { marche_id, type } sur un dossier multi-lots renvoie la table des matieres (une ligne par pièce, avec pages_estimees). LECTURE : { marche_id, type, filename } renvoie le TEXTE de CETTE pièce, pagine (~8000 caracteres ; page / pages_total ; redemander page:2 pour la suite). filename tolere un nom approximatif ("CCTP lot 12", "chape"). LOCALISER : { marche_id, query } dit dans QUELLES pièces le terme apparait — le moyen rapide de trouver le bon lot sans feuilleter. Recherche globale : { query } seul, sur tous les DCE. NE JAMAIS parcourir un dossier page par page : passer par query puis filename. "DCE consultable" = lisible ICI, pas un lien externe : consulter = restituer le texte, jamais un lien invente. Téléchargement : marches_dce_lien_obtenir. **Prompt prêt à coller : Le prompt qui le déclenche** ```text Lis le règlement de consultation de ce marché, puis le cahier technique, et cite la page de chaque exigence. ``` Outil : `marches_dce` · Portée : `mcp:read`, lecture seule · Coût : 1 appel, et 1 unité de dossier par dossier lu dans la journée · Limite : 5 dossiers lus par jour en compte gratuit, 500 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 | connecteurs ChatGPT/Claude (`connectors-1.0.0`) et MCP historique | | En REST | `POST /api/mcp/v1/dce.read` : [dce.read](https://prescriptio.fr/docs/api/dce.read) | ## 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 consomme **en plus une unité de dossier** : un dossier vaut une unité pour la journée, quel que soit le nombre de pièces lues ou téléchargées dedans. Le compteur de dossiers repart à minuit, heure de Paris ; les deux compteurs d'appels, eux, glissent sur leur fenêtre. 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-trouver-marches](https://prescriptio.fr/skills/prescriptio-trouver-marches) : Le skill du plugin qui route cet outil ## Les pages qui s'en servent Calculé depuis la documentation : chaque page qui cite `marches_dce`. - [Démarrage rapide](https://prescriptio.fr/docs/demarrage-rapide) : Documentation, Pour commencer - [Moteur de recherche](https://prescriptio.fr/docs/recherche) : Documentation, Les modules - [Les dossiers de consultation (DCE)](https://prescriptio.fr/docs/donnees/dce) : Documentation, Les données - [Appels d'offres](https://prescriptio.fr/docs/appels-offres) : Documentation, Les modules - [Prescripteurs](https://prescriptio.fr/docs/detection-prescripteurs) : Documentation, Les modules - [Trouver les appels d'offres du bâtiment ouverts dont le dossier est consultable](https://prescriptio.fr/docs/guides/appels-offres-ouverts-avec-dossier) : Guides, Entreprise de travaux - [Trouver les consultations de maîtrise d'œuvre et d'études](https://prescriptio.fr/docs/guides/marches-de-maitrise-d-oeuvre) : Guides, Bureau d'études - [Situer un sujet dans toutes les sources du bâti en une recherche](https://prescriptio.fr/docs/guides/situer-un-sujet-dans-toutes-les-sources) : Guides, Tous les métiers - [Trouver votre matériau dans les pièces des dossiers de consultation](https://prescriptio.fr/docs/guides/trouver-son-materiau-dans-les-dossiers) : Guides, Prescripteur de matériaux - [Trouver les architectes et bureaux d'études présents dans les dossiers qui citent votre matériau](https://prescriptio.fr/docs/guides/cabinets-de-votre-materiau) : Guides, Prescripteur de matériaux - [Lire un DCE avec votre agent IA](https://prescriptio.fr/docs/guides/lire-un-dce-avec-votre-agent) : Guides, Entreprise de travaux - [Préparer votre réponse à un appel d'offres](https://prescriptio.fr/docs/guides/preparer-votre-reponse) : Guides, Entreprise de travaux ## Voir aussi - [dce.read](https://prescriptio.fr/docs/api/dce.read) : La même action, en opération REST - [marches_rechercher](https://prescriptio.fr/docs/api/marches_rechercher) : Avis d'appels d'offres publics du bâti (BOAMP + DECP, ~744 000 avis) - [marches_attributions](https://prescriptio.fr/docs/api/marches_attributions) : Qui a gagne quoi : attributions de marchés publics (DECP, ~308 000 contrats) - [marches_dce_lien_obtenir](https://prescriptio.fr/docs/api/marches_dce_lien_obtenir) : URL de téléchargement signée (valable 1 h) d'une pièce de DCE, ou de l'archive complete du dossier - [marches_dossiers](https://prescriptio.fr/docs/api/marches_dossiers) : Pipeline des dossiers d'appels d'offres suivis (kanban du portefeuille) - [marches_dossier_suivre](https://prescriptio.fr/docs/api/marches_dossier_suivre) : Ajoute un marché public ou un DCE au pipeline AO (crée un dossier au statut 'A qualifier') - [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module