Développeurs

Construire sur les données AYBARION dans vos systèmes et dans Claude

Une API REST à périmètre défini, un serveur MCP pour les assistants IA, un filtrage des sanctions enregistré et des webhooks signés. Chaque réponse indique sa source et sa licence, et les mêmes règles de données s’appliquent que sur la plateforme.

Connecter à Claude Sheets et Excel Référence API Offres

Interfaces

Quatre façons d’utiliser AYBARION depuis votre propre logiciel

Tous utilisent une clé API qu’un propriétaire ou un administrateur de votre entreprise crée avec MFA. Une clé ne porte que les périmètres que vous choisissez, peut expirer après 1 à 365 jours et peut être révoquée à tout moment.

Model Context Protocol

Connecter AYBARION à Claude

Le serveur MCP d’AYBARION donne à Claude les outils de données AYBİ : produits et codes HS en huit langues, entreprises pour un produit et un pays, annuaire des entreprises et fiches d’entreprise issues des registres ouverts officiels, statistiques commerciales officielles, marchés acheteurs, opportunités d’exportation, exigences à l’importation et taux de droits, exportateurs vérifiés et un guide des pages AYBARION.

Choisissez une offre Professional ou supérieure. Un propriétaire ou un administrateur crée une clé API avec le périmètre aybi:tools dans Intégrations. La clé n’est affichée qu’une seule fois.
Ajoutez AYBARION comme serveur MCP distant dans votre client Claude. URL du serveur https://aybarion.com/mcp, transport Streamable HTTP, en-tête de requête Authorization: Bearer ayb_live_…
Posez à Claude une question commerciale dans votre langue. Claude appelle les outils nécessaires et indique la source de chaque chiffre.

Les connecteurs personnalisés des applications Claude se connectent via OAuth, qu’AYBARION ne propose pas encore. Claude Code, la Claude API et les autres clients MCP qui envoient la clé dans un en-tête de requête fonctionnent dès aujourd’hui.

Tableurs

Formules AYBARION dans Google Sheets et Excel

Cinq fonctions intègrent dans vos cellules les flux commerciaux, les principaux partenaires, les droits à l’importation, les lignes tarifaires américaines et les fiches d’entreprises. Chaque résultat est un tableau qui se termine par sa source et sa licence. Les fonctions utilisent les mêmes clés API, portées et limites que l’API REST, et les réponses sont conservées 6 heures afin qu’un recalcul ne consomme pas à nouveau votre quota.

Google Sheets

Un propriétaire ou un administrateur crée une clé API sur Intégrations avec les autorisations nécessaires à vos fonctions : trade:read, requirements:read, directory:read, companies:read.
Dans votre feuille de calcul, ouvrez Extensions, Apps Script. Remplacez le code par Code.gs, ajoutez un fichier HTML nommé Sidebar avec Sidebar.html, affichez le manifeste dans les paramètres du projet et remplacez-le par appsscript.json. Enregistrez.
Rechargez la feuille de calcul et choisissez AYBARION, Set API key dans le menu. Google vous demande une fois d'autoriser le script à se connecter à aybarion.com ; la clé est vérifiée et conservée dans les propriétés utilisateur du script pour votre compte.
Type =AYB_DUTY("GB", "640399", "TR") dans une cellule. Dans une feuille partagée, les fonctions répondent avec la clé du propriétaire de la feuille.

Microsoft Excel

Télécharger le manifeste du complément manifest.xml. Le complément fonctionne depuis aybarion.com, rien à installer ni à compiler.
Excel sur le web : Accueil, Compléments, Autres compléments, Mes compléments, Charger mon complément, puis choisissez le manifeste. Pour Excel sous Windows ou Mac, un administrateur Microsoft 365 déploie le même manifeste dans Applications intégrées.
Ouvrez Clé AYBARION dans l’onglet Accueil et enregistrez votre clé. Elle est vérifiée, conservée dans ce navigateur pour aybarion.com et envoyée uniquement dans l’en-tête Authorization.
Type =AYB.DUTY("GB", "640399", "TR"). Excel place les fonctions dans l’espace de noms AYB, elles s’écrivent donc avec un point.

Périmètres d’accès

Ce qu’une clé permet de faire

Chaque périmètre nécessite une offre avec la Developer API et un abonnement actif ou un essai. Chaque clé a une limite de débit par minute, et les appels API par jour constituent un quota de votre offre à l’échelle de l’entreprise.

Webhooks

Événements envoyés à votre point de terminaison

Les webhooks sont uniquement en HTTPS et signés avec HMAC SHA256 et un horodatage. Les livraisons échouées sont relancées pendant environ 19 heures. Les mises à jour des listes de sanctions arrivent sous forme de nombres d’entrées ajoutées, supprimées et renommées, jamais sous forme de noms.

Règles relatives aux données

Les mêmes règles que sur la plateforme

Aucune coordonnée : AYBARION ne renvoie jamais d’e-mails, de numéros de téléphone, de noms de personnes ni leurs adresses, que ce soit dans l’API, les outils MCP ou les réponses IA.
Aucune donnée d’entreprise pour la Russie, la Biélorussie, l’Iran, la Corée du Nord, la Syrie, Cuba, le Pérou ou les Philippines. Les statistiques commerciales restent disponibles.
Le filtrage des sanctions renvoie des correspondances potentielles pour examen humain, jamais une décision juridique. Les personnes listées ne sont jamais nommées.
Les données proviennent de sources officielles et sous licence ouverte. Chaque réponse indique l’éditeur, la licence et les identifiants d’enregistrement.