Sviluppatori

Sviluppa sui dati AYBARION nei suoi sistemi e in Claude

Un’API REST con ambiti, un server MCP per assistenti AI, screening sanzioni registrato e webhook firmati. Ogni risposta riporta la sua fonte e licenza, e valgono le stesse regole sui dati della piattaforma.

Collega a Claude Sheets ed Excel Riferimento API Piani
Interfacce

Quattro modi per usare AYBARION dal suo software

Tutti utilizzano una chiave API che un proprietario o amministratore della sua azienda crea con MFA. Una chiave contiene solo gli ambiti scelti, può scadere dopo 1–365 giorni e può essere revocata in qualsiasi momento.

Model Context Protocol

Collega AYBARION a Claude

Il server MCP di AYBARION fornisce a Claude gli strumenti dati di AYBİ: prodotti e codici HS in otto lingue, aziende per prodotto e paese, la directory delle aziende e le schede aziendali da registri ufficiali aperti, statistiche commerciali ufficiali, mercati acquirenti, opportunità di esportazione, requisiti di importazione e aliquote dei dazi, esportatori verificati e una guida alle pagine AYBARION.

  1. Scelga un piano Professional o superiore. Un proprietario o amministratore crea una chiave API con l’ambito aybi:tools in Integrazioni. La chiave viene mostrata una sola volta.
  2. Aggiunga AYBARION come server MCP remoto nel suo client Claude. URL del server https://aybarion.com/mcp, trasporto Streamable HTTP, intestazione della richiesta Authorization: Bearer ayb_live_…
  3. Faccia a Claude una domanda sul commercio nella sua lingua. Claude richiama gli strumenti necessari e indica la fonte di ogni valore.
I connettori personalizzati nelle app Claude accedono con OAuth, che AYBARION non offre ancora. Claude Code, la Claude API e gli altri client MCP che inviano la chiave come intestazione della richiesta funzionano già oggi.

      

    

  


  

    
Fogli di calcolo

    
Formule AYBARION in Google Sheets ed Excel

    
Cinque funzioni portano nelle sue celle flussi commerciali, principali partner, dazi all’importazione, voci tariffarie USA e dati aziendali. Ogni risultato è una tabella che termina con la fonte e la licenza. Le funzioni usano le stesse chiavi API, gli stessi ambiti e limiti della REST API, e le risposte vengono conservate per 6 ore, così un ricalcolo non consuma di nuovo la sua quota.

    

      

        
Google Sheets

        
    
          
  1. Un proprietario o amministratore crea una chiave API su Integrazioni con gli ambiti necessari alle tue funzioni: trade:read, requirements:read, directory:read, companies:read.
    2. 
          
  2. Nel foglio di calcolo apri Estensioni, Apps Script. Sostituisci il codice con Code.gs, aggiungete un file HTML chiamato Sidebar con Sidebar.html, mostrate il manifest nelle impostazioni del progetto e sostituitelo con appsscript.json. Salvate.
    3. 
          
  3. Ricarica il foglio di calcolo e scegli AYBARION, Set API key nel menu. Google chiede una sola volta di consentire allo script di connettersi ad aybarion.com; la chiave viene verificata e conservata nelle proprietà utente dello script per il tuo account.
    4. 
          
  4. Tipo =AYB_DUTY("GB", "640399", "TR") in una cella. In un foglio condiviso le funzioni rispondono con la chiave del proprietario del foglio.
    5. 
        

      

      

        
Microsoft Excel

        
    
          
  1. Scarica il manifest del componente aggiuntivo manifest.xml. Il componente aggiuntivo funziona da aybarion.com, niente da installare o compilare.
    2. 
          
  2. Excel sul web: Home, Componenti aggiuntivi, Altri componenti aggiuntivi, I miei componenti aggiuntivi, Carica il mio componente aggiuntivo, quindi scegli il manifest. Per Excel su Windows o Mac un amministratore di Microsoft 365 distribuisce lo stesso manifest in App integrate.
    3. 
          
  3. Apri Chiave AYBARION nella scheda Home e salva la tua chiave. Viene verificata, conservata in questo browser per aybarion.com e inviata solo nell'intestazione Authorization.
    4. 
          
  4. Tipo =AYB.DUTY("GB", "640399", "TR"). Excel inserisce le funzioni nello spazio dei nomi AYB, quindi si scrivono con un punto.
    5. 
        

      

    

    

  


  

    
Ambiti

    
Cosa può fare una chiave

    
Ogni ambito richiede un piano con la Developer API e un abbonamento attivo o una prova. Ogni chiave ha un limite di frequenza al minuto, e le chiamate API giornaliere sono una quota del suo piano valida per tutta l’azienda.

    

  


  

    
Webhook

    
Eventi inviati al suo endpoint

    
I webhook sono solo HTTPS e firmati con HMAC SHA256 e un timestamp. Le consegne non riuscite vengono ritentate per circa 19 ore. Gli aggiornamenti delle liste di sanzioni arrivano come conteggi di voci aggiunte, rimosse e rinominate, mai come nomi.

    

  


  

    
Regole sui dati

    
Le stesse regole della piattaforma