Entwickler

Auf AYBARION-Daten aufbauen in Ihren Systemen und in Claude

Eine REST-API mit Berechtigungsbereichen, ein MCP-Server für KI-Assistenten, protokolliertes Sanktions-Screening und signierte Webhooks. Jede Antwort nennt Quelle und Lizenz, und es gelten dieselben Datenregeln wie auf der Plattform.

Schnittstellen

Vier Wege, AYBARION aus Ihrer eigenen Software zu nutzen

Alle verwenden einen API-Schlüssel, den ein Inhaber oder Administrator Ihres Unternehmens mit MFA erstellt. Ein Schlüssel trägt nur die von Ihnen gewählten Berechtigungsbereiche, kann nach 1 bis 365 Tagen ablaufen und jederzeit widerrufen werden.

Model Context Protocol

AYBARION mit Claude verbinden

Der AYBARION-MCP-Server gibt Claude die AYBİ-Datentools: Produkte und HS-Codes in acht Sprachen, Unternehmen zu einem Produkt und Land, das Firmenverzeichnis und Unternehmenskarten aus amtlichen offenen Registern, amtliche Handelsstatistiken, Käufermärkte, Exportchancen, Einfuhranforderungen und Zollsätze, verifizierte Exporteure und einen Leitfaden zu den AYBARION-Seiten.

  1. Wählen Sie einen Professional-Tarif oder höher. Ein Inhaber oder Administrator erstellt einen API-Schlüssel mit dem aybi:tools Berechtigungsbereich im Integrationen. Der Schlüssel wird nur einmal angezeigt.
  2. Fügen Sie AYBARION als Remote-MCP-Server in Ihrem Claude-Client hinzu. Server-URL https://aybarion.com/mcp, Transport Streamable HTTP, Request-Header Authorization: Bearer ayb_live_…
  3. Stellen Sie Claude eine Handelsfrage in Ihrer Sprache. Claude ruft die benötigten Tools auf und nennt die Quelle jeder Zahl.
Benutzerdefinierte Konnektoren in den Claude-Apps melden sich mit OAuth an, das AYBARION noch nicht anbietet. Claude Code, die Claude API und andere MCP-Clients, die den Schlüssel als Request-Header senden, funktionieren schon heute.

      
Tabellen

AYBARION-Formeln in Google Sheets und Excel

Fünf Funktionen bringen Handelsströme, wichtigste Partner, Einfuhrzoll, US-Zolltarifpositionen und Unternehmensdaten in Ihre Zellen. Jedes Ergebnis ist eine Tabelle, die mit Quelle und Lizenz endet. Die Funktionen nutzen dieselben API-Schlüssel, Berechtigungen und Limits wie die REST-API, und Antworten werden 6 Stunden gespeichert, sodass eine Neuberechnung Ihr Kontingent nicht erneut verbraucht.

Google Sheets

  1. Ein Inhaber oder Admin erstellt einen API-Schlüssel unter Integrationen mit den Berechtigungen, die Ihre Funktionen benötigen: trade:read, requirements:read, directory:read, companies:read.
  2. Öffnen Sie in Ihrer Tabelle Erweiterungen, Apps Script. Ersetzen Sie den Code durch Code.gs, fügen Sie eine HTML-Datei namens Sidebar hinzu mit Sidebar.html, zeigen Sie das Manifest in den Projekteinstellungen an und ersetzen Sie es durch appsscript.json. Speichern.
  3. Laden Sie die Tabelle neu und wählen Sie im Menü AYBARION, Set API key. Google fragt einmalig, ob das Skript eine Verbindung zu aybarion.com herstellen darf; der Schlüssel wird geprüft und in den Benutzereigenschaften des Skripts für Ihr Konto gespeichert.
  4. Typ =AYB_DUTY("GB", "640399", "TR") in eine Zelle. In einer geteilten Tabelle antworten die Funktionen mit dem Schlüssel des Tabelleninhabers.

Microsoft Excel

  1. Add-in-Manifest herunterladen manifest.xml. Das Add-in läuft über aybarion.com, nichts zu installieren oder zu erstellen.
  2. Excel im Web: Start, Add-Ins, Weitere Add-Ins, Meine Add-Ins, Mein Add-In hochladen, dann das Manifest auswählen. Für Excel unter Windows oder Mac stellt ein Microsoft 365-Admin dasselbe Manifest unter Integrierte Apps bereit.
  3. Öffnen Sie auf dem Tab Start den AYBARION-Schlüssel und speichern Sie Ihren Schlüssel. Er wird geprüft, in diesem Browser für aybarion.com gespeichert und nur im Authorization-Header gesendet.
  4. Typ =AYB.DUTY("GB", "640399", "TR"). Excel legt die Funktionen im Namensraum AYB ab, daher werden sie mit Punkt geschrieben.
Berechtigungsbereiche

Was ein Schlüssel kann

Jeder Berechtigungsbereich erfordert einen Tarif mit der Developer API und ein aktives Abonnement oder einen Testzeitraum. Jeder Schlüssel hat ein Ratenlimit pro Minute, und die API-Aufrufe pro Tag sind ein unternehmensweites Kontingent Ihres Tarifs.

Webhooks

An Ihren Endpunkt gepushte Ereignisse

Webhooks sind nur über HTTPS verfügbar und mit HMAC SHA256 und einem Zeitstempel signiert. Fehlgeschlagene Zustellungen werden etwa 19 Stunden lang wiederholt. Aktualisierungen von Sanktionslisten kommen als Anzahl hinzugefügter, entfernter und umbenannter Einträge, nie als Namen.

Datenregeln

Dieselben Regeln wie auf der Plattform