# Pappers / SIRENE Scraper — French Companies API (`yannabadie/french-company-intelligence-mcp`) Actor

Official French SIRENE/RNE, BODACC insolvency & BOAMP tenders API & MCP tool. Free count mode, GPS radius search, RGE/Qualiopi/Bio/ESS filters, executives, financials & VAT. Zero proxy.

- **URL**: https://apify.com/yannabadie/french-company-intelligence-mcp.md
- **Developed by:** [Yann Abadie](https://apify.com/yannabadie) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.00 / 1,000 company enriched (sirene + rne)s

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

![Pappers / SIRENE Scraper — French Companies, BODACC & BOAMP](https://raw.githubusercontent.com/yannabadie/yannabadie/main/assets/banner_french_company.png)

## Pappers / SIRENE Scraper — French Companies, BODACC & BOAMP (MCP)

**Deterministic, zero-proxy French company intelligence API & MCP tool** powered by official French government Open Data registries:

- **SIRENE / RNE** (`recherche-entreprises.api.gouv.fr` — DINUM / INSEE / INPI) — 15M+ legal entities, executives, NAF/APE codes, headcount ranges, turnover, net income, GPS coordinates, and official certifications (**RGE, Qualiopi, Bio, ESS, Association, Organisme de Formation, Société à Mission**).
- **BODACC** (`bodacc-datadila.opendatasoft.com` — DILA) — Optional insolvency, collective procedures (*liquidation/redressement judiciaire*), company creations, sales, and radiations for deterministic KYC risk scoring.
- **BOAMP** (`boamp-datadila.opendatasoft.com` — DILA) — Optional French public procurement tenders mentioning each company or searched directly by keyword/department.

> **Bookmark this Actor** to keep instant access to free count previews, `$6 / 1,000` company exports, and live BODACC KYC screening.

***

### Why Teams Choose This Scraper

| Feature | This Actor (`yannabadie`) | Typical SIRENE / Pappers Scrapers |
|---|---|---|
| **Base company export price** | **$6 / 1,000 companies** (`$0.006/record`) | `$8–$15 / 1,000` companies |
| **FREE TAM / Count Preview (`mode: "count"`)** | **Yes** (`0` company charges) | Often unavailable or billed |
| **GPS Radius Search (`/near_point`)** | **Yes** (`latitude`, `longitude`, `radiusKm`) | Rarely supported |
| **Official Certification Filters** | **RGE, Qualiopi, Bio, ESS, Asso, OF, Mission** | Partial or manual post-filtering |
| **Auto-Computed French VAT (`FRxx...`)** | **Yes** + `pappers_url` + `google_maps_url` | Partial |
| **Opt-in BODACC Insolvency KYC Risk Score** | **Yes** (`active_clean` / `watch` / `high_risk` / `closed`) | Not included |
| **Opt-in BOAMP Public Tenders History** | **Yes** | Not included |
| **Proxies / CAPTCHA / Browser overhead** | **Zero** — direct official REST APIs (`< 2s` runs) | Browser / proxy overhead |
| **MCP & n8n Ready** | **Yes** — [Free n8n KYC template](https://github.com/yannabadie/yannabadie/blob/main/templates/n8n_french_company_kyc_enrichment.json) | Manual setup |

***

### 5 Operation Modes

1. **`count` (FREE Preview)** — Returns exact `total_results` and estimated cost for any filter combination (`postalCode`, `nafCode`, `estQualiopi`, GPS radius, etc.) with **zero `company-enriched` charge**.
2. **`search_companies` (Default)** — Search by keyword, department, postal code, region, NAF/APE code, headcount range, company size (`PME`/`ETI`/`GE`), executive last name, official labels (`estRge`, `estQualiopi`, `estBio`, `estEss`, `estAssociation`, `estOrganismeFormation`, `estSocieteMission`), or **GPS radius** (`latitude`, `longitude`, `radiusKm`).
3. **`enrich_sirens`** — Bulk-enrich a list of 9-digit SIREN or 14-digit SIRET numbers (automatic Luhn checksum validation & whitespace stripping) with optional BODACC legal risk and BOAMP tenders.
4. **`watch_bodacc`** — Monitor recent BODACC legal notices (`collective`, `creation`, `vente`, `radiation`, `dpc`, etc.) by department and date.
5. **`search_boamp`** — Query French BOAMP public procurement notices by keyword, department, and date.

***

### Pricing (Transparent Pay-Per-Event)

You only pay for what you turn on — zero proxy costs, zero subscription lock-in:

| Event | Price | Charged When |
|---|---|---|
| `apify-actor-start` | `$0.005` | Once per run start |
| `company-enriched` | `$0.006` (`$6 / 1k`) | Per returned company in `search_companies` / `enrich_sirens` (**`$0` in `count` mode**) |
| `bodacc-enrichment` | `$0.003` (`$3 / 1k`) | Only when `includeBodacc: true` (opt-in) or in `watch_bodacc` mode |
| `boamp-record` | `$0.003` (`$3 / 1k`) | Only when `includeBoamp: true` (opt-in) or in `search_boamp` mode |

***

### Example Inputs

#### 1. FREE Market Sizing Preview (`count` mode — `$0` per-company charge)

```json
{
  "mode": "count",
  "postalCode": "75008",
  "estQualiopi": true
}
```

#### 2. Local B2B Lead Generation by GPS Radius (Paris, 2 km)

```json
{
  "mode": "search_companies",
  "latitude": 48.8566,
  "longitude": 2.3522,
  "radiusKm": 2,
  "nafCode": "62.01Z",
  "maxResults": 50
}
```

#### 3. Bulk Supplier KYC Screening (SIREN + BODACC Insolvency Risk)

```json
{
  "mode": "enrich_sirens",
  "sirens": ["794 598 813", "552 032 534"],
  "includeBodacc": true,
  "includeBoamp": false
}
```

***

### Sample JSON Output (`french_company`)

```json
{
  "record_type": "french_company",
  "siren": "794598813",
  "siret_hq": "79459881300049",
  "vat_number": "FR14794598813",
  "company_name": "DOCTOLIB",
  "status": "active",
  "health_signal": "active_clean",
  "risk_flags": [],
  "naf_code": "62.01Z",
  "employee_range": "1 000 à 1 999 salariés",
  "postal_code": "92300",
  "city": "LEVALLOIS-PERRET",
  "latest_fiscal_year": "2024",
  "latest_revenue_eur": 311448000,
  "official_labels": ["Qualiopi"],
  "bodacc_total_notices": 12,
  "annuaire_url": "https://annuaire-entreprises.data.gouv.fr/entreprise/794598813",
  "pappers_url": "https://www.pappers.fr/entreprise/794598813",
  "google_maps_url": "https://www.google.com/maps/search/?api=1&query=48.8932,2.2879"
}
```

***

### Python, CLI, MCP & n8n Integration

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("yannabadie/french-company-intelligence-mcp").call(run_input={
    "mode": "search_companies",
    "department": "75",
    "estRge": True,
    "companyCategory": "PME",
    "maxResults": 100,
})
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
```

- **Free ready-to-import n8n template**: [French Company KYC & Insolvency Screening Workflow (JSON)](https://github.com/yannabadie/yannabadie/blob/main/templates/n8n_french_company_kyc_enrichment.json)
- **MCP Server**: Connect directly via Apify's hosted MCP endpoint (`https://mcp.apify.com`) from Claude, Cursor, or Antigravity.

***

### FAQ

- **How accurate is the data?** All records come straight from France's official DINUM/INSEE/INPI (`recherche-entreprises.api.gouv.fr`) and DILA (`BODACC` / `BOAMP`) open-data APIs — the exact same upstream registries used by Pappers.
- **Why is `includeBodacc` disabled by default?** So pure lead-gen runs cost only `$6 / 1,000` companies and finish in under 2 seconds. Toggle `includeBodacc: true` whenever you want insolvency/closure KYC screening (`+$3 / 1,000`).
- **Does `count` mode charge per company?** No — `count` runs 1 lightweight query (`per_page=1`) and emits a single summary row with `0` `company-enriched` charges.
- **Are invalid SIREN/SIRET numbers handled safely?** Yes — `enrich_sirens` strips spaces/dashes, normalizes 14-digit SIRETs to 9-digit SIRENs, and validates Luhn checksums before querying.

***

### Explore Our Official Open-Data Actor Suite

- **[TED Europa & BOAMP — EU Public Tenders & Contacts](https://apify.com/yannabadie/eu-public-tenders-ted-boamp)** (`$3–$4/1k`, 27 EU countries + France, buyer emails, phones & award winners)
- **[ClinicalTrials.gov API v2 — Trials & Contacts](https://apify.com/yannabadie/clinical-trials-api-mcp)** (`$5/1k`, 500k+ NIH clinical studies, free count mode, PI/central emails & sponsors)
- **[Free n8n Templates, MCP Config & Python CLI (GitHub)](https://github.com/yannabadie/official-opendata-mcp-n8n-templates)**

# Actor input Schema

## `mode` (type: `string`):

Choose whether to preview match count for FREE ('count'), search companies (SIRENE/RNE or GPS radius), bulk-enrich SIREN/SIRET lists, watch BODACC legal events, or search BOAMP tenders.

## `query` (type: `string`):

Free-text search query for search_companies, count, watch_bodacc, or search_boamp.

## `sirens` (type: `array`):

List of 9-digit French SIREN or 14-digit SIRET identifiers (spaces and dashes are automatically stripped).

## `department` (type: `string`):

2- or 3-digit department code (e.g. '75', '69', '33', '974'). Supports comma-separated values.

## `postalCode` (type: `string`):

5-digit French postal code filter (e.g. '75008', '69002'). Supports comma-separated values.

## `region` (type: `string`):

2-digit French region code (e.g. '11' Île-de-France, '84' Auvergne-Rhône-Alpes, '93' PACA).

## `nafCode` (type: `string`):

INSEE NAF code filter for company search (e.g. '62.01Z', '70.22Z'). Supports comma-separated values.

## `employeeRange` (type: `string`):

INSEE tranche_effectif_salarie code(s), comma-separated (e.g. '11,12,21' for 10–99 employees; '01'=1-2, '02'=3-5, '03'=6-9, '11'=10-19, '12'=20-49, '21'=50-99, '22'=100-199, '31'=200-249, '32'=250-499).

## `companyCategory` (type: `string`):

Filter by official INSEE size category: PME, ETI, or GE.

## `executiveLastName` (type: `string`):

Filter companies by an executive or director's last name (nom_personne).

## `latitude` (type: `number`):

WGS84 latitude (e.g. 48.8566 for Paris). Provide both latitude and longitude to search companies within radiusKm via /near_point.

## `longitude` (type: `number`):

WGS84 longitude (e.g. 2.3522 for Paris). Must be combined with latitude.

## `radiusKm` (type: `number`):

Search radius in kilometers around (latitude, longitude) — between 0.1 and 50 km.

## `onlyActive` (type: `boolean`):

Exclude ceased/closed legal entities (etat_administratif = A).

## `estRge` (type: `boolean`):

Keep only companies certified RGE (Reconnu Garant de l'Environnement).

## `estQualiopi` (type: `boolean`):

Keep only Qualiopi-certified training & skills providers.

## `estBio` (type: `boolean`):

Keep only Agence Bio certified companies.

## `estEss` (type: `boolean`):

Keep only Économie Sociale et Solidaire entities.

## `estAssociation` (type: `boolean`):

Keep only French associations.

## `estOrganismeFormation` (type: `boolean`):

Keep only officially registered training organizations (Organisme de Formation).

## `estSocieteMission` (type: `boolean`):

Keep only mission-driven companies (Société à Mission).

## `minRevenueEur` (type: `integer`):

Filter enriched companies whose latest published turnover (CA) is at least this amount in EUR.

## `bodaccFamily` (type: `string`):

Filter BODACC notices by official family code.

## `sinceDate` (type: `string`):

Filter BODACC or BOAMP records published on or after this ISO date.

## `includeBodacc` (type: `boolean`):

Optional KYC add-on: fetch official DILA BODACC notices per company to compute deterministic insolvency/closure risk flags. Disabled by default so base company search costs $6 / 1,000 companies.

## `includeBoamp` (type: `boolean`):

Optional add-on: fetch official DILA BOAMP public procurement notices mentioning each company.

## `maxResults` (type: `integer`):

Hard cap on output records to control spend and execution time.

## Actor input object example

```json
{
  "mode": "search_companies",
  "query": "logiciel ia",
  "companyCategory": "",
  "radiusKm": 5,
  "onlyActive": true,
  "estRge": false,
  "estQualiopi": false,
  "estBio": false,
  "estEss": false,
  "estAssociation": false,
  "estOrganismeFormation": false,
  "estSocieteMission": false,
  "bodaccFamily": "",
  "includeBodacc": false,
  "includeBoamp": false,
  "maxResults": 25
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "logiciel ia"
};

// Run the Actor and wait for it to finish
const run = await client.actor("yannabadie/french-company-intelligence-mcp").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "query": "logiciel ia" }

# Run the Actor and wait for it to finish
run = client.actor("yannabadie/french-company-intelligence-mcp").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "logiciel ia"
}' |
apify call yannabadie/french-company-intelligence-mcp --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,yannabadie/french-company-intelligence-mcp"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Jimo7LILLdr2ngNFu/builds/YBrXc5xdxm8XNUlXb/openapi.json
