Chercher des entreprises | Documentation Prescriptio

POST /api/mcp/v1/entreprises.search, portée mcp:read; droits, conditions d’offre et quotas contrôlés par l’action. Même traitement que l'outil annuaire_entreprises.

exemple synthétique

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

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

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 du corps

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

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.

specialite_rgetexte

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.

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

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

Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite entreprises.search.

Moteur de rechercheDocumentation, Les modules Les entreprises et leurs établissementsDocumentation, Les données AnnuaireDocumentation, Les modules API RESTIA, Intégrations Lire cette documentation avec un agentIA, Le connecteur en détail

Voir aussi

Référence APIL'adresse, l'authentification et les codes de réponse annuaire_entreprisesLa même action par le connecteur MCP OpenAPILe schéma machine de toutes les opérations

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

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