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 : liens directs. depth=2 (défaut) : 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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | Profondeur du graphe (1 = liens directs, 2 = défaut pour une société seule, 1 = défaut avec sirens) | |
| siren | No | SIREN a 9 chiffres de la société racine | |
| sirens | No | Plusieurs SIREN en un appel, 3 au maximum, au lieu de répéter l'appel société par société. Exclusif avec siren. Le coût de quota est identique (1 par société), ce qui change est le nombre de requêtes. 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 | |||