get_company_graph
Cartographie des entités autour d'UNE société (par SIREN) : graphe orienté construit sur les mandats RCS/RNE et les liens de groupe. Pour la structure d'un groupe : holdings, filiales, sociétés sœurs, dirigeants communs. Complémentaire de get_directors (mandats d'une société) et de search_director_companies (mandats directs d'un dirigeant).
Réponse : nodes[] (entreprises "co:", personnes "pp:||", parents étrangers "co:ext:") et edges[] orientées :
mandat_pm : société dirigeante -> société dirigée
filiale : mère -> filiale (associé unique RNE)
parent_ultime : parent ultime (GLEIF) -> société
mandat_pp : personne -> société dirigée
À savoir :
Pas de pourcentage de détention. Les commissaires aux comptes sont exclus.
depth=1 (défaut) : liens directs. depth=2 : expansion depuis les parents et sociétés dirigeantes, jamais depuis les filiales.
Les dirigeants de la racine tirent leurs autres sociétés (holdings personnelles, SCI, structures sœurs). expand_persons=false donne un graphe purement capitalistique. Un mandataire professionnel (plus de 50 mandats, ou cabinet comptable) n'est pas étendu : voir meta.truncated.hub_directors.
Plafonds par nœud et max_nodes : meta.truncated signale un graphe partiel.
Filtres : include_personnes, include_sci, include_ceased, expand_persons. La racine n'est jamais filtrée.
Pour plusieurs sociétés, le paramètre sirens sert 3 graphes en une requête (2 en depth=2), à depth=1 par défaut : une traversée coûte 3 à 5 secondes et ne se parallélise pas.
COÛT en crédits : 1 par société demandée, 2 en depth=2, à la profondeur servie (1 par défaut), jamais pour les nœuds ; société relue sous 30 jours : 0 crédit ; au quota : 1 unité par société distincte.
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": "get_company_graph"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | Profondeur du graphe (1 = liens directs, défaut ; 2 = expansion) | |
| siren | No | SIREN a 9 chiffres de la société racine | |
| sirens | No | Plusieurs SIREN en un appel (3 max) au lieu d'un appel par société. Exclusif avec siren. Même coût qu'à l'unité : un lot de N est facturé comme N sociétés servies, seul le nombre de requêtes change. En depth=2 le plafond descend à 2 sociétés. | |
| max_nodes | No | Nombre max de nœuds (défaut 100) | |
| include_sci | No | false = exclure les SCI (catégorie juridique 65xx) | |
| expand_persons | No | false = ne pas étendre le graphe via les autres sociétés des dirigeants de la racine (défaut: true) | |
| include_ceased | No | false = exclure les sociétés cessées | |
| include_personnes | No | Inclure les dirigeants personnes physiques. Défaut: true |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||