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

# Chercher dans toutes les sources

L'outil recherche de Prescriptio situe un sujet en un seul appel dans les sources de Prescriptio (marchés, dossiers de consultation, attributions, entreprises, permis, PV de mairie, annonces légales, ventes) et rend la dizaine de résultats les plus pertinents, à approfondir avec l'outil de chaque source.

### Squelette d'appel, généré depuis le schéma

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "query": "<query>"
    },
    "name": "recherche"
  }
}
```

**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":{"query":"<query>"},"name":"recherche"}}'
```

### 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 |
|---|---|---|---|
| `limit` | entier | — | Nombre de résultats (défaut 10, max 10 — triage toutes sources confondues). (min 1, max 10) |
| `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"). |
| `query` | texte | oui | Le sujet a rechercher — UN seul sujet par appel. (min. caractères 2) |

## Quand l'utiliser

ATTENTION : SANS filtre de statut (ouvert/ferme) NI de DCE — pour TROUVER ou FILTRER des appels d'offres (statut ouvert, DCE consultable, tri par date limite, publiés récemment, ferment bientôt), utiliser DIRECTEMENT marches_rechercher (filtres type:"ouvert", avec_dce:true, sort:"deadline", cloture_dans_jours). Chaque résultat indique sa source : approfondir avec l'outil dedie (fields.approfondir). Un sujet = tous ses mots exiges ("BIM geometre" donne ~0 résultat) ; plusieurs sujets se separent par des virgules ("BIM, geometre" = l'un OU l'autre, 12 au plus).

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

```text
Avec Prescriptio, situe le sujet « bardage bois » dans toutes les sources du bâti : combien de marchés, d'entreprises, de dossiers et de PV en parlent ?
```

Outil : `recherche` · Portée : `mcp:read`, lecture seule · Coût : 1 appel, aucune unité de dossier · Limite : 10 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-identifier-entreprises](https://prescriptio.fr/skills/prescriptio-identifier-entreprises) : Le skill du plugin qui route cet outil

## Les pages qui s'en servent

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

- [Les données de Prescriptio](https://prescriptio.fr/docs/donnees) : Documentation, Les données
- [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
- [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
- [Prompts prêts à coller](https://prescriptio.fr/docs/prompts) : IA, Prompts par métier
- [Identifier des entreprises et leurs interlocuteurs](https://prescriptio.fr/skills/prescriptio-identifier-entreprises) : IA, Les skills du plugin

## Voir aussi

- [aide](https://prescriptio.fr/docs/api/aide) : Aide a choisir le bon outil et rappelle les recettes canoniques
- [reporting](https://prescriptio.fr/docs/api/reporting) : Reporting 360° du tableau de bord
- [marque_rapport](https://prescriptio.fr/docs/api/marque_rapport) : Analyse du rapport de marque (Détection de marque)
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module