Dabra MCP

Dabra - API の例

Dabra API の統合例です。ブラジルのデータ（CNPJ、CPF、KYC、コンプライアンス、訴訟、信用、国際制裁）に関する132件の照会と、SMS/OTP の送信を、1つのキーで利用できるプリペイド式 REST API で行います。

クイックスタート

1. app.dabradata.com/signup でアカウントを作成します。クレジットカードや月額料金は不要です。プリペイド残高から照会ごとに料金が差し引かれます。

2. ダッシュボードのキーのページには、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 は、区切り記号の有無を問わず受け付けます。
• 一部の照会では「いずれか1つ」（たとえば cpf または cnpj）が必要です。各照会のページに必須パラメーターが記載されています。
• 国際リスト（OFAC、ONU、UE、英国、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。リファレンスの各ページは、同じ URL の末尾に .md を付けると Markdown 形式でも利用できます。

言語別の例

言語	フォルダー	依存関係	実行方法
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年9月24日時点の公開料金表に基づく参考費用です。各リクエストの実際の費用は ヘッダー X-Request-Cost に記載されます。現在の料金は dabradata.com/pricing をご覧ください。

ケース	費用	Python	Node.js	PHP	Go	cURL
CNPJ の照会（Receita Federal + QSA）	R$ 0,43	cnpj.py	cnpj.js	cnpj.php	cnpj.go	cnpj.sh
CPF の照会（Receita Federal）	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 1件あたり R$ 2,59	compliance_fornecedor.py	-	-	-	-
国際的な制裁リストの照会	名前1件あたり R$ 3,31	-	-	-	-	sancoes.sh
証明書付きの照会（CNDT）	R$ 0,54 + リンクが返される場合のみ 25%	comprovante.py	comprovante.js	comprovante.php	comprovante.go	comprovante.sh
SMS と OTP の送信	クレジット1件あたり R$ 0,29	-	-	-	-	sms.sh
webhook の受信（署名の検証）	無料	webhook_assinatura.py	-	-	-	-

照会証明書

証明書を発行する照会（例：tst-cndt、ccd-pj、fgts-regularidade）では、発行元が作成した 書類を返すことができます。comprovante=1 を指定してください（クエリ文字列、または 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。

レスポンスヘッダー

ヘッダー	説明
X-Request-Cost	このリクエストで差し引かれた費用（BRL）
X-Balance-Remaining	リクエスト後の残高
X-RateLimit-Limit-RPM / X-RateLimit-Remaining-RPM	1分あたりの上限と残り回数
X-RateLimit-Limit-RPD / X-RateLimit-Remaining-RPD	1日あたりの上限と残り回数
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	存在しないスラッグ、または照会したデータベースに記録がない書類
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。各配信には、未加工の本文に対する HMAC-SHA256 署名が X-Dabra-Signature: sha256=<hex> ヘッダーで付与されます。互換性のため、同じ値が X-FonteData-Signature にも12か月間（2026年9月24日から）送信されます。新しいヘッダーを検証し、従来のヘッダーはフォールバックとしてのみ使用してください。再試行は24時間行われます。event_id で重複を排除してください。例は python/webhook_assinatura.py、ドキュメントはこちらをご覧ください。

MCP

同じ照会を、リモートサーバー経由で Claude、ChatGPT、Cursor などの MCP クライアントから利用できます。

https://app.dabradata.com/mcp

ブラウザーで OAuth 2.1 によるログインを行うため、キーを貼り付ける必要はありません。料金と残高は REST API と同じで、実行のたびに、残高から差し引く前に費用の確認を求めます。dabradata.com/docs/mcpをご覧ください。

その他の製品

• 一括処理：パネルから CSV スプレッドシート全体の情報を補完できます。コードは不要です。ファイル形式についてはこちらをご覧ください。
• レポート：目的（信用審査、採用、デューデリジェンス）に応じた個人または企業のレポートです。所見と引用元が含まれます：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をご覧ください。新しい言語でのサンプルを歓迎します。