DataBR

Name: DataBR
Author: igorpdev

リモート

github.com/igorpdevデータ・分析033 週間前に更新

リポジトリ

DataBR について

DataBRは、ブラジルの経済、企業、金融、行政、司法、環境などの公開データをAIエージェント向けに提供するAPIです。Base上のUSDCによるx402の従量決済に対応し、MCPサーバーとPython SDKも備えています。

主な機能

01ブラジルの複数分野の公開データ
02122のAPIエンドポイント
03x402によるオンチェーン従量決済
04Python SDK
05LLM向けテキスト形式

活用シーン

01Selic、インフレ、金融市場データの取得
02企業コンプライアンスとデューデリジェンスの確認
03司法、立法、行政記録の検索
04環境リスクとESG情報の分析

MCP 対応

MCPサーバーはAPIの170以上のツールをMCPクライアントに公開します。接続先は https://databr.api.br/mcp です。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://databr.api.br/mcp

インストールコマンドをコピー

Claude CodeTerminalclaude mcp add --transport http databr https://databr.api.br/mcp

Cursor.cursor/mcp.json{"mcpServers":{"databr":{"type":"http","url":"https://databr.api.br/mcp"}}}Cursor で開く

VS Code.vscode/mcp.json{"servers":{"databr":{"type":"http","url":"https://databr.api.br/mcp"}}}VS Code で開く

Claude Desktopclaude_desktop_config.json{"mcpServers":{"databr":{"type":"http","url":"https://databr.api.br/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"databr":{"serverUrl":"https://databr.api.br/mcp"}}}

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

詳細

DataBR

x402プロトコル（Baseネットワーク上のUSDC）を通じたオンチェーン決済に対応した、AIエージェント向けブラジルの公開データAPIです。

登録不要。APIキー不要。クエリごとにお支払いください。

ドキュメント | Python SDK | MCP サーバー | MCP Marketplace | Smithery

仕組み

Agente IA → GET /v1/bcb/selic → 402 Payment Required
         → Paga $0.003 USDC on-chain (Base)
         → Retry com header X-PAYMENT
         → 200 OK + dados

x402プロトコルにより、AIエージェントは登録やAPIキーなしでデータの料金を自動的に支払えます。Baseネットワーク上のUSDCがあれば利用できます。

クイックスタート

curl（無料で試す）

# Health check
curl https://databr.api.br/health

# Ver requisitos de pagamento de qualquer endpoint
curl -I https://databr.api.br/v1/bcb/selic
# → 402 Payment Required + JSON com instruções x402

Python SDK

pip install databr

from databr import DataBR

client = DataBR(private_key="0x...")  # wallet com USDC na Base

# Taxa Selic
selic = client.bcb.selic()
print(selic.data)  # {"valor": "14.25", ...}

# Empresa por CNPJ
empresa = client.empresas.consultar("33000167000101")
print(empresa.data["razao_social"])

# Due diligence completa
dd = client.empresas.due_diligence("33000167000101")

# Formato LLM-ready
ipca = client.economia.ipca(format="context")
print(ipca.context)  # texto pronto para prompt

MCP（Claude、Cursorなど）

MCP Marketplaceに掲載されています。マーケットプレイスから直接インストールするか、MCP クライアントに手動で追加できます。

{
  "mcpServers": {
    "databr": {
      "url": "https://databr.api.br/mcp"
    }
  }
}

APIのすべてのエンドポイントを網羅する170以上のツールを利用できます。

エンドポイント

ドメイン別に整理された122のエンドポイントです。詳しくはdatabr.api.br/docsをご覧ください。

経済

エンドポイント	価格	説明
`GET /v1/bcb/selic`	$0.003	現行のSelic金利
`GET /v1/bcb/cambio/{moeda}`	$0.003	PTAX為替レート（USD、EURなど）
`GET /v1/bcb/credito`	$0.003	信用供給
`GET /v1/bcb/reservas`	$0.003	外貨準備高
`GET /v1/bcb/taxas-credito`	$0.003	融資種別ごとの金利
`GET /v1/bcb/pix/estatisticas`	$0.003	PIX統計
`GET /v1/bcb/focus`	$0.003	Focus市場予測
`GET /v1/economia/ipca`	$0.003	IPCAインフレ率
`GET /v1/economia/pib`	$0.003	四半期GDP
`GET /v1/economia/panorama`	$0.015	統合経済概況
`GET /v1/ipea/serie/{codigo}`	$0.003	IPEA系列データ（マクロ、社会、地域）

企業

エンドポイント	価格	説明
`GET /v1/empresas/{cnpj}`	$0.003	登記情報（連邦歳入庁）
`GET /v1/empresas/{cnpj}/compliance`	$0.007	CEIS/CNEP/CEPIMの簡易チェック
`GET /v1/empresas/{cnpj}/setor`	$0.007	セクター分析
`GET /v1/empresas/{cnpj}/perfil-completo`	$0.020	複数データを照合した完全なプロフィール
`GET /v1/empresas/{cnpj}/duediligence`	$0.075	デューデリジェンスの自動化
`GET /v1/compliance/{cnpj}`	$0.010	包括的コンプライアンス（CGU + CNJ）
`GET /v1/credito/score/{cnpj}`	$0.010	推定信用スコア

金融市場

エンドポイント	価格	説明
`GET /v1/mercado/acoes/{ticker}`	$0.005	株価（B3）
`GET /v1/mercado/indices/ibovespa`	$0.005	Ibovespa指数
`GET /v1/mercado/fundos/{cnpj}`	$0.010	ファンドの詳細（CVM）
`GET /v1/mercado/fundos/{cnpj}/cotas`	$0.005	ファンドの持分口数
`GET /v1/mercado/fundos/{cnpj}/analise`	$0.010	ファンド分析
`GET /v1/mercado/fatos-relevantes`	$0.005	CVMの重要事実
`GET /v1/mercado/{cnae}/competicao`	$0.030	競争分析
`GET /v1/tesouro/titulos`	$0.003	Tesouro Direto
`GET /v1/bndes/{cnpj}/operacoes`	$0.005	BNDESの融資業務

透明性と政府

Endpoint	価格	説明
`GET /v1/transparencia/licitacoes`	$0.003	PNCP の入札
`GET /v1/transparencia/contratos`	$0.003	連邦政府の契約
`GET /v1/transparencia/servidores`	$0.003	公務員
`GET /v1/transparencia/pgfn`	$0.003	CNPJ 別の PGFN の滞納債務
`GET /v1/transparencia/pep`	$0.003	政治的に重要な人物（氏名別）
`GET /v1/transparencia/leniencias`	$0.003	CNPJ 別の司法取引
`GET /v1/transparencia/renuncias`	$0.003	年度別の税収放棄
`GET /v1/tcu/acordaos`	$0.003	TCU の判決
`GET /v1/tcu/certidao/{cnpj}`	$0.003	TCU の証明書
`GET /v1/orcamento/despesas`	$0.003	予算執行
`GET /v1/dou/busca`	$0.007	官報の検索

立法

Endpoint	価格	説明
`GET /v1/legislativo/deputados`	$0.003	連邦下院議員
`GET /v1/legislativo/senado/senadores`	$0.003	上院議員
`GET /v1/legislativo/proposicoes`	$0.003	法案
`GET /v1/legislativo/votacoes`	$0.003	投票
`GET /v1/eleicoes/candidatos`	$0.003	TSE の候補者
`GET /v1/eleicoes/filiados`	$0.003	州別の政党所属者
`GET /v1/eleicoes/compliance/{cpf_cnpj}`	$0.007	選挙コンプライアンス

法務

Endpoint	価格	説明
`GET /v1/judicial/stf`	$0.010	STF の判決
`GET /v1/judicial/stj`	$0.010	STJ の判決
`GET /v1/judicial/processos/{doc}`	$0.015	CPF/CNPJ 別の訴訟
`GET /v1/litigio/{cnpj}/risco`	$0.030	訴訟リスク

環境

Endpoint	価格	説明
`GET /v1/ambiental/desmatamento`	$0.005	DETER（INPE）の警報
`GET /v1/ambiental/prodes`	$0.005	PRODES のモニタリング
`GET /v1/ambiental/embargos`	$0.005	IBAMA の事業停止措置
`GET /v1/ambiental/uso-solo`	$0.005	MapBiomas の土地被覆
`GET /v1/ambiental/risco/{municipio}`	$0.007	環境リスク
`GET /v1/ambiental/empresa/{cnpj}/esg`	$0.030	ESG 分析

医療、エネルギー、輸送など

Endpoint	価格	説明
`GET /v1/saude/medicamentos/{registro}`	$0.003	ANVISA の医薬品
`GET /v1/saude/planos`	$0.003	ANS の医療保険プラン
`GET /v1/energia/geracao`	$0.005	エネルギー発電（ONS）
`GET /v1/energia/tarifas`	$0.003	ANEEL の料金
`GET /v1/energia/combustiveis`	$0.003	ANP の価格
`GET /v1/transporte/aeronaves`	$0.005	ANAC の航空機
`GET /v1/transporte/acidentes`	$0.005	PRF の事故
`GET /v1/comercio/exportacoes`	$0.005	輸出（ComexStat）
`GET /v1/educacao/censo-escolar`	$0.005	INEP の学校調査
`GET /v1/emprego/rais`	$0.005	RAIS（正規雇用）
`GET /v1/emprego/caged`	$0.005	CAGED（採用／解雇）

税務

Endpoint	価格	説明
`GET /v1/tributario/ncm/{codigo}`	$0.003	NCM/NBS 別の税負担（IBPT）
`GET /v1/tributario/icms/{uf}`	$0.003	州内の ICMS 税率
`GET /v1/tributario/icms`	$0.003	ICMS の全表（27 州）または州間税率

複合分析

Endpoint	価格	説明
`GET /v1/rede/{cnpj}/influencia`	$0.050	ネットワークと影響力の分析
`POST /v1/carteira/risco`	$0.150	ポートフォリオリスク（複数の CNPJ）

クエリパラメーター

すべてのエンドポイントで以下を使用できます。

パラメーター	例	説明
`format`	`?format=context`	JSON の代わりに LLM 対応テキスト（+$0.002）
`fields`	`?fields=valor,data`	フィールドの投影
`since`	`?since=2026-01-01`	指定日以降で絞り込み
`until`	`?until=2026-02-01`	指定日までで絞り込み
`limit`	`?limit=10`	レコード数の上限
`offset`	`?offset=20`	ページネーションのオフセット

レスポンス形式

{
  "source": "bcb_sgs",
  "updated_at": "2026-02-21T10:00:00Z",
  "cached": true,
  "cache_age_seconds": 3600,
  "cost_usdc": "0.003",
  "data": {
    "valor": "14.25",
    "data": "2026-02-21"
  }
}

料金

区分	価格（USDC）	例
基本クエリ	$0.003	BCB、IBGE、企業、立法、税務
標準クエリ	$0.005	B3 株式、CVM、貿易
高度なクエリ	$0.007	企業コンプライアンス、DOU、環境リスク
プレミアム	$0.010	完全なコンプライアンス、ファンド、STF／STJ の判決
クロス分析	$0.015–$0.030	概要、ESG、訴訟、競争
詳細分析	$0.050–$0.150	影響力ネットワーク、デューデリジェンス、ポートフォリオ
コンテキスト形式	+$0.002	すべてのエンドポイントに追加

レート制限：IP あたり 100 req/min | x402 ウォレットあたり 500 req/min。

Python SDK

pip install databr

利用可能な名前空間

名前空間	例	メソッド
`bcb`	`client.bcb.selic()`	selic, cambio, focus, credito, reservas, taxas_credito, pix
`empresas`	`client.empresas.consultar(cnpj)`	consultar, compliance, perfil_completo, due_diligence
`economia`	`client.economia.ipca()`	ipca, pib, panorama
`mercado`	`client.mercado.acoes("PETR4")`	acoes, fundos, cotas, fatos, indices, competicao
`compliance`	`client.compliance.verificar(cnpj)`	verificar, ceis, cnep, cepim
`judicial`	`client.judicial.processos(doc)`	processos, stf, stj, litigio
`legislativo`	`client.legislativo.deputados()`	deputados, senadores, proposicoes, votacoes
`ambiental`	`client.ambiental.desmatamento()`	desmatamento, prodes, embargos, uso_solo, esg
`transparencia`	`client.transparencia.licitacoes()`	licitacoes, contratos, servidores, orcamento
`saude`	`client.saude.medicamentos(reg)`	medicamentos, operadoras, estabelecimentos
`energia`	`client.energia.tarifas()`	tarifas, geracao, carga, combustiveis
`transporte`	`client.transporte.aeronaves()`	aeronaves, transportadores, acidentes
`comercio`	`client.comercio.exportacoes()`	exportacoes, importacoes
`emprego`	`client.emprego.rais()`	rais, caged
`tributario`	`client.tributario.ncm("22030000", uf="SP")`	ncm, icms

エラー処理

from databr import DataBR, NotFoundError, PaymentError, RateLimitError

try:
    empresa = client.empresas.consultar("00000000000000")
except NotFoundError:
    print("CNPJ não encontrado")
except PaymentError:
    print("Pagamento falhou — verificar saldo USDC")
except RateLimitError as e:
    print(f"Rate limit — retry em {e.retry_after}s")

テストネット

client = DataBR(private_key="0x...", network="testnet")  # Base Sepolia, USDC de teste

データソース

自動収集器42個＋オンデマンド8個で、以下をカバーしています。

ソース	機関	更新頻度
Selic、PTAX、信用、準備金、PIX、Focus	BCB	日次／週次
IPCA、GDP、人口、調査	IBGE	日次／月次
相場、Ibovespa	B3	日次（営業日）
ファンド、重要事実、持分	CVM	日次
候補者、資産、寄付、党員	TSE	年次／オンデマンド
PNCP入札	Portal da Transparência	日次
判決、証明書、資格停止者	TCU	週次
下院議員、上院議員、法案	Câmara/Senado	日次
RREO、RGF、Tesouro Direto	Tesouro Nacional	日次／月次
輸出、輸入	ComexStat	月次
料金、発電、負荷	ANEEL/ONS	週次／日次
医薬品	ANVISA	月次
運営事業者、プラン	ANS	週次
DETER、PRODES、MapBiomas	INPE	日次／月次
禁止措置	IBAMA	週次
航空機、運送事業者、事故	ANAC/ANTT/PRF	週次／月次
学校国勢調査	INEP	半年ごと
RAIS、CAGED	MTE (FTP)	月次／年次
STF、STJの判決	最高裁判所	日次
燃料	ANP	週次
マクロ系列	IPEA	日次
官報	Querido Diário	オンデマンド
CNPJ	minhareceita.org	オンデマンド
CEIS/CNEPコンプライアンス	CGU	オンデマンド
司法手続き	DataJud CNJ	オンデマンド
NCM/NBS税負担	IBPT	オンデマンド
レニエンシー協定、PEP、税免除、PGFN	CGU/Portal da Transparência	オンデマンド
信用業務	BNDES (CKAN)	オンデマンド
ICMS税率（27州）	CONFAZ/SEFAZ	静的（2026年）

ローカル開発

前提条件

Go 1.24+
Docker（PostgreSQL＋Redis）

セットアップ

git clone https://github.com/igorpdev/databr.git
cd databr

# Subir PostgreSQL e Redis
docker-compose up -d

# Configurar variáveis
cp .env.example .env
# Editar .env com suas configurações

# Rodar API
go run cmd/api/main.go

# Rodar coletores (em outro terminal)
go run cmd/collector/main.go

# Testes
go test ./...

APIは http://localhost:8080 で起動します。WALLET_ADDRESS が設定されていない場合、エンドポイント /v1/* は支払いなしで動作します（開発モード）。

構成

databr/
├── cmd/
│   ├── api/              # Entrypoint REST API + MCP
│   └── collector/        # Scheduler de coletores
├── internal/
│   ├── handlers/         # 30+ handlers HTTP (122 endpoints)
│   ├── collectors/       # 23 pacotes de coletores (50 fontes)
│   ├── repositories/     # PostgreSQL (pgx/v5)
│   ├── cache/            # Redis + cache em memória
│   ├── x402/             # Middleware de pagamento + pricing
│   ├── mcp/              # MCP Server (170+ tools)
│   ├── domain/           # Entidades e interfaces
│   ├── metrics/          # Prometheus
│   └── logging/          # Structured logging (slog)
├── sdk/python/           # Python SDK (PyPI: databr)
├── docs/
│   ├── openapi.yaml      # Especificação OpenAPI 3.0
│   └── landing.html      # Landing page
├── migrations/           # Schema PostgreSQL
├── Dockerfile            # API (multi-stage, ~23MB)
├── Dockerfile.collector  # Coletores
└── docker-compose.yml    # Dev: PostgreSQL 16 + Redis 7

技術スタック

レイヤー	テクノロジー
バックエンド	Go 1.24、Chi Router
データベース	PostgreSQL 16 (pgx/v5)
キャッシュ	Redis（本番環境ではUpstash）
支払い	x402 protocol、USDC、Base network
デプロイ	Railway
メトリクス	Prometheus
MCP	mcp-go (Mark3Labs)
SDK	Python (PyPI)

環境変数

# Obrigatórias
DATABASE_URL=postgres://databr:databr@localhost:5432/databr
REDIS_URL=redis://localhost:6379

# x402 (testnet)
WALLET_ADDRESS=0x...
X402_NETWORK=base-sepolia
X402_FACILITATOR_URL=https://facilitator.x402.rs

# x402 (mainnet)
# X402_NETWORK=base
# X402_FACILITATOR_URL=https://api.cdp.coinbase.com/platform/v2/x402
# CDP_KEY_ID=...
# CDP_KEY_SECRET=...

# APIs externas (opcionais)
TRANSPARENCIA_API_KEY=    # Portal da Transparência (CGU)
DATAJUD_API_KEY=          # DataJud (CNJ)
MINHARECEITA_URL=https://minhareceita.org

リンク

API: https://databr.api.br
ドキュメント（Scalar）: https://databr.api.br/docs
OpenAPI仕様: https://databr.api.br/openapi.yaml
MCPディスカバリー: https://databr.api.br/.well-known/mcp.json
x402ディスカバリー: https://databr.api.br/.well-known/x402
Python SDK: https://pypi.org/project/databr/
ヘルスチェック: https://databr.api.br/health

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: igorpdev
バージョン: 1.0.0
トランスポート: streamable-http
掲載日: 2026年2月25日
最終更新: 33 週間前
公式 Registry: io.github.igorpdev/databr

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

DataBR

DataBR について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

DataBR

仕組み

クイックスタート

curl（無料で試す）

Python SDK

MCP（Claude、Cursorなど）

エンドポイント

経済

企業

金融市場

透明性と政府

立法

法務

環境

医療、エネルギー、輸送など

税務

複合分析

クエリパラメーター

レスポンス形式

料金

Python SDK

利用可能な名前空間

エラー処理

テストネット

データソース

ローカル開発

前提条件

セットアップ

構成

技術スタック

環境変数

リンク

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？