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

# Chercher une entreprise

L'outil annuaire_entreprises de Prescriptio rend la fiche d'une entreprise du bâti par son SIREN ou son SIRET (identité, activité, effectif, dirigeants, évolution du chiffre d'affaires), ou liste les entreprises d'une activité dans une zone.

### Exemple d'appel, synthétique

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "limit": 20,
      "localisation": {
        "dept": "69"
      },
      "naf": [
        "71.11Z"
      ]
    },
    "name": "annuaire_entreprises"
  }
}
```

**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":{"limit":20,"localisation":{"dept":"69"},"naf":["71.11Z"]},"name":"annuaire_entreprises"}}'
```

### 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

| 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 de texte | — | 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. |
| `siren` | texte | — | SIREN 9 chiffres : fiche complete de l'entreprise (identité, NAF, effectif, forme juridique, création, dirigeants, evolution du chiffre d'affaires). (format `^\d{9}$`) |
| `siret` | texte | — | SIRET 14 chiffres : fiche d'un etablissement precis. (format `^\d{14}$`) |
| `specialite_rge` | `menuiseries` · `pac` · `isolation` · `chauffage` · `solaire` · `bois` · `ventilation` · `etudes` | — | Même famille de qualification que la carte RGE; implique rge=true. |

## Quand l'utiliser

Avec siren (9 chiffres) ou siret (14 chiffres) : la FICHE complete d'une entreprise — identité, activité (NAF), effectif, forme juridique, date de création, capital, dirigeants et evolution du chiffre d'affaires (bilans deposes). Pour une activité et une zone : naf:["71.11Z"] et localisation:{dept:"69"} liste les architectes du Rhône sans query. Avec query (+ localisation) : LISTER des entreprises par nom / activité dans une zone. Avec rge=true et localisation, lister les qualifications valables aujourd’hui ; specialite_rge reprend les familles de la carte. Les coordonnées (téléphone, e-mail, site) ne sont jamais dans la fiche : elles se revelent a l'unite cote application. Toujours citer le SIREN/SIRET renvoye.

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

```text
Avec Prescriptio, donne-moi la fiche complète de l'entreprise au SIREN 123456789, dont l'évolution de son chiffre d'affaires.
```

Outil : `annuaire_entreprises` · 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/entreprises.search` : [entreprises.search](https://prescriptio.fr/docs/api/entreprises.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-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 `annuaire_entreprises`.

- [Moteur de recherche](https://prescriptio.fr/docs/recherche) : Documentation, Les modules
- [Les attributions (DECP)](https://prescriptio.fr/docs/donnees/attributions) : Documentation, Les données
- [Les entreprises et leurs établissements](https://prescriptio.fr/docs/donnees/entreprises) : Documentation, Les données
- [Prescripteurs](https://prescriptio.fr/docs/detection-prescripteurs) : Documentation, Les modules
- [Les certifications RGE](https://prescriptio.fr/docs/donnees/certifications) : Documentation, Les données
- [Les propriétaires fonciers (personnes morales)](https://prescriptio.fr/docs/donnees/proprietaires-fonciers) : Documentation, Les données
- [Annuaire](https://prescriptio.fr/docs/annuaire) : 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
- [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
- [Tout savoir d'une entreprise avant de travailler avec elle](https://prescriptio.fr/docs/guides/tout-savoir-d-une-entreprise) : Guides, Bureau d'études
- [Savoir qui remporte les marchés de votre lot dans votre département](https://prescriptio.fr/docs/guides/qui-remporte-les-marches-de-votre-lot) : Guides, Entreprise de travaux
- [Lister les cabinets et les entreprises d'un métier sur votre territoire](https://prescriptio.fr/docs/guides/cabinets-et-entreprises-d-un-territoire) : Guides, Bureau d'études

## Voir aussi

- [entreprises.search](https://prescriptio.fr/docs/api/entreprises.search) : La même action, en opération REST
- [annuaire_dirigeants](https://prescriptio.fr/docs/api/annuaire_dirigeants) : Dirigeants et représentants légaux du bâti (RNE/INPI)
- [annuaire_contacts](https://prescriptio.fr/docs/api/annuaire_contacts) : Contacts publics du bâti (décideurs, référents)
- [annuaire_annonces_legales](https://prescriptio.fr/docs/api/annuaire_annonces_legales) : Annonces légales des entreprises (BODACC, ~358 000 publications)
- [annuaire_organigramme](https://prescriptio.fr/docs/api/annuaire_organigramme) : Organigramme d’une entreprise du bâti, en ordre décisionnel
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module