Développeurs

Chaque section d’Acryos s’interroge de deux façons : une API REST, pour vos intégrations, et un serveur MCP (Model Context Protocol), pour vos agents. Les deux appellent les mêmes moteurs que le site : mêmes règles de recherche, mêmes limites, mêmes attributions de sources.

Authentification et quotas

Toutes les requêtes portent un jeton personnel dans l’en-tête Authorization: Bearer …, délivré avec votre abonnement. Les appels API et les appels MCP sont comptés séparément, par jour et par organisation ; les en-têtes X-Quota-* de chaque réponse disent où vous en êtes. Pour obtenir un jeton, écrivez-nous depuis votre compte.

curl -H "Authorization: Bearer VOTRE_JETON" \
  "https://acryos.fr/api/v1/travail/conventions?q=syntec"

La ligne de commande

Un seul fichier, aucune dépendance, Node 18 ou plus récent. La CLI enveloppe l’API v1 : mêmes jetons, mêmes quotas, mêmes moteurs.

curl -fsSL https://acryos.fr/cli/acryos.mjs -o ~/.local/bin/acryos
chmod +x ~/.local/bin/acryos
export ACRYOS_TOKEN="VOTRE_JETON"

acryos entreprises "boulangerie" --dept 44
acryos travail conventions syntec
acryos travail code L1221-1
acryos justice decisions "licenciement faute grave" --juridiction ca
acryos justice decision <identifiant>   # le texte intégral

Ajoutez --json pour la réponse brute de l’API, et acryos --aide pour toutes les commandes.

Entreprises

26,8 millions d’entreprises françaises : identité légale, dirigeants, comptes publiés, solvabilité, contacts publiés et profil numérique.

API REST

GET	/api/v1/companies	Recherche d’entreprises : q, postal_code, department, naf_code, city, status, per_page.
GET	/api/v1/companies/{siren}	Fiche complète : identité, dirigeants, établissements, comptes publiés.
GET	/api/v1/companies/{siren}/contacts	Coordonnées publiées, chacune avec sa source.
GET	/api/v1/companies/{siren}/enrichment	Profil numérique : site vérifié, technologies, réseaux sociaux.
POST	/api/v1/companies/{siren}/enrich	Lance l’enrichissement (asynchrone, consomme des crédits).
GET	/api/v1/companies/{siren}/opportunity	Score d’opportunité pour votre offre configurée.

Serveur MCP

Branchez votre agent sur https://acryos.fr/api/mcp/entreprises : il ne voit que les outils de cette section. Le serveur complet vit sur https://acryos.fr/api/mcp.

search_companies
Recherche des entreprises françaises par nom, ville, code postal, département ou code NAF. Retourne l’identité légale officielle (Sirene, RNE, BODACC).
get_company
Fiche complète d’une entreprise par son SIREN : identité, dirigeants, établissements, comptes publiés.
get_company_contacts
Coordonnées publiques d’une entreprise (email, téléphone) effectivement publiées sur son site. Aucune adresse n’est déduite ; une entreprise sans coordonnée publiée retourne une liste vide.
get_company_digital_profile
Profil numérique : site officiel vérifié, technologies détectées, réseaux sociaux, score de maturité et de modernisation.
enrich_company
Lance l’enrichissement d’une entreprise : découverte et vérification du site officiel, relevé des coordonnées publiées, détection des technologies. Opération asynchrone qui consomme des crédits.
score_opportunity
Calcule le score d’opportunité d’une entreprise pour l’offre de service configurée, avec le détail des signaux qui le composent.

Travail

Les conventions collectives et leur texte en vigueur, le Code du travail, et les rattachements de 2,4 millions d’établissements.

API REST

GET	/api/v1/travail/conventions	Conventions collectives par nom, sigle d’usage ou IDCC : q, per_page.
GET	/api/v1/travail/conventions/{idcc}	Fiche d’une convention : intitulés, noms d’usage, volumes.
GET	/api/v1/travail/conventions/articles	Plein texte dans les articles en vigueur de toutes les conventions : q, per_page.
GET	/api/v1/travail/code/articles	Recherche dans le Code du travail : q (plein texte ou numéro d’article), page, per_page.

Serveur MCP

Branchez votre agent sur https://acryos.fr/api/mcp/travail : il ne voit que les outils de cette section. Le serveur complet vit sur https://acryos.fr/api/mcp.

search_collective_agreements
Recherche une convention collective française par son nom, son sigle d’usage (« syntec ») ou son numéro IDCC, celui du bulletin de paie.
get_collective_agreement
Fiche d’une convention collective par son IDCC : intitulé, noms d’usage, nombre d’établissements rattachés et d’articles en vigueur.
search_agreement_articles
Recherche en plein texte dans les articles en vigueur de toutes les conventions collectives : période d’essai, préavis, salaires minima, etc.
search_labor_code
Recherche dans le Code du travail : plein texte, ou numéro d’article cité (« L1221-1 »), qui l’emporte toujours sur le plein texte.

Justice

La jurisprudence en texte intégral (Cour de cassation, cours d’appel, tribunaux judiciaires) et les codes de loi en vigueur.

API REST

GET	/api/v1/justice/decisions	Recherche dans 1,2 million de décisions : q, jurisdiction (cc, ca, tj), date_from, date_to, page, per_page.
GET	/api/v1/justice/decisions/{id}	Le texte intégral officiel d’une décision et ses métadonnées.
GET	/api/v1/justice/codes	La liste des codes de loi disponibles.
GET	/api/v1/justice/codes/articles	Recherche dans les 76 codes : q, code (adresse courte), page, per_page.

Serveur MCP

Branchez votre agent sur https://acryos.fr/api/mcp/justice : il ne voit que les outils de cette section. Le serveur complet vit sur https://acryos.fr/api/mcp.

search_court_decisions
Recherche dans 1,2 million de décisions de justice françaises en texte intégral (Cour de cassation, cours d’appel, tribunaux judiciaires). Accepte une phrase entière, les guillemets, le OU et l’exclusion.
get_court_decision
Le texte intégral officiel d’une décision par son identifiant (renvoyé par search_court_decisions). Le texte n’est jamais réécrit.
search_legal_codes
Recherche dans les 76 codes de loi français en vigueur (Code civil, Code de commerce, Code du travail…). Un numéro d’article cité l’emporte sur le plein texte.

Exemple de configuration MCP

{
  "mcpServers": {
    "acryos-justice": {
      "url": "https://acryos.fr/api/mcp/justice",
      "headers": { "Authorization": "Bearer VOTRE_JETON" }
    }
  }
}

Les données servies portent leurs sources : Sirene et RNE pour les entreprises, fonds KALI pour les conventions, Légifrance pour les codes, Judilibre pour la jurisprudence. Chaque réponse qui en dépend inclut son attribution, à conserver dans vos usages.