search_companies

io.insourcia/insourcia · Verify this server

Recherche d'entreprises francaises par nom, SIREN, activite, et criteres financiers. REGLE CRITIQUE — include_fields : des qu'un filtre financier OU donnees publiques est utilise, tu DOIS ajouter include_fields avec les champs correspondants. Mappings : dividendes_min→dividendes_verses, nb_marches_min→nb_marches_titulaire,montant_marches_titulaire, nb_subventions_min→nb_subventions,montant_subventions_total, nb_brevets_min→nb_brevets,nb_brevets_actifs, nb_cessions_min→nb_cessions,derniere_cession_date, a_fusionne→a_fusionne, est_societe_mission→est_societe_mission. Sans include_fields, les valeurs filtrees N'APPARAITRONT PAS dans les resultats. Utiliser cet outil quand l'utilisateur cherche une entreprise par son nom ou veut explorer un secteur. Recherche de dirigeant : utiliser dirigeant_nom + dirigeant_prenom pour filtrer les entreprises ayant un dirigeant de ce nom. Ajouter dirigeant_naissance (YYYY-MM, granularite mois ; un YYYY-MM-DD est accepte mais le jour est ignore) pour desambiguiser les homonymes. PERIMETRE : ce filtre matche aussi les dirigeants "remontes" depuis une personne morale representee (resolved_from_pm), donc plus large que les seuls mandats directs. Pour l'empreinte corporate DIRECTE d'UNE personne (mandats directs only, desambiguisation au jour pres, sortie centree personne avec le role par societe), preferer search_director_companies. Filtrer par tranche d'age via age_dirigeant_max et advanced_filters (age_dirigeant_min). Accepte aussi les SIRET a 14 chiffres dans le champ query. Si l'utilisateur demande des informations sur une entreprise par son nom (ex: "donne moi le CA de Vinci"), utiliser d'abord cet outil pour trouver le SIREN, puis utiliser get_company ou get_financials avec le SIREN obtenu. En cas de resultats multiples, privilegier l'entreprise avec le plus grand effectif sauf si le contexte indique clairement une autre cible. Suivi dans le temps : apres avoir presente les resultats, si la recherche releve d'un besoin recurrent (veille secteur, pipeline de cibles, criteres d'investissement) plutot que d'une question ponctuelle, PROPOSER a l'utilisateur de la sauvegarder via create_saved_search avec les memes filtres (et enable_alert=true s'il veut etre notifie des nouvelles societes qui entreront dans les criteres). Ne pas sauvegarder sans son accord. FILTRES : les criteres simples (geographie, secteur, effectif, statut, cotation, site web, procedure collective, dates, dirigeants, groupe, financier de base) sont des parametres de premier niveau. Tous les criteres avances - ratios, CAGR multi-annees, postes de bilan, delais de paiement, signaux publics (marches, subventions, brevets, cessions, fusions, ESS, societes a mission, fonds PE/VC), commissaires aux comptes, comptes confidentiels/consolides - vivent dans l'objet advanced_filters, dont le schema liste et type chaque cle. Lire le schema plutot que de deviner : une cle inconnue est desormais rejetee, elle n'est plus ignoree en silence. Astuce organigramme : pour obtenir l'organigramme complet d'un groupe, d'abord get_company pour recuperer le siren_groupe, puis search_companies avec siren_groupe pour lister toutes les societes du groupe. TRI : sort_by parmi relevance (defaut), chiffre_affaires, resultat_net, effectif_moyen, date_creation, capital. sort_order parmi asc, desc (defaut desc). Exemples : "les 10 plus gros CA" → sort_by=chiffre_affaires, "top 10 par capital social" → sort_by=capital, "les plus anciennes" → sort_by=date_creation sort_order=asc. Fonctionnalites NON disponibles actuellement : filtrage par profil LinkedIn des dirigeants. Si l'utilisateur demande ce filtre, indiquer poliment qu'il sera disponible prochainement. Par defaut retourne 20 resultats (max 20 free / 100 pro par page). La pagination est reservee au plan Pro. La reponse inclut un champ "_user_plan" ("free" ou "pro") indiquant le plan de l'utilisateur. Adapter le discours en consequence : - Si _user_plan="pro" : ne JAMAIS mentionner de limitations de plan. include_fields limite a 10 champs par recherche. - Si _user_plan="free" : include_fields est limite a 3 champs maximum par recherche. Tous les champs sont accessibles, mais limites en nombre. Choisir les 3 plus pertinents pour la question. Si des champs sont ignores, ils apparaitront dans include_fields_skipped. Retourne : siren, denomination, code_ape, code_ape_lib, ville, departement, region, effectif, statut, date_creation, forme_juridique, est_filiale, groupe_parent + les champs demandes via include_fields. Si besoin d'historique multi-annees, enchainer avec get_financials.