Chercher une entreprise | Documentation Prescriptio

Lecture seule, ouvert à tous les comptes, offre gratuite comprise. Chaque appel compte pour une unité de quota.

exemple synthétique

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

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"}}'

Réponsegénérée depuis le schéma

{
  "_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

cursortexte

Curseur next_cursor de la page précédente, repassé tel quel.

limitentier

(min 1, max 50, défaut 20)

localisationobjet

Zone géographique (mode liste), une granularité. National = omettre (jamais dept:"all").

Voir les propriétés

communetexte

Nom de commune, code postal ou code INSEE. Préférer insee pour le code fourni par la carte.

depttexte

Code département : 01-95, 2A/2B ou 971-976 (ex. "69").

inseetexte

Code INSEE exact; prioritaire sur commune et jamais interprété comme code postal.

regiontexte

Nom de région (ex. Auvergne-Rhone-Alpes) : couvre tous ses départements en un appel.

nafliste 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).

querytexte

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.

rgebooléen

Ne retenir que les entreprises actives dont la qualification RGE est valable aujourd'hui. Une localisation est requise sans query ni naf.

sirentexte

SIREN 9 chiffres : fiche complete de l'entreprise (identité, NAF, effectif, forme juridique, création, dirigeants, evolution du chiffre d'affaires). (format ^\d{9}$)

sirettexte

SIRET 14 chiffres : fiche d'un etablissement precis. (format ^\d{14}$)

specialite_rgemenuiseries · 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.

Texte du registre des outils, rendu lisible ; la vue agent le garde tel quel.

Le prompt qui le déclenche

Voir le prompt

Collez ce prompt dans votre agent IA, une fois Prescriptio connecté. Remplacez ce qui est entre crochets.

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

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 et Authentification et quotas.

Les skills qui s'en servent

prescriptio-identifier-entreprisesLe 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 rechercheDocumentation, Les modules Les attributions (DECP)Documentation, Les données Les entreprises et leurs établissementsDocumentation, Les données PrescripteursDocumentation, Les modules Les certifications RGEDocumentation, Les données Les propriétaires fonciers (personnes morales)Documentation, Les données AnnuaireDocumentation, Les modules Situer un sujet dans toutes les sources du bâti en une rechercheGuides, Tous les métiers Trouver les architectes et bureaux d'études présents dans les dossiers qui citent votre matériauGuides, Prescripteur de matériaux Tout savoir d'une entreprise avant de travailler avec elleGuides, Bureau d'études Savoir qui remporte les marchés de votre lot dans votre départementGuides, Entreprise de travaux Lister les cabinets et les entreprises d'un métier sur votre territoireGuides, Bureau d'études

Voir aussi

entreprises.searchLa même action, en opération REST annuaire_dirigeantsDirigeants et représentants légaux du bâti (RNE/INPI)annuaire_contactsContacts publics du bâti (décideurs, référents)annuaire_annonces_legalesAnnonces légales des entreprises (BODACC, ~358 000 publications)annuaire_organigrammeOrganigramme d’une entreprise du bâti, en ordre décisionnel Catalogue des outilsTous les outils, rangés par module

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

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"}}'

{ "_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 }

[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