Programadores

Construa sobre os dados AYBARION nos seus sistemas e no Claude

Uma API REST com âmbitos, um servidor MCP para assistentes de IA, rastreio de sanções registado e webhooks assinados. Cada resposta indica a sua fonte e licença, e aplicam-se as mesmas regras de dados que na plataforma.

Ligar ao Claude Sheets e Excel Referência da API Planos
Interfaces

Quatro formas de usar o AYBARION a partir do seu próprio software

Todos usam uma chave de API criada com MFA por um proprietário ou administrador da sua empresa. Uma chave tem apenas os âmbitos que escolher, pode expirar após 1 a 365 dias e pode ser revogada a qualquer momento.

Model Context Protocol

Ligar o AYBARION ao Claude

O servidor MCP do AYBARION dá ao Claude as ferramentas de dados AYBİ: produtos e códigos HS em oito idiomas, empresas para um produto e país, o diretório de empresas e fichas de empresas de registos oficiais abertos, estatísticas comerciais oficiais, mercados compradores, oportunidades de exportação, requisitos de importação e taxas de direitos, exportadores verificados e um guia das páginas AYBARION.

  1. Escolha um plano Professional ou superior. Um proprietário ou administrador cria uma chave de API com o âmbito aybi:tools em Integrações. A chave é mostrada uma única vez.
  2. Adicione o AYBARION como servidor MCP remoto no seu cliente Claude. URL do servidor https://aybarion.com/mcp, transporte Streamable HTTP, cabeçalho do pedido Authorization: Bearer ayb_live_…
  3. Faça ao Claude uma pergunta comercial no seu idioma. O Claude chama as ferramentas de que precisa e indica a fonte de cada valor.
Os conectores personalizados nas aplicações Claude iniciam sessão com OAuth, que o AYBARION ainda não disponibiliza. O Claude Code, a Claude API e outros clientes MCP que enviam a chave como cabeçalho do pedido já funcionam.

      

    

  


  

    
Folhas de cálculo

    
Fórmulas AYBARION no Google Sheets e no Excel

    
Cinco funções trazem para as suas células fluxos comerciais, principais parceiros, direitos de importação, linhas pautais dos EUA e registos de empresas. Cada resultado é uma tabela que termina com a sua fonte e licença. As funções usam as mesmas chaves API, âmbitos e limites que a API REST, e as respostas são guardadas durante 6 horas para que um novo cálculo não volte a gastar a sua quota.

    

      

        
Google Sheets

        
    
          
  1. Um proprietário ou administrador cria uma chave API em Integrações com os âmbitos de que as suas funções necessitam: trade:read, requirements:read, directory:read, companies:read.
    2. 
          
  2. Na sua folha de cálculo, abra Extensões, Apps Script. Substitua o código por Code.gs, adicione um ficheiro HTML chamado Sidebar com Sidebar.html, mostre o manifesto nas definições do projeto e substitua-o por appsscript.json. Guarde.
    3. 
          
  3. Recarregue a folha de cálculo e escolha AYBARION, Set API key no menu. A Google pede uma vez autorização para o script se ligar a aybarion.com; a chave é verificada e guardada nas propriedades de utilizador do script para a sua conta.
    4. 
          
  4. Tipo =AYB_DUTY("GB", "640399", "TR") numa célula. Numa folha partilhada, as funções respondem com a chave do proprietário da folha.
    5. 
        

      

      

        
Microsoft Excel

        
    
          
  1. Transferir o manifesto do suplemento manifest.xml. O suplemento funciona a partir de aybarion.com, nada para instalar ou compilar.
    2. 
          
  2. Excel para a Web: Base, Suplementos, Mais Suplementos, Os Meus Suplementos, Carregar o Meu Suplemento e, em seguida, escolha o manifesto. Para o Excel no Windows ou Mac, um administrador do Microsoft 365 implementa o mesmo manifesto em Aplicações integradas.
    3. 
          
  3. Abra Chave AYBARION no separador Início e guarde a sua chave. É verificada, guardada neste navegador para aybarion.com e enviada apenas no cabeçalho Authorization.
    4. 
          
  4. Tipo =AYB.DUTY("GB", "640399", "TR"). O Excel coloca as funções no espaço de nomes AYB, por isso escrevem-se com um ponto.
    5. 
        

      

    

    

  


  

    
Âmbitos

    
O que uma chave pode fazer

    
Cada âmbito requer um plano com a Developer API e uma subscrição ativa ou período de teste. Cada chave tem um limite de pedidos por minuto, e as chamadas de API por dia são uma quota do seu plano partilhada por toda a empresa.

    

  


  

    
Webhooks

    
Eventos enviados para o seu endpoint

    
Os webhooks funcionam apenas por HTTPS e são assinados com HMAC SHA256 e um carimbo temporal. As entregas falhadas são repetidas durante cerca de 19 horas. As atualizações das listas de sanções chegam como contagens de entradas adicionadas, removidas e renomeadas, nunca como nomes.

    

  


  

    
Regras de dados

    
As mesmas regras que na plataforma