API e MCP para integrar as consultas ao seu sistema

Autenticação

• Cada conta gera as próprias chaves na aba APIs da plataforma. A chave aparece uma vez; guarde-a no cofre do seu servidor.
• Envie a chave em Authorization: Bearer <chave> ou em X-API-Key: <chave>.
• Base da API: https://leadsb2bbrasil.com/api/v1. Servidor MCP: https://leadsb2bbrasil.com/api/mcp.

Respostas e erros

As respostas são JSON. Erro: { "ok": false, "erro": { "codigo", "mensagem" } }.

• 401: chave ausente, inválida ou de formato antigo.
• 402: saldo insuficiente. Nada é consultado.
• 403: chave revogada, conta bloqueada ou sem os campos da consulta. Nada é cobrado.
• 422: parâmetro ausente ou inválido (CPF e CNPJ são conferidos).
• 429: aguarde os segundos de Retry-After e repita.
• Se a pesquisa não retornar resultado, ela não é cobrada. A mesma pesquisa no mesmo dia não é cobrada de novo até 23:59 (horário de Brasília).

Exemplos

Os documentos abaixo são fictícios. Troque SUA_CHAVE pela chave da conta.

curl -sS "https://leadsb2bbrasil.com/api/v1/cnpj/regular?cnpj=11222333000181" \
  -H "Authorization: Bearer SUA_CHAVE"

curl -sS "https://leadsb2bbrasil.com/api/v1/consulta/leads?q=clinica%20odontologica%20sao%20paulo" \
  -H "X-API-Key: SUA_CHAVE"

curl -sS -X POST "https://leadsb2bbrasil.com/api/v1/personalizada" \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"cnpj":"11222333000181","campos":["cadastro","sancoes","socios_cadastro"]}'

Endpoints

O preço de cada consulta é o mesmo da plataforma e aparece só dentro dela, antes de pesquisar. A lista abaixo é a das consultas públicas desta versão.

Pacotes

Consultas

Consulta personalizada

Servidor MCP

O MCP usa o transporte Streamable HTTP. Cada tool executa a consulta equivalente e debita o mesmo saldo. Sem resultado, não há débito.

Cursor (mcp.json)

{
  "mcpServers": {
    "leadsb2b-brasil": {
      "url": "https://leadsb2bbrasil.com/api/mcp",
      "headers": { "Authorization": "Bearer SUA_CHAVE" }
    }
  }
}

Claude

{
  "mcpServers": {
    "leadsb2b-brasil": {
      "type": "http",
      "url": "https://leadsb2bbrasil.com/api/mcp",
      "headers": { "Authorization": "Bearer SUA_CHAVE" }
    }
  }
}

Cobrança

Cada chamada com resultado debita o preço da consulta na plataforma, do saldo pré-pago da conta da chave. CNPJ Regular custa R$ 0,32, CNPJ Pro custa R$ 0,70 e CNPJ Leads B2B Brasil custa R$ 1,00 por consulta. O MCP debita o mesmo valor. A partir de R$0,06 por consulta. Os demais valores aparecem dentro da plataforma. Como funciona a cobrança.

Perguntas frequentes