How do I install the Sirene Lookup skill?

Run npx skillmds@latest add thewatcher01/sirene-lookup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Sirene Lookup safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Sirene Lookup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Sirene Lookup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Sirene Lookup?

TheWatcher01 (@thewatcher01) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Sirene Lookup by thewatcher01 — Agent Skill

Name: Sirene Lookup
Rating: 4.5 (4 reviews)
Author: TheWatcher01

Sirene Lookup

Search French companies and associations via the SIRENE registry. Use when the user asks to find a company by name, SIREN/SIRET number, location, or NAF code. Covers all registered entities in France.

TheWatcher01 88ca3c2 2 files · 11.5 KB Updated Sep 10, 2026

File contents

sirene-lookup

Search the French SIRENE registry to find companies and associations.

Triggers

/sirene OVH Roubaix
/sirene 424761419
"trouve l'entreprise X"
"quel est le SIRET de Y"
"entreprises dans le secteur Z a Toulouse"

How it works

The skill queries two complementary APIs:

Recherche Entreprises DINUM (no auth required) — fast full-text search by name, location, NAF code. Best for fuzzy lookups.
INSEE SIRENE V3.11 (requires INSEE_API_KEY env var) — authoritative data with full details. Used when a SIREN/SIRET is known or when DINUM results need enrichment. Graceful fallback if no key is set.

RGPD compliance

Only entities with statutDiffusionEtablissement === "O" (publicly diffusible) are returned. Non-diffusible entities are silently filtered out.

Usage

python3 {baseDir}/scripts/sirene.py --query "OVH Roubaix" --format json
python3 {baseDir}/scripts/sirene.py --query "424761419" --format text
python3 {baseDir}/scripts/sirene.py --query "cybersecurite" --department 31 --format json

Arguments

Argument	Required	Default	Description
`--query`	yes		Company name, SIREN, SIRET, or keywords
`--department`	no		Filter by department code (e.g. 31, 75)
`--per-page`	no	10	Number of results (1-25)
`--format`	no	json	Output format: `json` or `text`

Output fields

siren — 9-digit SIREN number
siret — 14-digit SIRET (headquarters)
denomination — legal name
address — full postal address
naf_code — NAF/APE activity code
naf_label — human-readable activity label
effectif — workforce bracket
categorie_juridique — legal form
date_creation — creation date
etat_administratif — active/closed

Environment variables

Variable	Required	Description
`INSEE_API_KEY`	no	Bearer token for INSEE SIRENE V3.11. Without it, only DINUM API is used.

---name: sirene-lookupdescription: Search French companies and associations via the SIRENE registry. Use when the user asks to find a company by name, SIREN/SIRET number, location, or NAF code. Covers all registered entities in France.---# sirene-lookupSearch the French SIRENE registry to find companies and associations.## Triggers- `/sirene OVH Roubaix`- `/sirene 424761419`- "trouve l'entreprise X"- "quel est le SIRET de Y"- "entreprises dans le secteur Z a Toulouse"## How it worksThe skill queries two complementary APIs:1. **Recherche Entreprises DINUM** (no auth required) — fast full-text search by name, location, NAF code. Best for fuzzy lookups.2. **INSEE SIRENE V3.11** (requires `INSEE_API_KEY` env var) — authoritative data with full details. Used when a SIREN/SIRET is known or when DINUM results need enrichment. Graceful fallback if no key is set.## RGPD complianceOnly entities with `statutDiffusionEtablissement === "O"` (publicly diffusible) are returned. Non-diffusible entities are silently filtered out.## Usage```bashpython3 {baseDir}/scripts/sirene.py --query "OVH Roubaix" --format jsonpython3 {baseDir}/scripts/sirene.py --query "424761419" --format textpython3 {baseDir}/scripts/sirene.py --query "cybersecurite" --department 31 --format json```## Arguments| Argument | Required | Default | Description ||----------------|----------|---------|------------------------------------------|| `--query` | yes | | Company name, SIREN, SIRET, or keywords || `--department` | no | | Filter by department code (e.g. 31, 75) || `--per-page` | no | 10 | Number of results (1-25) || `--format` | no | json | Output format: `json` or `text` |## Output fields- `siren` — 9-digit SIREN number- `siret` — 14-digit SIRET (headquarters)- `denomination` — legal name- `address` — full postal address- `naf_code` — NAF/APE activity code- `naf_label` — human-readable activity label- `effectif` — workforce bracket- `categorie_juridique` — legal form- `date_creation` — creation date- `etat_administratif` — active/closed## Environment variables| Variable | Required | Description ||-----------------|----------|---------------------------------|| `INSEE_API_KEY` | no | Bearer token for INSEE SIRENE V3.11. Without it, only DINUM API is used. |

Frequently asked questions