DataBR

Name: DataBR
Author: igorpdev

远程服务

github.com/igorpdev数据与分析033 周前更新

代码仓库

关于 DataBR

DataBR 为 AI Agent 提供巴西公共数据 API，涵盖经济、企业、金融、政府、司法及环境等领域。它通过 x402 接受 Base 网络上的 USDC 按次支付，并提供 MCP 服务和 Python SDK。

主要功能

01覆盖巴西公共数据多个领域
02提供 122 个 API 端点
03支持 x402 链上按次付费
04提供 Python SDK
05支持 LLM-ready 文本格式

适用场景

01查询 Selic、通胀和市场数据
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

面向 AI Agent 的巴西公共数据 API，支持通过 x402 协议进行链上支付（Base 网络上的 USDC）。

无需注册。无需 API 密钥。按次查询付费。

文档 | Python SDK | MCP 服务 | MCP 市场 | 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 Agent 自动支付获取数据，无需注册或 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"
    }
  }
}

提供 170 多种工具，涵盖 API 的所有端点。

端点

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（+$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

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

DataBR

关于 DataBR

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

DataBR

工作原理

快速开始

curl（免费浏览）

Python SDK

MCP（Claude、Cursor 等）

端点

经济

企业

金融市场

透明度与政府

立法

法律

环境

医疗、能源、交通等

税务

综合分析

查询参数

响应格式

价格

Python SDK

可用命名空间

错误处理

测试网

数据来源

本地开发

前置要求

设置

结构

技术栈

环境变量

链接

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？