Dabra MCP

Dabra - API 示例

通过预付费 REST API，使用一个密钥即可与 Dabra API 集成：查询 132 项巴西数据 （CNPJ、CPF、KYC、合规、司法案件、信贷、国际制裁），并发送 SMS/OTP。

快速开始

1. 在 app.dabradata.com/signup 创建账户。无需信用卡，也无需月费： 按次查询，使用预付费余额。

2. 控制面板的密钥页面上有两个密钥：

   • 测试（dabra_test_...）：接受任何格式有效的值，并以零成本返回端点的示例响应， 响应会带有 X-Example: true 标头。参数验证方式与生产环境相同。可用于构建集成。
   • 生产（dabra_live_...）：执行真实查询，并从余额中扣费。

   2026 年 9 月 24 日之前签发的密钥（fd_live_...、fd_test_...）仍然有效。

3. 运行一个示例：

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

所有示例都会从环境变量 DABRA_API_KEY 中读取密钥：

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

调用格式

GET https://app.dabradata.com/api/v1/consulta/<slug>?<parametro>=<valor>
X-API-Key: <sua chave>

• 参数通过查询字符串传递（?cpf=...、?cnpj=...、?nome=...）。CPF 和 CNPJ 可带或不带标点符号。
• 某些查询要求“二选一”（例如 cpf 或 cnpj）；每个查询页面都会说明必填参数。
• 国际名单（OFAC、联合国、欧盟、英国、FBI、Interpol）通过 nome 查询。对于持有 CPF 的个人， listas-restritivas 会根据证件号码交叉查询 17 个国内和国际名单。
• 消息服务（sms-enviar、otp-send、otp-verify、otp-resend、sms-status）以及其他一些 查询使用带 JSON 正文的 POST 请求。
• 成功响应就是查询结果的 JSON，不带封装层。
• 如需安全地重试调用，请发送 X-Idempotency-Key：使用相同密钥会返回原始响应，不会再次扣费。

完整参考文档包含每项查询的价格、参数和响应示例： dabradata.com/docs。参考文档中的每个页面也都提供 Markdown 版本， 只需在相同地址末尾加上 .md。

各语言示例

语言	文件夹	依赖项	运行
cURL (bash)	/curl	无	./curl/cnpj.sh 00000000000191
Python	/python	pip install -r python/requirements.txt	python python/cnpj.py
Node.js	/nodejs	Node 18+，无依赖	node nodejs/cnpj.js
PHP	/php	PHP 7.4+，ext-curl	php php/cnpj.php
Go	/go	Go 1.21+，标准库	go run go/cnpj.go

使用案例

参考费用基于 2026/09/24 的公开价格表。每次调用的实际费用见 header X-Request-Cost；当前价格请查看 dabradata.com/pricing。

案例	费用	Python	Node.js	PHP	Go	cURL
查询 CNPJ（联邦税务局 + QSA）	R$ 0,43	cnpj.py	cnpj.js	cnpj.php	cnpj.go	cnpj.sh
查询 CPF（联邦税务局）	R$ 0,54	cpf.py	-	-	-	cpf.sh
个人 KYC	R$ 6,43（Python）/ R$ 6,00	kyc_pf.py	kyc_pf.js	kyc_pf.php	kyc_pf.go	-
企业 KYC	R$ 11,27	kyc_pj.py	-	-	-	-
企业尽职调查	R$ 15,52	due_diligence.py	-	-	-	-
候选人背景调查	R$ 4,75	background_check.py	-	-	-	-
供应商合规检查（CSV）	每个 CNPJ R$ 2,59	compliance_fornecedor.py	-	-	-	-
国际制裁名单查询	每个名称 R$ 3,31	-	-	-	-	sancoes.sh
带凭证的查询（CNDT）	R$ 0,54 + 仅在返回链接时加收 25%	comprovante.py	comprovante.js	comprovante.php	comprovante.go	comprovante.sh
发送 SMS 和 OTP	每个额度 R$ 0,29	-	-	-	-	sms.sh
接收 webhook（验证签名）	免费	webhook_assinatura.py	-	-	-	-

查询凭证

带证明文件的查询（例如 tst-cndt、ccd-pj、fgts-regularidade）可以返回来源签发的 文件。请通过 comprovante=1 请求（在 querystring 中，或在 POST 请求体中）：

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

响应会包含 "comprovante": ["https://arquivos.dabradata.com/comprovantes/cpv_..."]。

• 链接可公开访问（无需 X-API-Key），有效期为 7 天。
• 202：文件仍在准备中；请稍后重试（遵守 Retry-After）。
• 410：期限已过或文件已不可用；请重新查询。
• 查询价格额外增加 25%，仅当响应中返回链接时才收费 （最终费用显示在 X-Request-Cost 中）。不设置 comprovante=1 时，费用不变。
• 使用测试密钥时，响应为示例且不收费，链接也是虚构的。

以下示例会执行查询并下载 comprovante[0]，在收到 202 时等待重试，并在收到 410 时给出明确错误： curl/comprovante.sh、python/comprovante.py、 nodejs/comprovante.js、php/comprovante.php 和 go/comprovante.go。文档： dabradata.com/docs/comprovante。

响应 Headers

Header	描述
X-Request-Cost	本次调用扣除的费用，单位为 BRL
X-Balance-Remaining	调用后的剩余余额
X-RateLimit-Limit-RPM / X-RateLimit-Remaining-RPM	每分钟限制及剩余次数
X-RateLimit-Limit-RPD / X-RateLimit-Remaining-RPD	每日限制及剩余次数
X-Response-Time-Ms	处理时间
X-Example	响应为测试密钥示例时值为 true
X-Idempotent-Replay	响应来自重复的 X-Idempotency-Key 时值为 true

错误

所有错误都使用相同的封装：

{"error": {"code": "insufficient_balance", "message": "...", "hint": "...", "details": {}}}

HTTP	code	发生时机
400	invalid_parameters	缺少参数或参数格式无效
401	unauthorized	缺少密钥或密钥无效
402	insufficient_balance	余额不足；details 中包含 required_brl 和 available_brl
403	email_not_verified、kyc_required	账户尚未获准查询（电子邮件或验证尚未完成）
404	not_found	Slug 不存在，或查询的数据库中没有该文档的记录
429	rate_limit_exceeded	请求次数超限；请遵循 Retry-After 标头
5xx	不定	数据源未响应。故障绝不意味着“没有记录”

通常，错误不收费。部分数据源即使查不到该文档的记录也会收费； 这类费用会像成功响应一样通过 X-Request-Cost 返回。

余额

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

响应缓存时间为 60 秒；查询响应已在标头 X-Balance-Remaining 中包含余额。参见 dabradata.com/docs/administrativo/saldo。

Webhook

可用事件：sms.mo.received、sms.optout 和 topup.credited。每次投递都会在标头 X-Dabra-Signature: sha256=<hex> 中附带对原始请求体计算的 HMAC-SHA256 签名。为兼容旧版， 从 24/09/2026 起的 12 个月内，同一值也会通过 X-FonteData-Signature 发送：请验证新标头， 仅在必要时将旧标头用作回退。重试持续 24 小时；请按 event_id 去重。示例见 python/webhook_assinatura.py，文档见 dabradata.com/docs/webhooks。

MCP

Claude、ChatGPT、Cursor 和其他 MCP 客户端也可通过远程服务使用相同的查询：

https://app.dabradata.com/mcp

在浏览器中通过 OAuth 2.1 登录，无需粘贴密钥。价格和余额与 REST API 相同，每次执行都会 先要求确认费用，然后再扣款。参见 dabradata.com/docs/mcp。

其他产品

• 批量处理：通过控制台为整份 CSV 表格补充数据，无需编写代码。文件格式见： dabradata.com/docs/lote。
• 调查报告：按用途（信贷、招聘、尽职调查）生成个人或企业报告，包含意见和引用的数据源： dabradata.com/dossie。
• SMS 和 OTP：白标发送方、托管式 OTP，以及通过 webhook 接收的收件人回复： dabradata.com/sms。

OpenAPI 和 Postman

• 实时规范：app.dabradata.com/api/v1/openapi.json
• 实时目录，包含价格和示例：app.dabradata.com/api/v1/docs
• openapi.yaml 和 Dabra.postman_collection.json 是由 scripts/atualizar_referencia.py 根据上述 URL 生成的快照。 如有差异，以实时 URL 为准。

在 Postman 中导入集合并填写变量 API_KEY。使用测试密钥时，每个请求都会返回对应端点的示例，且不收费。

链接

• 文档：https://dabradata.com/docs
• 价格：https://dabradata.com/pricing
• 创建账户：https://app.dabradata.com/signup
• 支持：[email protected] 或 WhatsApp https://wa.me/5511991220174

贡献

请参阅 CONTRIBUTING.md。欢迎添加其他编程语言的示例。