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

# Chercher des marchés publics

L'outil marches_rechercher de Prescriptio cherche les avis de marchés publics du bâti par mots, dates et territoire : les consultations ouvertes, celles dont le dossier se lit dans Prescriptio, celles qui ferment bientôt.

### Exemple d'appel, synthétique

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "avec_dce": true,
      "limit": 20,
      "localisation": {
        "dept": "69"
      },
      "query": "isolation",
      "sort": "deadline",
      "type": "ouvert"
    },
    "name": "marches_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":{"avec_dce":true,"limit":20,"localisation":{"dept":"69"},"query":"isolation","sort":"deadline","type":"ouvert"},"name":"marches_rechercher"}}'
```

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

```json
{
  "_meta": {},
  "next_cursor": "<texte>",
  "results": [
    {
      "fields": {
        "acheteur": "<texte>",
        "codes_cpv": [
          "<texte>"
        ],
        "date_attribution": "<texte>",
        "date_limite": "<texte>",
        "date_publication": "<texte>",
        "dce_consultable": false,
        "dept": "<texte>",
        "duree_mois": 0,
        "id_boamp": "<texte>",
        "jours_avant_cloture": 0,
        "montant_attribution": 0,
        "montant_estime_max": 0,
        "nature": "<texte>",
        "statut": "<texte>",
        "titulaire": "<texte>",
        "type_marche": "<texte>",
        "url": "<texte>",
        "url_avis": "<texte>",
        "ville": "<texte>"
      },
      "id": "<texte>",
      "resume": "<texte>",
      "titre": "<texte>"
    }
  ],
  "total_estimated": 0
}
```

## Paramètres

| Nom | Type | Requis | Description |
|---|---|---|---|
| `avec_dce` | booléen | — | true = uniquement les marchés dont le DOSSIER (DCE) est consultable DANS Prescriptio via marches_dce — pas le lien externe plateforme acheteur. Chaque résultat porte fields.dce_consultable. |
| `cloture_dans_jours` | entier | — | Date limite dans les N prochains jours (7 = ferment cette semaine). Combiner avec sort:"deadline". (min 0, max 3650) |
| `cursor` | texte | — | Curseur next_cursor de la page précédente, repassé tel quel. |
| `limit` | entier | — | (min 1, max 50, défaut `20`) |
| `localisation` | objet | — | Zone géographique, UNE granularité. National = omettre (jamais dept:"all"). |
| `localisation.commune` | texte | — | Nom de la commune de l'ACHETEUR. |
| `localisation.dept` | texte | — | Code département : 01-95, 2A/2B ou 971-978 (ex : "69"). |
| `localisation.region` | texte | — | Nom de région (ex : Auvergne-Rhone-Alpes, PACA) — couvre tous ses départements en un appel. |
| `publie_depuis_jours` | entier | — | Publiés dans les N derniers jours (1 = veille du jour). Combiner avec sort:"recent". (min 0, max 3650) |
| `query` | texte | — | Recherche plein texte (titre, objet, acheteur, CPV). UNE requête = UN sujet : le plein texte exige TOUS les mots. Optionnelle si un filtre date/zone/type est fourni. |
| `sort` | `deadline` · `recent` · `pertinence` | — | deadline = ferme le plus tot d'abord ; recent = publié le plus récemment d'abord ; pertinence (défaut avec query). |
| `type` | `ouvert` · `ferme` | — | ouvert = encore en consultation (une offre peut etre déposée) ; ferme = cloture ou attribue. Omis = les deux. |

## Quand l'utiliser

Trouver des AO ouverts dont le dossier est consultable (type:"ouvert", avec_dce:true, sort:"deadline" -> prioriser fields.dce_consultable:true puis lire les pièces via marches_dce), faire la veille du jour (publie_depuis_jours:1, sort:"recent") ou repérer ce qui ferme bientôt (cloture_dans_jours:7). query optionnelle si un filtre date/zone/type est fourni. UNE requête = UN sujet. Le montant estimé est rarement publié sur un AO ouvert : pour les montants réels, marches_attributions.

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

```text
Avec Prescriptio, trouve les appels d'offres ouverts du bâti dans le Rhône qui parlent d'isolation et dont le dossier est consultable, en commençant par ceux qui ferment le plus tôt.
```

Outil : `marches_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 | connecteurs ChatGPT/Claude (`connectors-1.0.0`) et MCP historique |
| En REST | `POST /api/mcp/v1/marches.search` : [marches.search](https://prescriptio.fr/docs/api/marches.search) |

## 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-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_rechercher`.

- [Démarrage rapide](https://prescriptio.fr/docs/demarrage-rapide) : Documentation, Pour commencer
- [Les marchés publics](https://prescriptio.fr/docs/donnees/marches-publics) : Documentation, Les données
- [Moteur de recherche](https://prescriptio.fr/docs/recherche) : Documentation, Les modules
- [Appels d'offres](https://prescriptio.fr/docs/appels-offres) : 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
- [Repérer un projet de construction avant l'appel d'offres](https://prescriptio.fr/docs/guides/reperer-un-projet-avant-l-appel-d-offres) : Guides, Bureau d'études
- [Faire la veille du jour des marchés publics du bâti](https://prescriptio.fr/docs/guides/veille-du-jour) : Guides, Entreprise de travaux
- [Voir les marchés publics qui ferment dans la semaine](https://prescriptio.fr/docs/guides/marches-qui-ferment-bientot) : Guides, Entreprise de travaux
- [Démarrer avec votre agent IA](https://prescriptio.fr/docs/assistants) : IA, Pour commencer

## Voir aussi

- [marches.search](https://prescriptio.fr/docs/api/marches.search) : La même action, en opération REST
- [marches_attributions](https://prescriptio.fr/docs/api/marches_attributions) : Qui a gagne quoi : attributions de marchés publics (DECP, ~308 000 contrats)
- [marches_dce](https://prescriptio.fr/docs/api/marches_dce) : Pièces d'un dossier de consultation (DCE)
- [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