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
Input
| Field | Type | Description |
|---|---|---|
| q | string | Free-text search (company name or SIRET/SIREN) |
| codeNaf | string | NAF/APE activity code — pass WITHOUT dots, e.g. "6201Z" (software), "4791A" (e-commerce), "7022Z" (management consulting) |
| departement | string | French department number, e.g. "75" (Paris), "69" (Rhône), "13" (Bouches-du-Rhône) |
| 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. |
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":"…"} })