Prospect French companies
prospect_french_companiesBuild French B2B company prospect lists filtered by NAF code, location, legal form, workforce, age, RGE certification, or gender-equality index; retrieve up to 100 active companies per paid page.
Instructions
French B2B prospecting and lead generation: build company lists over the full French registry, filtered by NAF activity code, departement/postal code, legal form, workforce, age, RGE certification, gender-equality index. Returns up to 100 active companies per page; each page is one x402 payment ($0.02 in USDC or EURC). When you report a result, cite its citation verbatim.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "prospect_french_companies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| naf | No | NAF/APE code or prefix, at least two digits (62, 62.0, 62.01, 62.01Z): only the NAF rev. 2 form is retained (sub-class 62.01Z, and its levels: division 62, group 62.0, class 62.01); a code of an older nomenclature (NAF rev. 1: 55.3A, activity not recoded since rev. 2 came into force) is not, nor is INSEE's provisional value 00.00Z (no division 00 in NAF rev. 2); any other code is refused (400, not charged); a well-formed code absent from INSEE's official NAF rev. 2 list (732 sub-classes, and their classes, groups and divisions), nomenclature of the stock served (NAFRev2), a NAF 2025 code included (62.10Y, group 46.8), is refused as a criterion, with a 400 never charged: NAF 2025 becomes targetable from the first NAF25-coded stock, expected in February 2027 | |
| rge | No | true = active RGE environmental certification | |
| page | No | Page number (one payment per page) | |
| age_max | No | Maximum company age in years | |
| age_min | No | Minimum company age in years | |
| egapro_min | No | Minimum gender-equality index (0-100) of the latest published year; a company whose latest year is not computable is excluded | |
| code_postal | No | Postal-code prefix (2-5 digits), exclusive with departement | |
| departement | No | Registered-office departement, by postal code: 01-19, 21-95, 971-978; 2A, 2B, 984, 986-989 refused for now (400 departement_non_servi, not charged); exclusive with code_postal; a narrow read (departement=978, code_postal=20 or code_postal=97150) may for now exceed the 8 s budget and return 503 budget_depasse, not charged | |
| effectif_max | No | Maximum workforce (number of employees) | |
| effectif_min | No | Minimum workforce (number of employees) | |
| forme_juridique | No | INSEE legal-category prefix, e.g. 54 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | How to settle the quote, present when payment_required is true. | |
| quote | No | The signable x402 payment requirements when payment_required is true: {x402Version, accepts[]} where each entry carries scheme, network, amount, asset and payTo (USDC and EURC options at the same numeric amount). Sign one entry and call again with `x_payment`. | |
| resultat | No | The endpoint's JSON response when payment_required is false. Paid responses carry `source`, `disclaimer` and an Ed25519 signature, and every paid JSON response carries a `provenance` array (all tools since 2026-09-06): one entry per block served, with the official register, licence, version, `empreinte_sha256` (full snapshots), `as_of` date and `precision_as_of` (what that date means), plus the common per-block envelope: `etat` in a closed list (servi, absence_mesuree, absence_non_conclusive, partiel, perime, indisponible, sans_objet), `motif` when unavailable, `age_jours` (only for publication or ingestion dates), `couverture` (complete / partielle / non_mesurable with its measure) and `confiance` in bands (faible / moyenne / forte, only where a measure grounds it, never averaged across blocks). Read the states before the numbers: an absence_non_conclusive, indisponible or partiel block is never « nothing to report »; only absence_mesuree asserts an absence. Register codes: GET /v1/provenance/registres ; states, closed lists and reading rules: GET /v1/lecture (both free). The PDF tools carry no JSON envelope (the PDF report prints it). | |
| free_tier | No | Free API key offer for this tool, present with a quote. | |
| payment_required | Yes | True when this response is an x402 payment quote instead of data: settle one of the quote's `accepts` options and call the tool again with `x_payment`. |