French companies · search_companies_pappers
Search French companies
SIRENE and Pappers registries: NAF code, region, headcount, executives, website.
- Price
- included
- Requirements
- No connector
- runs on platform keys
- Human approval
- No
- read or internal write
- Reliability
- Verified
- stable · 0.3 s
Input
| Field | Type | Description |
|---|---|---|
| q | string | Free-text search (company name or SIRET/SIREN) |
| codeNaf | string | NAF/APE activity code, with or without the dot, e.g. "62.01Z" (software), "47.91A" (e-commerce), "70.22Z" (management consulting) |
| departement | string | French department number, e.g. "75" (Paris), "69" (Rhône), "13" (Bouches-du-Rhône). Matches companies with ANY site in the department: each result says whether its head office is there (headOfficeInArea) or only a local site (localSite). |
| trancheEffectif | string | Employee size code: "02"=3-5, "03"=6-9, "11"=10-19, "12"=20-49, "21"=50-99, "22"=100-199, "31"=200-249, "32"=250-499, "41"=500-999 |
| codePostal | string | Postal code filter, e.g. "75008" |
| page | number | Page number — omit to auto-resume from last saved position (recommended for multi-session prospecting). A name/SIREN-only query (no codeNaf/departement/codePostal/trancheEffectif) is treated as a LOOKUP of one specific company: no cross-session deduplication, no cursor — always returns the matching companies. |
| parPage | number | Results per page (1-25, default 25) |
| resetDedup | boolean | Set true to clear the cross-session deduplication list and restart from page 1 with fresh results. Use when the user starts a new prospecting campaign or when too many results are being skipped as duplicates. |
| codesNaf | array | List mode: several NAF codes at once (e.g. ["69.20Z","69.10Z"]). |
| departements | array | List mode: several departments at once (e.g. ["69","42","01"]). |
| trancheEffectifs | array | List mode: several size codes at once (e.g. ["11","12","21"] = 10 to 99 employees). |
| limit | number | List mode: number of NEW companies wanted (26 to 500); the tool chains the pages (25 per request, 25 requests at most) and resumes from the saved cursor next time. |
| creationYearMin | number | Keep companies created on or after this year. |
| creationYearMax | number | Keep companies created on or before this year. |
| withExecutiveOnly | boolean | Keep only companies whose registry gives a named executive (a person, not a holding). |
| nameInitials | string | Keep only company names starting with these initials: "A-L" (digits included), "M-Z", "A-C,X". |
| saveToRegistry | object | Record the companies in the pipeline in the same call (one prospect per company, deduplicated). Give the mission id and the segment label. |
Call this tool
Through the HTTP API, or from the MCP server with the run meta-tool.
curl https://api.ezyagents.fr/gateway/v1/run \
-H "Authorization: Bearer ezk_…" -H "Content-Type: application/json" \
-d '{"tool":"search_companies_pappers","input":{"q":"…","codeNaf":"…","departement":"…","trancheEffectif":"…"}}'$
run({ "tool": "search_companies_pappers", "input": {"q":"…","codeNaf":"…","departement":"…","trancheEffectif":"…"} })