Skip to content
Eden Engine

French Company Search by Name or Keyword (Recherche d'entreprises)

rechercheentreprises/company-search

Searches the French company register (Recherche d'entreprises) by name, address words, SIREN or SIRET and returns, per company, its SIREN, full name, legal form, activity code, size band, head-office establishment, number of establishments, financial figures when published, and the directors listed in the register (individuals included, with name, role and year of birth when published). Results are ranked by relevance, 10 per page at most; use `page` for more. Set `etat_administratif` to A (active) or C (ceased) to filter. A search that matches nothing returns an empty `results` list.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.

Data source

Recherche d'entreprises (DINUM, data.gouv.fr)

Data from Recherche d'entreprises, DINUM / data.gouv.fr, published as open access (Accès Ouvert). Served by Eden Engine; not an official DINUM or data.gouv.fr product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "rechercheentreprises/company-search" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "rechercheentreprises/company-search" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "rechercheentreprises/company-search", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "rechercheentreprises/company-search", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 25, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 200,
      "minLength": 3,
      "description": "Search text: company name, words of the address, a 9-digit SIREN or a 14-digit SIRET. At least 3 characters."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 1000,
      "minimum": 1,
      "description": "Page number, from 1 (default 1)."
    },
    "per_page": {
      "type": "integer",
      "default": 5,
      "maximum": 10,
      "minimum": 1,
      "description": "Companies per page, 1 to 10 (default 5)."
    },
    "etat_administratif": {
      "enum": [
        "A",
        "C"
      ],
      "type": "string",
      "description": "A to keep only active companies, C for ceased ones; leave out for both."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "results",
    "total_results"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "description": "Page returned."
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "siren"
        ],
        "properties": {
          "siege": {
            "type": "object",
            "properties": {
              "siret": {
                "type": "string",
                "description": "SIRET of the head-office establishment (14 digits)."
              },
              "adresse": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "One-line address of the establishment."
              },
              "commune": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "INSEE commune code."
              },
              "latitude": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Latitude as a string; null when the address is not geocoded."
              },
              "est_siege": {
                "type": "boolean",
                "description": "True for the head office."
              },
              "longitude": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Longitude as a string; null when the address is not geocoded."
              },
              "code_postal": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Postal code."
              },
              "departement": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Departement code."
              },
              "date_creation": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Creation date of the establishment, YYYY-MM-DD."
              },
              "libelle_commune": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Commune name."
              },
              "etat_administratif": {
                "type": "string",
                "description": "A for active, F for closed."
              }
            },
            "description": "The head-office establishment (siege); an empty object on placeholder records. Further establishment fields (trade names, codes, effectif band) are passed through.",
            "additionalProperties": true
          },
          "sigle": {
            "type": [
              "string",
              "null"
            ],
            "description": "Acronym."
          },
          "siren": {
            "type": "string",
            "description": "SIREN, the 9-digit company identifier."
          },
          "finances": {
            "type": [
              "object",
              "null"
            ],
            "description": "Latest published financial figures by year (revenue, net result); null when none.",
            "additionalProperties": true
          },
          "dirigeants": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "type_dirigeant"
              ],
              "properties": {
                "nom": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Surname of an individual director; absent or null for a corporate director (see denomination)."
                },
                "siren": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "SIREN of a corporate director; null for individuals."
                },
                "prenoms": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Given names; null for a corporate director."
                },
                "qualite": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Role, for example Gérant or Président."
                },
                "nationalite": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Nationality; null when not published."
                },
                "denomination": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Name of a corporate director; null for individuals."
                },
                "type_dirigeant": {
                  "type": "string",
                  "description": "`personne physique` (individual) or `personne morale` (company)."
                },
                "date_de_naissance": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Month of birth (YYYY-MM) of an individual director; null when not published."
                },
                "annee_de_naissance": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Year of birth of an individual director; null when not published."
                }
              },
              "description": "One director or officer listed in the register.",
              "additionalProperties": true
            },
            "description": "Directors and officers listed in the register, individuals included."
          },
          "complements": {
            "type": "object",
            "description": "Flags such as est_association, est_ess, est_bio, est_rge and identifiers.",
            "additionalProperties": true
          },
          "nom_complet": {
            "type": [
              "string",
              "null"
            ],
            "description": "Full name: legal name with the acronym when there is one; null on placeholder records."
          },
          "date_creation": {
            "type": [
              "string",
              "null"
            ],
            "description": "Creation date, YYYY-MM-DD."
          },
          "date_fermeture": {
            "type": [
              "string",
              "null"
            ],
            "description": "Closure date, YYYY-MM-DD; null while active."
          },
          "nature_juridique": {
            "type": [
              "string",
              "null"
            ],
            "description": "Legal form code (catégorie juridique INSEE), for example 5710."
          },
          "statut_diffusion": {
            "type": [
              "string",
              "null"
            ],
            "description": "O when the register is publicly diffusible."
          },
          "etat_administratif": {
            "type": [
              "string",
              "null"
            ],
            "description": "A for active, C for ceased; null on placeholder records."
          },
          "nom_raison_sociale": {
            "type": [
              "string",
              "null"
            ],
            "description": "Registered legal name."
          },
          "activite_principale": {
            "type": [
              "string",
              "null"
            ],
            "description": "Main activity (NAF rev. 2) code, for example 68.20B."
          },
          "categorie_entreprise": {
            "type": [
              "string",
              "null"
            ],
            "description": "Size category: PME, ETI, GE; null when not set."
          },
          "nombre_etablissements": {
            "type": "integer",
            "description": "Number of establishments (open and closed)."
          },
          "matching_etablissements": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            },
            "description": "Establishments that matched the search text."
          },
          "tranche_effectif_salarie": {
            "type": [
              "string",
              "null"
            ],
            "description": "Employee-count band code (NN means not employer or unknown)."
          },
          "activite_principale_naf25": {
            "type": [
              "string",
              "null"
            ],
            "description": "Main activity (NAF 2025) code."
          },
          "section_activite_principale": {
            "type": [
              "string",
              "null"
            ],
            "description": "Activity section letter."
          },
          "nombre_etablissements_ouverts": {
            "type": "integer",
            "description": "Number of open establishments."
          }
        },
        "description": "One company (unité légale).",
        "additionalProperties": true
      },
      "description": "Matching companies; empty when none match."
    },
    "per_page": {
      "type": "integer",
      "description": "Page size."
    },
    "total_pages": {
      "type": "integer",
      "description": "Number of pages."
    },
    "total_results": {
      "type": "integer",
      "description": "Total matches across all pages."
    }
  },
  "description": "Search envelope.",
  "additionalProperties": true
}