Skip to main content

O que é o llms.txt?

O llms.txt é um arquivo de texto simples que fica na raiz de um site ou documentação e serve como fonte de contexto para modelos de linguagem (LLMs). O conceito é análogo ao robots.txt para motores de busca — mas voltado para IAs. Quando você cola a URL de um llms.txt em ferramentas como Cursor, Claude ou ChatGPT, o modelo passa a entender o produto, os endpoints, os padrões de autenticação e as regras de negócio daquela API sem precisar vasculhar páginas de documentação separadas.
O padrão foi proposto por Jeremy Howard e vem sendo adotado por fintechs, APIs e ferramentas developer-first ao redor do mundo.

Por que a Beehive tem um?

A API Beehive tem particularidades que costumam gerar erros em integrações assistidas por IA:
  • Autenticação com esquema Bearer + Basic (base64 de SECRET_KEY:x)
  • Valores sempre em centavos (ex.: 10000 = R$ 100,00)
  • Objeto metadata obrigatório em toda transação
  • QR Code PIX: a API retorna o texto, não a imagem — a renderização é responsabilidade do cliente
  • Tokenização de cartão exclusivamente no front-end (PCI-DSS)
Sem contexto adequado, agentes de IA cometem esses erros com frequência. O llms.txt resolve isso: ele reúne em um único arquivo todas as regras, exemplos e orientações específicas para quem está construindo ou gerando código de integração com a Beehive.

Como usar

No Cursor

Abra o chat do Cursor e cole o link do arquivo como contexto:
https://docs.beehivehub.io/llms.txt
A partir daí, o Cursor entende os endpoints, campos obrigatórios e padrões da API ao gerar ou revisar código.

No Claude ou ChatGPT

Inicie sua conversa colando o conteúdo do arquivo ou fornecendo a URL diretamente:
Contexto da API: https://docs.beehivehub.io/llms.txt

Com base nisso, me ajude a criar uma transação PIX de R$ 50,00.

Em qualquer agente ou MCP

O arquivo segue o padrão llms.txt — compatível com qualquer ferramenta que consuma contexto em texto plano.

Acessar o arquivo

llms.txt — Contexto para IAs

Arquivo de contexto completo da API Beehive para uso em agentes de IA, Cursor, Claude e ChatGPT.