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

# Lire un dossier de consultation

L'opération REST dce.read de Prescriptio sert à rechercher dans un dossier ou lire une pièce ciblée.

### Exemple d'appel, synthétique

**curl**

```bash
curl -sS https://prescriptio.fr/api/mcp/v1/dce.read \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"marche_id":"fixture-dce-001","type":"rc"}'
```

**Corps JSON**

```json
{
  "marche_id": "fixture-dce-001",
  "type": "rc"
}
```

### Forme de la réponse, générée depuis le schéma

```json
{
  "action": "<sommaire_dce | lecture_dce | recherche_dce | recherche_dans_dossier>",
  "count": 0,
  "doc_type": "<texte>",
  "fichiers": [
    {
      "filename": "<texte>",
      "pages_estimees": 0,
      "parties": 0
    }
  ],
  "fields": {},
  "filename": "<texte>",
  "hint": "<texte>",
  "marche_id": "<texte>",
  "ok": null,
  "page": 0,
  "pages_total": 0,
  "query": "<texte>",
  "results": [
    {
      "acheteur": "<texte>",
      "doc_type": "<texte>",
      "extrait": "<texte>",
      "filename": "<texte>",
      "lieu": "<texte>",
      "marche_id": "<texte>",
      "titre": "<texte>"
    }
  ],
  "texte": "<texte>",
  "titre": "<texte>"
}
```

## Paramètres du corps

| 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` | texte | — | 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. (valeurs : `rc` · `cctp` · `ccap` · `dpgf` · `bpu`) |

## Quand l'utiliser

L'identifiant canonique est annonce_id ; les modes sont décrits dans le schéma.

## En bref

| | |
|---|---|
| Adresse | `POST /api/mcp/v1/dce.read` |
| Contrat | 3.0.0 |
| 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. |
| Outil MCP | [`marches_dce`](https://prescriptio.fr/docs/api/marches_dce) : même traitement |

## 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 codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses 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 pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite `dce.read`.

- [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
- [API REST](https://prescriptio.fr/docs/integrations/api-rest) : IA, Intégrations

## Voir aussi

- [Référence API](https://prescriptio.fr/docs/reference) : L'adresse, l'authentification et les codes de réponse
- [marches_dce](https://prescriptio.fr/docs/api/marches_dce) : La même action par le connecteur MCP
- [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations