DataBR — API de Dados Públicos Brasileiros

io.github.igorpdev由 GitHub 帳號 igorpdev 發布v1.0.0更新於 Oct 24, 2026

Brazilian public data API for AI agents. BCB, IBGE, CVM, B3, compliance. x402 payments on Base.

已驗證Streamable HTTP可網頁執行金融資料與分析商業與電商

概覽

AI 產生的概覽

遠端 MCP 伺服器，提供巴西公開資料（央行、IBGE、企業、市場、政府透明度等），依查詢以 USDC 付費。

可以做什麼
查詢 BCB、IBGE 與 IPEA 的經濟指標，例如 Selic 利率、PTAX 匯率、IPCA 通膨、GDP 與 Focus 預期，以及綜合經濟概況與 IPEA 序列。依 CNPJ 查詢企業：登記資料、法遵檢查、產業分析、信用評分、盡職調查，以及網絡或投資組合風險分析。取得金融市場資料：B3 股票行情、Ibovespa 指數、CVM 基金詳情與單位數、重大訊息、Tesouro Direto 與 BNDES 信貸業務。檢索政府透明度與立法紀錄：招標、合約、公務員、PEP 名單、TCU 裁決、預算執行、官方公報、眾議員、參議員、法案、投票與 TSE 候選人。存取司法、稅務、農業、衛生、能源、交通、就業、教育與環境資料。
適用情境
當助理需要巴西公部門或企業資料——總體經濟指標、CNPJ 盡職調查、市場行情、透明度或立法紀錄——且使用者願意以 USDC 支付小額單次費用、不想註冊 API 金鑰時適用。
執行需求
遠端端點 databr.api.br/mcp；無需註冊或 API 金鑰。每次查詢須透過 x402 協定在 Base 網路上以 USDC 鏈上付款，並附上 X-PAYMENT 標頭，因此需要已儲值的錢包。依 IP 與依錢包皆有限流。
安裝前請注意
每次資料呼叫都要付費（每查詢約 0.003 至 0.150 USDC，context 格式另加 0.002），助理可能自動花費資金。付款需要 Base 網路上持有 USDC 的錢包；Python SDK 需傳入私鑰，屬敏感機密。查詢會將企業或個人的 CNPJ、CPF 或姓名送往第三方 API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 DataBR — API de Dados Públicos Brasileiros，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.igorpdev%2Fdatabr/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "databr-api-de-dados-p-blicos-brasileiros": {
      "type": "http",
      "url": "https://databr.api.br/mcp"
    }
  }
}

README

DataBR

API de dados públicos brasileiros para agentes de IA, com pagamento on-chain via protocolo x402 (USDC na rede Base).

Sem cadastro. Sem API key. Pague por consulta.

Documentação | Python SDK | MCP Server | MCP Marketplace | Smithery

Como funciona

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

O protocolo x402 permite que agentes de IA paguem por dados automaticamente, sem cadastro ou chave de API. Basta ter USDC na rede Base.

Início rápido

curl (explorar sem pagar)

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

Python SDK

bash
pip install databr
python
from databr import DataBR
client = DataBR(private_key="0x...")  # wallet com USDC na Base
# Taxa Selicselic = client.bcb.selic()print(selic.data)  # {"valor": "14.25", ...}
# Empresa por CNPJempresa = client.empresas.consultar("33000167000101")print(empresa.data["razao_social"])
# Due diligence completadd = client.empresas.due_diligence("33000167000101")
# Formato LLM-readyipca = client.economia.ipca(format="context")print(ipca.context)  # texto pronto para prompt

MCP (Claude, Cursor, etc.)

Listado no MCP Marketplace — instale direto pelo marketplace ou adicione manualmente ao seu MCP client:

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

170+ ferramentas disponíveis cobrindo todos os endpoints da API.

Endpoints

122 endpoints organizados por domínio. Documentação completa em databr.api.br/docs.

Economia

EndpointPreçoDescrição
GET /v1/bcb/selic$0.003Taxa Selic vigente
GET /v1/bcb/cambio/{moeda}$0.003Câmbio PTAX (USD, EUR, etc.)
GET /v1/bcb/credito$0.003Oferta de crédito
GET /v1/bcb/reservas$0.003Reservas internacionais
GET /v1/bcb/taxas-credito$0.003Taxas de juros por modalidade
GET /v1/bcb/pix/estatisticas$0.003Estatísticas PIX
GET /v1/bcb/focus$0.003Expectativas Focus (mercado)
GET /v1/economia/ipca$0.003Inflação IPCA
GET /v1/economia/pib$0.003PIB trimestral
GET /v1/economia/panorama$0.015Panorama econômico consolidado
GET /v1/ipea/serie/{codigo}$0.003Séries IPEA (macro, social, regional)

Empresas

EndpointPreçoDescrição
GET /v1/empresas/{cnpj}$0.003Dados cadastrais (Receita Federal)
GET /v1/empresas/{cnpj}/compliance$0.007Check rápido CEIS/CNEP/CEPIM
GET /v1/empresas/{cnpj}/setor$0.007Análise setorial
GET /v1/empresas/{cnpj}/perfil-completo$0.020Perfil completo com cruzamentos
GET /v1/empresas/{cnpj}/duediligence$0.075Due diligence automatizada
GET /v1/compliance/{cnpj}$0.010Compliance completo (CGU + CNJ)
GET /v1/credito/score/{cnpj}$0.010Score de crédito estimado

Mercado financeiro

EndpointPreçoDescrição
GET /v1/mercado/acoes/{ticker}$0.005Cotação de ações (B3)
GET /v1/mercado/indices/ibovespa$0.005Índice Ibovespa
GET /v1/mercado/fundos/{cnpj}$0.010Detalhes de fundo (CVM)
GET /v1/mercado/fundos/{cnpj}/cotas$0.005Cotas de fundo
GET /v1/mercado/fundos/{cnpj}/analise$0.010Análise de fundo
GET /v1/mercado/fatos-relevantes$0.005Fatos relevantes CVM
GET /v1/mercado/{cnae}/competicao$0.030Análise de competição
GET /v1/tesouro/titulos$0.003Tesouro Direto
GET /v1/bndes/{cnpj}/operacoes$0.005Operações de crédito BNDES

Transparência e governo

EndpointPreçoDescrição
GET /v1/transparencia/licitacoes$0.003Licitações PNCP
GET /v1/transparencia/contratos$0.003Contratos federais
GET /v1/transparencia/servidores$0.003Servidores públicos
GET /v1/transparencia/pgfn$0.003Dívida ativa PGFN por CNPJ
GET /v1/transparencia/pep$0.003Pessoas Expostas Politicamente (por nome)
GET /v1/transparencia/leniencias$0.003Acordos de leniência por CNPJ
GET /v1/transparencia/renuncias$0.003Renúncias fiscais por exercício
GET /v1/tcu/acordaos$0.003Acórdãos do TCU
GET /v1/tcu/certidao/{cnpj}$0.003Certidão TCU
GET /v1/orcamento/despesas$0.003Execução orçamentária
GET /v1/dou/busca$0.007Busca em diários oficiais

Legislativo

EndpointPreçoDescrição
GET /v1/legislativo/deputados$0.003Deputados federais
GET /v1/legislativo/senado/senadores$0.003Senadores
GET /v1/legislativo/proposicoes$0.003Projetos de lei
GET /v1/legislativo/votacoes$0.003Votações
GET /v1/eleicoes/candidatos$0.003Candidatos TSE
GET /v1/eleicoes/filiados$0.003Filiados partidários por UF
GET /v1/eleicoes/compliance/{cpf_cnpj}$0.007Compliance eleitoral

Jurídico

EndpointPreçoDescrição
GET /v1/judicial/stf$0.010Decisões do STF
GET /v1/judicial/stj$0.010Decisões do STJ
GET /v1/judicial/processos/{doc}$0.015Processos por CPF/CNPJ
GET /v1/litigio/{cnpj}/risco$0.030Risco litigioso

Ambiental

EndpointPreçoDescrição
GET /v1/ambiental/desmatamento$0.005Alertas DETER (INPE)
GET /v1/ambiental/prodes$0.005Monitoramento PRODES
GET /v1/ambiental/embargos$0.005Embargos IBAMA
GET /v1/ambiental/uso-solo$0.005Cobertura MapBiomas
GET /v1/ambiental/risco/{municipio}$0.007Risco ambiental
GET /v1/ambiental/empresa/{cnpj}/esg$0.030Análise ESG

Saúde, energia, transporte e mais

EndpointPreçoDescrição
GET /v1/saude/medicamentos/{registro}$0.003Medicamentos ANVISA
GET /v1/saude/planos$0.003Planos ANS
GET /v1/energia/geracao$0.005Geração de energia (ONS)
GET /v1/energia/tarifas$0.003Tarifas ANEEL
GET /v1/energia/combustiveis$0.003Preços ANP
GET /v1/transporte/aeronaves$0.005Aeronaves ANAC
GET /v1/transporte/acidentes$0.005Acidentes PRF
GET /v1/comercio/exportacoes$0.005Exportações (ComexStat)
GET /v1/educacao/censo-escolar$0.005Censo escolar INEP
GET /v1/emprego/rais$0.005RAIS (emprego formal)
GET /v1/emprego/caged$0.005CAGED (admissões/demissões)

Tributário

EndpointPreçoDescrição
GET /v1/tributario/ncm/{codigo}$0.003Carga tributária por NCM/NBS (IBPT)
GET /v1/tributario/icms/{uf}$0.003Alíquota ICMS interna de um estado
GET /v1/tributario/icms$0.003Tabela ICMS completa (27 UFs) ou interestadual

Análises compostas

EndpointPreçoDescrição
GET /v1/rede/{cnpj}/influencia$0.050Análise de rede e influência
POST /v1/carteira/risco$0.150Risco de carteira (múltiplos CNPJs)

Query parameters

Todos os endpoints aceitam:

ParâmetroExemploDescrição
format?format=contextTexto LLM-ready em vez de JSON (+$0.002)
fields?fields=valor,dataProjeção de campos
since?since=2026-01-01Filtrar a partir de data
until?until=2026-02-01Filtrar até data
limit?limit=10Limite de registros
offset?offset=20Offset para paginação

Formato de resposta

json
{  "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"  }}

Preços

FaixaPreço (USDC)Exemplos
Consultas básicas$0.003BCB, IBGE, empresas, legislativo, tributário
Consultas padrão$0.005Ações B3, CVM, comércio exterior
Consultas avançadas$0.007Compliance empresa, DOU, risco ambiental
Premium$0.010Compliance completo, fundos, decisões STF/STJ
Análises cruzadas$0.015–$0.030Panorama, ESG, litígio, competição
Análises profundas$0.050–$0.150Rede de influência, due diligence, carteira
Formato contexto+$0.002Adicional sobre qualquer endpoint

Rate limits: 100 req/min por IP | 500 req/min por wallet x402.

Python SDK

bash
pip install databr

Namespaces disponíveis

NamespaceExemploMétodos
bcbclient.bcb.selic()selic, cambio, focus, credito, reservas, taxas_credito, pix
empresasclient.empresas.consultar(cnpj)consultar, compliance, perfil_completo, due_diligence
economiaclient.economia.ipca()ipca, pib, panorama
mercadoclient.mercado.acoes("PETR4")acoes, fundos, cotas, fatos, indices, competicao
complianceclient.compliance.verificar(cnpj)verificar, ceis, cnep, cepim
judicialclient.judicial.processos(doc)processos, stf, stj, litigio
legislativoclient.legislativo.deputados()deputados, senadores, proposicoes, votacoes
ambientalclient.ambiental.desmatamento()desmatamento, prodes, embargos, uso_solo, esg
transparenciaclient.transparencia.licitacoes()licitacoes, contratos, servidores, orcamento
saudeclient.saude.medicamentos(reg)medicamentos, operadoras, estabelecimentos
energiaclient.energia.tarifas()tarifas, geracao, carga, combustiveis
transporteclient.transporte.aeronaves()aeronaves, transportadores, acidentes
comercioclient.comercio.exportacoes()exportacoes, importacoes
empregoclient.emprego.rais()rais, caged
tributarioclient.tributario.ncm("22030000", uf="SP")ncm, icms

Tratamento de erros

python
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")

Testnet

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

Fontes de dados

42 coletores automáticos + 8 on-demand, cobrindo:

FonteÓrgãoAtualização
Selic, PTAX, crédito, reservas, PIX, FocusBCBDiária/semanal
IPCA, PIB, população, pesquisasIBGEDiária/mensal
Cotações, IbovespaB3Diária (dias úteis)
Fundos, fatos relevantes, cotasCVMDiária
Candidatos, bens, doações, filiadosTSEAnual / On-demand
Licitações PNCPPortal da TransparênciaDiária
Acórdãos, certidões, inabilitadosTCUSemanal
Deputados, senadores, proposiçõesCâmara/SenadoDiária
RREO, RGF, Tesouro DiretoTesouro NacionalDiária/mensal
Exportações, importaçõesComexStatMensal
Tarifas, geração, cargaANEEL/ONSSemanal/diária
MedicamentosANVISAMensal
Operadoras, planosANSSemanal
DETER, PRODES, MapBiomasINPEDiária/mensal
EmbargosIBAMASemanal
Aeronaves, transportadores, acidentesANAC/ANTT/PRFSemanal/mensal
Censo escolarINEPSemestral
RAIS, CAGEDMTE (FTP)Mensal/anual
Decisões STF, STJTribunais superioresDiária
CombustíveisANPSemanal
Séries macroIPEADiária
Diários oficiaisQuerido DiárioOn-demand
CNPJminhareceita.orgOn-demand
Compliance CEIS/CNEPCGUOn-demand
Processos judiciaisDataJud CNJOn-demand
Carga tributária NCM/NBSIBPTOn-demand
Acordos leniência, PEP, renúncias, PGFNCGU/Portal da TransparênciaOn-demand
Operações de créditoBNDES (CKAN)On-demand
Alíquotas ICMS (27 UFs)CONFAZ/SEFAZEstático (2026)

Desenvolvimento local

Pré-requisitos

  • Go 1.24+
  • Docker (PostgreSQL + Redis)

Setup

bash
git clone https://github.com/igorpdev/databr.gitcd databr
# Subir PostgreSQL e Redisdocker-compose up -d
# Configurar variáveiscp .env.example .env# Editar .env com suas configurações
# Rodar APIgo run cmd/api/main.go
# Rodar coletores (em outro terminal)go run cmd/collector/main.go
# Testesgo test ./...

A API sobe em http://localhost:8080. Sem WALLET_ADDRESS configurado, os endpoints /v1/* funcionam sem pagamento (modo dev).

Estrutura

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

Stack

CamadaTecnologia
BackendGo 1.24, Chi Router
BancoPostgreSQL 16 (pgx/v5)
CacheRedis (Upstash em produção)
Pagamentosx402 protocol, USDC, Base network
DeployRailway
MétricasPrometheus
MCPmcp-go (Mark3Labs)
SDKPython (PyPI)

Variáveis de ambiente

bash
# ObrigatóriasDATABASE_URL=postgres://databr:databr@localhost:5432/databrREDIS_URL=redis://localhost:6379
# x402 (testnet)WALLET_ADDRESS=0x...X402_NETWORK=base-sepoliaX402_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

Links

Licença

MIT

來源：README.md，提交 608ea5c

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式必需10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。