English Français العربية

Dabra MCP

السجل الرسمي المالية والمدفوعات

Brazilian company and person data by CNPJ/CPF: registry, partners, tax status, sanctions, lawsuits.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http dabra-mcp 'https://app.dabradata.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "dabra-mcp": {
            "type": "http",
            "url": "https://app.dabradata.com/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Dabra - API Examples
  2. Inicio rapido
  3. Formato das chamadas
  4. Exemplos por linguagem
  5. Casos de uso
  6. Comprovante da consulta
  7. Headers de resposta
  8. Erros
  9. Saldo
  10. Webhooks
  11. MCP
  12. Outros produtos
  13. OpenAPI e Postman
  14. Links
  15. Contribuindo

Dabra - API Examples

Exemplos de integracao com a API da Dabra: 132 consultas de dados brasileiros (CNPJ, CPF, KYC, compliance, processos judiciais, credito, sancoes internacionais) e envio de SMS/OTP, por uma API REST pre-paga, com uma unica chave.

Inicio rapido

  1. Crie a conta em app.dabradata.com/signup. Sem cartao de credito e sem mensalidade: voce paga por consulta, com saldo pre-pago.

  2. Na pagina de chaves do painel ha duas chaves:

    • teste (dabra_test_...): aceita qualquer valor com formato valido e devolve o exemplo de resposta do endpoint, a custo zero, marcado com o header X-Example: true. A validacao de parametros e a mesma da producao. Use para montar a integracao.
    • producao (dabra_live_...): consulta real, debitada do saldo.

    Chaves emitidas antes de 24/09/2026 (fd_live_..., fd_test_...) continuam validas.

  3. Rode um exemplo:
curl -H "X-API-Key: dabra_test_SUA_CHAVE" \
  "https://app.dabradata.com/api/v1/consulta/receita-federal-pj?cnpj=00000000000191"

Todos os exemplos leem a chave da variavel de ambiente DABRA_API_KEY:

export DABRA_API_KEY=dabra_test_SUA_CHAVE
python python/cnpj.py 00.000.000/0001-91

Formato das chamadas

GET https://app.dabradata.com/api/v1/consulta/<slug>?<parametro>=<valor>
X-API-Key: <sua chave>
  • Os parametros vao na querystring (?cpf=..., ?cnpj=..., ?nome=...). CPF e CNPJ aceitam com ou sem pontuacao.
  • Algumas consultas pedem "um de" (por exemplo cpf ou cnpj); a pagina de cada consulta diz quais parametros sao obrigatorios.
  • As listas internacionais (OFAC, ONU, UE, Reino Unido, FBI, Interpol) sao consultadas por nome. Para pessoa fisica com CPF, listas-restritivas cruza 17 listas nacionais e internacionais pelo documento.
  • Mensageria (sms-enviar, otp-send, otp-verify, otp-resend, sms-status) e mais algumas consultas usam POST com corpo JSON.
  • A resposta de sucesso e o JSON da consulta, sem envelope.
  • Para repetir uma chamada com seguranca, envie X-Idempotency-Key: a mesma chave devolve a resposta original sem cobrar de novo.

Referencia completa, com preco, parametros e exemplo de resposta de cada consulta: dabradata.com/docs. Toda pagina da referencia tambem existe em markdown, no mesmo endereco com .md no fim.

Exemplos por linguagem

LinguagemPastaDependenciasRodar
cURL (bash)/curlnenhuma./curl/cnpj.sh 00000000000191
Python/pythonpip install -r python/requirements.txtpython python/cnpj.py
Node.js/nodejsNode 18+, sem depsnode nodejs/cnpj.js
PHP/phpPHP 7.4+, ext-curlphp php/cnpj.php
Go/goGo 1.21+, stdlibgo run go/cnpj.go

Casos de uso

Custos de referencia pela tabela publica em 24/09/2026. O custo real de cada chamada vem no header X-Request-Cost; os precos atuais estao em dabradata.com/pricing.

CasoCustoPythonNode.jsPHPGocURL
Consultar CNPJ (Receita Federal + QSA)R$ 0,43cnpj.pycnpj.jscnpj.phpcnpj.gocnpj.sh
Consultar CPF (Receita Federal)R$ 0,54cpf.py---cpf.sh
KYC pessoa fisicaR$ 6,43 (Python) / R$ 6,00kyc_pf.pykyc_pf.jskyc_pf.phpkyc_pf.go-
KYC pessoa juridicaR$ 11,27kyc_pj.py----
Due diligence de empresaR$ 15,52due_diligence.py----
Background check de candidatoR$ 4,75background_check.py----
Compliance de fornecedores (CSV)R$ 2,59 por CNPJcompliance_fornecedor.py----
Sancoes internacionaisR$ 3,31 por nome----sancoes.sh
Consulta com comprovante (CNDT)R$ 0,54 + 25% so com o linkcomprovante.pycomprovante.jscomprovante.phpcomprovante.gocomprovante.sh
Enviar SMS e OTPR$ 0,29 por credito----sms.sh
Receber webhook (verificar assinatura)gratiswebhook_assinatura.py----

Comprovante da consulta

Consultas com certidao (por exemplo tst-cndt, ccd-pj, fgts-regularidade) podem devolver o documento emitido pela fonte. Peca com comprovante=1 (na querystring, ou no corpo nas POST):

curl -s -H "X-API-Key: $DABRA_API_KEY"   "https://app.dabradata.com/api/v1/consulta/tst-cndt?cnpj=00000000000191&comprovante=1"

A resposta traz "comprovante": ["https://arquivos.dabradata.com/comprovantes/cpv_..."].

  • O link e aberto (nao leva X-API-Key) e vale 7 dias.
  • 202: o arquivo ainda esta sendo preparado; tente de novo em instantes (respeite Retry-After).
  • 410: o prazo acabou ou o arquivo nao esta mais disponivel; faca uma nova consulta.
  • Acrescimo de 25% sobre o preco da consulta, cobrado somente quando o link vem na resposta (o custo final fica em X-Request-Cost). Sem comprovante=1, nada muda.
  • Com a chave de teste a resposta e o exemplo, sem custo, e o link e ficticio.

Exemplos que consultam e baixam comprovante[0], com espera no 202 e erro claro no 410: curl/comprovante.sh, python/comprovante.py, nodejs/comprovante.js, php/comprovante.php e go/comprovante.go. Documentacao: dabradata.com/docs/comprovante.

Headers de resposta

HeaderDescricao
X-Request-CostCusto debitado nesta chamada, em BRL
X-Balance-RemainingSaldo restante apos a chamada
X-RateLimit-Limit-RPM / X-RateLimit-Remaining-RPMLimite e restante por minuto
X-RateLimit-Limit-RPD / X-RateLimit-Remaining-RPDLimite e restante por dia
X-Response-Time-MsTempo de processamento
X-Exampletrue quando a resposta e o exemplo da chave de teste
X-Idempotent-Replaytrue quando a resposta veio de uma X-Idempotency-Key repetida

Erros

Todo erro tem o mesmo envelope:

{"error": {"code": "insufficient_balance", "message": "...", "hint": "...", "details": {}}}
HTTPcodeQuando
400invalid_parametersParametro ausente ou em formato invalido
401unauthorizedChave ausente ou invalida
402insufficient_balanceSaldo insuficiente; details traz required_brl e available_brl
403email_not_verified, kyc_requiredConta ainda nao liberada para consultar (e-mail ou verificacao pendente)
404not_foundSlug inexistente, ou documento sem registro na base consultada
429rate_limit_exceededLimite de requisicoes; respeite o header Retry-After
5xxvariaA fonte nao respondeu. Uma falha nunca significa "nada consta"

Em regra, erro nao e cobrado. Algumas fontes cobram mesmo quando nao ha registro para o documento; nesses casos o custo vem em X-Request-Cost, como numa resposta de sucesso.

Saldo

curl -H "X-API-Key: $DABRA_API_KEY" https://app.dabradata.com/api/v1/administrative/balance

Resposta com cache de 60 segundos; as respostas das consultas ja trazem o saldo no header X-Balance-Remaining. Ver dabradata.com/docs/administrativo/saldo.

Webhooks

Eventos disponiveis: sms.mo.received, sms.optout e topup.credited. Cada entrega e assinada com HMAC-SHA256 do corpo bruto no header X-Dabra-Signature: sha256=<hex>. Por compatibilidade, o mesmo valor tambem e enviado em X-FonteData-Signature durante 12 meses (a partir de 24/09/2026): valide o header novo e use o legado so como fallback. Retentativas por 24 horas; deduplique por event_id. Exemplo em python/webhook_assinatura.py e documentacao em dabradata.com/docs/webhooks.

MCP

As mesmas consultas estao disponiveis para Claude, ChatGPT, Cursor e outros clientes MCP, pelo servidor remoto:

https://app.dabradata.com/mcp

Login por OAuth 2.1 no navegador, sem colar chave. O preco e o saldo sao os mesmos da API REST, e toda execucao pede confirmacao do custo antes de debitar. Ver dabradata.com/docs/mcp.

Outros produtos

  • Lote: enriquecimento de uma planilha CSV inteira pelo painel, sem codigo. Formato dos arquivos: dabradata.com/docs/lote.
  • Dossie: relatorio de uma pessoa ou empresa por finalidade (credito, contratacao, due diligence), com parecer e fontes citadas: dabradata.com/dossie.
  • SMS e OTP: remetente white-label, OTP gerenciado e respostas do destinatario por webhook: dabradata.com/sms.

OpenAPI e Postman

No Postman, importe a colecao e preencha a variavel API_KEY. Com a chave de teste, cada requisicao devolve o exemplo do endpoint sem custo.

Contribuindo

Veja CONTRIBUTING.md. Exemplos em novas linguagens sao bem-vindos.

الأسئلة الشائعة

ما هو Dabra MCP؟

Brazilian company and person data by CNPJ/CPF: registry, partners, tax status, sanctions, lawsuits.

كيف أثبّت Dabra MCP؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http dabra-mcp 'https://app.dabradata.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Dabra MCP إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Dabra MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Dabra MCP؟

ينشره DabraData. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.