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

# Chercher des entreprises

L'opération REST entreprises.search de Prescriptio sert à rechercher des entreprises par activité NAF, nom et localisation.

### Exemple d'appel, synthétique

**curl**

```bash
curl -sS https://prescriptio.fr/api/mcp/v1/entreprises.search \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"limit":20,"localisation":{"dept":"69"},"naf":["71.11Z"]}'
```

**Corps JSON**

```json
{
  "limit": 20,
  "localisation": {
    "dept": "69"
  },
  "naf": [
    "71.11Z"
  ]
}
```

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

```json
{
  "_meta": {},
  "next_cursor": "<texte>",
  "results": [
    {
      "fields": {
        "adresse": "<texte>",
        "capital_social_eur": 0,
        "categorie": "<texte>",
        "code_naf": "<texte>",
        "code_postal": "<texte>",
        "date_creation": "<texte>",
        "departement": "<texte>",
        "dirigeants": [
          {}
        ],
        "effectif": "<texte>",
        "est_rge": false,
        "etat": "<texte>",
        "evolution_ca": [
          {}
        ],
        "forme_juridique": "<texte>",
        "libelle_naf": "<texte>",
        "nom_commercial": "<texte>",
        "nombre_certifications_actives": 0,
        "raison_sociale": "<texte>",
        "raison_sociale_connue": false,
        "rge_date_fin": "<texte>",
        "rge_domaines": [
          "<texte>"
        ],
        "siren": "<texte>",
        "siret": "<texte>",
        "url": "<texte>",
        "ville": "<texte>"
      },
      "id": "<texte>",
      "resume": "<texte>",
      "titre": "<texte>"
    }
  ],
  "total_estimated": 0
}
```

## Paramètres du corps

| Nom | Type | Requis | Description |
|---|---|---|---|
| `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 (mode liste), UNE granularité. National = omettre (jamais dept:"all"). |
| `localisation.commune` | texte | — | Nom de commune, code postal ou code INSEE. Préférer insee pour le code fourni par la carte. |
| `localisation.dept` | texte | — | Code département : 01-95, 2A/2B ou 971-976 (ex. "69"). |
| `localisation.insee` | texte | — | Code INSEE exact; prioritaire sur commune et jamais interprété comme code postal. |
| `localisation.region` | texte | — | Nom de région (ex. Auvergne-Rhone-Alpes) — couvre tous ses départements en un appel. |
| `naf` | liste | — | Codes NAF (activité) : sous-classes « 4333Z » / « 43.33Z » ou divisions « 43 » (deployees en leurs sous-classes). Filtre la liste ; SANS query, liste les entreprises de l'activité sur la zone, RGE et certifiees d'abord — c'est la recette « les carreleurs du 69 » (les mots ne trouvent pas un métier, le NAF si). |
| `query` | texte | — | Recherche plein texte (nom, activité NAF, RGE) pour LISTER des entreprises. UNE requête = UN sujet. Combiner avec localisation pour cibler une zone. Optionnelle si naf est fourni. |
| `rge` | booléen | — | Ne retenir que les entreprises actives dont la qualification RGE est valable aujourd'hui. Une localisation est requise sans query ni naf. |
| `specialite_rge` | texte | — | Même famille de qualification que la carte RGE; implique rge=true. (valeurs : `menuiseries` · `pac` · `isolation` · `chauffage` · `solaire` · `bois` · `ventilation` · `etudes`) |

## Quand l'utiliser

Résultats paginés sans coordonnées.

## En bref

| | |
|---|---|
| Adresse | `POST /api/mcp/v1/entreprises.search` |
| 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 | [`annuaire_entreprises`](https://prescriptio.fr/docs/api/annuaire_entreprises) : même traitement |

## 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 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 `entreprises.search`.

- [Moteur de recherche](https://prescriptio.fr/docs/recherche) : Documentation, Les modules
- [Les entreprises et leurs établissements](https://prescriptio.fr/docs/donnees/entreprises) : Documentation, Les données
- [Annuaire](https://prescriptio.fr/docs/annuaire) : Documentation, Les modules
- [API REST](https://prescriptio.fr/docs/integrations/api-rest) : IA, Intégrations
- [Lire cette documentation avec un agent](https://prescriptio.fr/docs/ia/lire-la-doc) : IA, Le connecteur en détail

## Voir aussi

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