{
  "markdown": "# DataBR\n\nAPI de dados públicos brasileiros para agentes de IA, com pagamento on-chain via protocolo [x402](https://x402.org) (USDC na rede Base).\n\n**Sem cadastro. Sem API key. Pague por consulta.**\n\n[Documentação](https://databr.api.br/docs) | [Python SDK](https://pypi.org/project/databr/) | [MCP Server](https://databr.api.br/.well-known/mcp.json) | [MCP Marketplace](https://mcp-marketplace.io/server/io-github-igorpdev-databr) | [Smithery](https://smithery.ai/servers/databr/databr)\n\n---\n\n## Como funciona\n\n```\nAgente IA → GET /v1/bcb/selic → 402 Payment Required\n         → Paga $0.003 USDC on-chain (Base)\n         → Retry com header X-PAYMENT\n         → 200 OK + dados\n```\n\nO protocolo x402 permite que agentes de IA paguem por dados automaticamente, sem cadastro ou chave de API. Basta ter USDC na rede Base.\n\n---\n\n## Início rápido\n\n### curl (explorar sem pagar)\n\n```bash\n# Health check\ncurl https://databr.api.br/health\n\n# Ver requisitos de pagamento de qualquer endpoint\ncurl -I https://databr.api.br/v1/bcb/selic\n# → 402 Payment Required + JSON com instruções x402\n```\n\n### Python SDK\n\n```bash\npip install databr\n```\n\n```python\nfrom databr import DataBR\n\nclient = DataBR(private_key=\"0x...\")  # wallet com USDC na Base\n\n# Taxa Selic\nselic = client.bcb.selic()\nprint(selic.data)  # {\"valor\": \"14.25\", ...}\n\n# Empresa por CNPJ\nempresa = client.empresas.consultar(\"33000167000101\")\nprint(empresa.data[\"razao_social\"])\n\n# Due diligence completa\ndd = client.empresas.due_diligence(\"33000167000101\")\n\n# Formato LLM-ready\nipca = client.economia.ipca(format=\"context\")\nprint(ipca.context)  # texto pronto para prompt\n```\n\n### MCP (Claude, Cursor, etc.)\n\nListado no [MCP Marketplace](https://mcp-marketplace.io/server/io-github-igorpdev-databr) — instale direto pelo marketplace ou adicione manualmente ao seu MCP client:\n\n```json\n{\n  \"mcpServers\": {\n    \"databr\": {\n      \"url\": \"https://databr.api.br/mcp\"\n    }\n  }\n}\n```\n\n170+ ferramentas disponíveis cobrindo todos os endpoints da API.\n\n---\n\n## Endpoints\n\n122 endpoints organizados por domínio. Documentação completa em [databr.api.br/docs](https://databr.api.br/docs).\n\n### Economia\n\n| Endpoint | Preço | Descrição |\n|----------|-------|-----------|\n| `GET /v1/bcb/selic` | $0.003 | Taxa Selic vigente |\n| `GET /v1/bcb/cambio/{moeda}` | $0.003 | Câmbio PTAX (USD, EUR, etc.) |\n| `GET /v1/bcb/credito` | $0.003 | Oferta de crédito |\n| `GET /v1/bcb/reservas` | $0.003 | Reservas internacionais |\n| `GET /v1/bcb/taxas-credito` | $0.003 | Taxas de juros por modalidade |\n| `GET /v1/bcb/pix/estatisticas` | $0.003 | Estatísticas PIX |\n| `GET /v1/bcb/focus` | $0.003 | Expectativas Focus (mercado) |\n| `GET /v1/economia/ipca` | $0.003 | Inflação IPCA |\n| `GET /v1/economia/pib` | $0.003 | PIB trimestral |\n| `GET /v1/economia/panorama` | $0.015 | Panorama econômico consolidado |\n| `GET /v1/ipea/serie/{codigo}` | $0.003 | Séries IPEA (macro, social, regional) |\n\n### Empresas\n\n| Endpoint | Preço | Descrição |\n|----------|-------|-----------|\n| `GET /v1/empresas/{cnpj}` | $0.003 | Dados cadastrais (Receita Federal) |\n| `GET /v1/empresas/{cnpj}/compliance` | $0.007 | Check rápido CEIS/CNEP/CEPIM |\n| `GET /v1/empresas/{cnpj}/setor` | $0.007 | Análise setorial |\n| `GET /v1/empresas/{cnpj}/perfil-completo` | $0.020 | Perfil completo com cruzamentos |\n| `GET /v1/empresas/{cnpj}/duediligence` | $0.075 | Due diligence automatizada |\n| `GET /v1/compliance/{cnpj}` | $0.010 | Compliance completo (CGU + CNJ) |\n| `GET /v1/credito/score/{cnpj}` | $0.010 | Score de crédito estimado |\n\n### Mercado financeiro\n\n| Endpoint | Preço | Descrição |\n|----------|-------|-----------|\n| `GET /v1/mercado/acoes/{ticker}` | $0.005 | Cotação de ações (B3) |\n| `GET /v1/mercado/indices/ibovespa` | $0.005 | Índice Ibovespa |\n| `GET /v1/mercado/fundos/{cnpj}` | $0.010 | Detalhes de fundo (CVM) |\n| `GET /v1/mercado/fundos/{cnpj}/cotas` | $0.005 | Cotas de fundo |\n| `GET /v1/mercado/fundos/{cnpj}/analise` | $0.010 | Análise de fundo |\n| `GET /v1/mercado/fatos-relevantes` | $0.005 | Fatos relevantes CVM |\n| `GET /v1/mercado/{cnae}/competicao` | $0.030 | Análise de competição |\n| `GET /v1/tesouro/titulos` | $0.003 | Tesouro Direto |\n| `GET /v1/bndes/{cnpj}/operacoes` | $0.005 | Operações de crédito BNDES |\n\n### Transparência e governo\n\n| Endpoint | Preço | Descrição |\n|----------|-------|-----------|\n| `GET /v1/transparencia/licitacoes` | $0.003 | Licitações PNCP |\n| `GET /v1/transparencia/contratos` | $0.003 | Contratos federais |\n| `GET /v1/transparencia/servidores` | $0.003 | Servidores públicos |\n| `GET /v1/transparencia/pgfn` | $0.003 | Dívida ativa PGFN por CNPJ |\n| `GET /v1/transparencia/pep` | $0.003 | Pessoas Expostas Politicamente (por nome) |\n| `GET /v1/transparencia/leniencias` | $0.003 | Acordos de leniência por CNPJ |\n| `GET /v1/transparencia/renuncias` | $0.003 | Renúncias fiscais por exercício |\n| `GET /v1/tcu/acordaos` | $0.003 | Acórdãos do TCU |\n| `GET /v1/tcu/certidao/{cnpj}` | $0.003 | Certidão TCU |\n| `GET /v1/orcamento/despesas` | $0.003 | Execução orçamentária |\n| `GET /v1/dou/busca` | $0.007 | Busca em diários oficiais |\n\n### Legislativo\n\n| Endpoint | Preço | Descrição |\n|----------|-------|-----------|\n| `GET /v1/legislativo/deputados` | $0.003 | Deputados federais |\n| `GET /v1/legislativo/senado/senadores` | $0.003 | Senadores |\n| `GET /v1/legislativo/proposicoes` | $0.003 | Projetos de lei |\n| `GET /v1/legislativo/votacoes` | $0.003 | Votações |\n| `GET /v1/eleicoes/candidatos` | $0.003 | Candidatos TSE |\n| `GET /v1/eleicoes/filiados` | $0.003 | Filiados partidários por UF |\n| `GET /v1/eleicoes/compliance/{cpf_cnpj}` | $0.007 | Compliance eleitoral |\n\n### Jurídico\n\n| Endpoint | Preço | Descrição |\n|----------|-------|-----------|\n| `GET /v1/judicial/stf` | $0.010 | Decisões do STF |\n| `GET /v1/judicial/stj` | $0.010 | Decisões do STJ |\n| `GET /v1/judicial/processos/{doc}` | $0.015 | Processos por CPF/CNPJ |\n| `GET /v1/litigio/{cnpj}/risco` | $0.030 | Risco litigioso |\n\n### Ambiental\n\n| Endpoint | Preço | Descrição |\n|----------|-------|-----------|\n| `GET /v1/ambiental/desmatamento` | $0.005 | Alertas DETER (INPE) |\n| `GET /v1/ambiental/prodes` | $0.005 | Monitoramento PRODES |\n| `GET /v1/ambiental/embargos` | $0.005 | Embargos IBAMA |\n| `GET /v1/ambiental/uso-solo` | $0.005 | Cobertura MapBiomas |\n| `GET /v1/ambiental/risco/{municipio}` | $0.007 | Risco ambiental |\n| `GET /v1/ambiental/empresa/{cnpj}/esg` | $0.030 | Análise ESG |\n\n### Saúde, energia, transporte e mais\n\n| Endpoint | Preço | Descrição |\n|----------|-------|-----------|\n| `GET /v1/saude/medicamentos/{registro}` | $0.003 | Medicamentos ANVISA |\n| `GET /v1/saude/planos` | $0.003 | Planos ANS |\n| `GET /v1/energia/geracao` | $0.005 | Geração de energia (ONS) |\n| `GET /v1/energia/tarifas` | $0.003 | Tarifas ANEEL |\n| `GET /v1/energia/combustiveis` | $0.003 | Preços ANP |\n| `GET /v1/transporte/aeronaves` | $0.005 | Aeronaves ANAC |\n| `GET /v1/transporte/acidentes` | $0.005 | Acidentes PRF |\n| `GET /v1/comercio/exportacoes` | $0.005 | Exportações (ComexStat) |\n| `GET /v1/educacao/censo-escolar` | $0.005 | Censo escolar INEP |\n| `GET /v1/emprego/rais` | $0.005 | RAIS (emprego formal) |\n| `GET /v1/emprego/caged` | $0.005 | CAGED (admissões/demissões) |\n\n### Tributário\n\n| Endpoint | Preço | Descrição |\n|----------|-------|-----------|\n| `GET /v1/tributario/ncm/{codigo}` | $0.003 | Carga tributária por NCM/NBS (IBPT) |\n| `GET /v1/tributario/icms/{uf}` | $0.003 | Alíquota ICMS interna de um estado |\n| `GET /v1/tributario/icms` | $0.003 | Tabela ICMS completa (27 UFs) ou interestadual |\n\n### Análises compostas\n\n| Endpoint | Preço | Descrição |\n|----------|-------|-----------|\n| `GET /v1/rede/{cnpj}/influencia` | $0.050 | Análise de rede e influência |\n| `POST /v1/carteira/risco` | $0.150 | Risco de carteira (múltiplos CNPJs) |\n\n---\n\n## Query parameters\n\nTodos os endpoints aceitam:\n\n| Parâmetro | Exemplo | Descrição |\n|-----------|---------|-----------|\n| `format` | `?format=context` | Texto LLM-ready em vez de JSON (+$0.002) |\n| `fields` | `?fields=valor,data` | Projeção de campos |\n| `since` | `?since=2026-01-01` | Filtrar a partir de data |\n| `until` | `?until=2026-02-01` | Filtrar até data |\n| `limit` | `?limit=10` | Limite de registros |\n| `offset` | `?offset=20` | Offset para paginação |\n\n---\n\n## Formato de resposta\n\n```json\n{\n  \"source\": \"bcb_sgs\",\n  \"updated_at\": \"2026-02-21T10:00:00Z\",\n  \"cached\": true,\n  \"cache_age_seconds\": 3600,\n  \"cost_usdc\": \"0.003\",\n  \"data\": {\n    \"valor\": \"14.25\",\n    \"data\": \"2026-02-21\"\n  }\n}\n```\n\n---\n\n## Preços\n\n| Faixa | Preço (USDC) | Exemplos |\n|-------|-------------|----------|\n| Consultas básicas | $0.003 | BCB, IBGE, empresas, legislativo, tributário |\n| Consultas padrão | $0.005 | Ações B3, CVM, comércio exterior |\n| Consultas avançadas | $0.007 | Compliance empresa, DOU, risco ambiental |\n| Premium | $0.010 | Compliance completo, fundos, decisões STF/STJ |\n| Análises cruzadas | $0.015–$0.030 | Panorama, ESG, litígio, competição |\n| Análises profundas | $0.050–$0.150 | Rede de influência, due diligence, carteira |\n| Formato contexto | +$0.002 | Adicional sobre qualquer endpoint |\n\nRate limits: **100 req/min** por IP | **500 req/min** por wallet x402.\n\n---\n\n## Python SDK\n\n```bash\npip install databr\n```\n\n### Namespaces disponíveis\n\n| Namespace | Exemplo | Métodos |\n|-----------|---------|---------|\n| `bcb` | `client.bcb.selic()` | selic, cambio, focus, credito, reservas, taxas_credito, pix |\n| `empresas` | `client.empresas.consultar(cnpj)` | consultar, compliance, perfil_completo, due_diligence |\n| `economia` | `client.economia.ipca()` | ipca, pib, panorama |\n| `mercado` | `client.mercado.acoes(\"PETR4\")` | acoes, fundos, cotas, fatos, indices, competicao |\n| `compliance` | `client.compliance.verificar(cnpj)` | verificar, ceis, cnep, cepim |\n| `judicial` | `client.judicial.processos(doc)` | processos, stf, stj, litigio |\n| `legislativo` | `client.legislativo.deputados()` | deputados, senadores, proposicoes, votacoes |\n| `ambiental` | `client.ambiental.desmatamento()` | desmatamento, prodes, embargos, uso_solo, esg |\n| `transparencia` | `client.transparencia.licitacoes()` | licitacoes, contratos, servidores, orcamento |\n| `saude` | `client.saude.medicamentos(reg)` | medicamentos, operadoras, estabelecimentos |\n| `energia` | `client.energia.tarifas()` | tarifas, geracao, carga, combustiveis |\n| `transporte` | `client.transporte.aeronaves()` | aeronaves, transportadores, acidentes |\n| `comercio` | `client.comercio.exportacoes()` | exportacoes, importacoes |\n| `emprego` | `client.emprego.rais()` | rais, caged |\n| `tributario` | `client.tributario.ncm(\"22030000\", uf=\"SP\")` | ncm, icms |\n\n### Tratamento de erros\n\n```python\nfrom databr import DataBR, NotFoundError, PaymentError, RateLimitError\n\ntry:\n    empresa = client.empresas.consultar(\"00000000000000\")\nexcept NotFoundError:\n    print(\"CNPJ não encontrado\")\nexcept PaymentError:\n    print(\"Pagamento falhou — verificar saldo USDC\")\nexcept RateLimitError as e:\n    print(f\"Rate limit — retry em {e.retry_after}s\")\n```\n\n### Testnet\n\n```python\nclient = DataBR(private_key=\"0x...\", network=\"testnet\")  # Base Sepolia, USDC de teste\n```\n\n---\n\n## Fontes de dados\n\n42 coletores automáticos + 8 on-demand, cobrindo:\n\n| Fonte | Órgão | Atualização |\n|-------|-------|-------------|\n| Selic, PTAX, crédito, reservas, PIX, Focus | BCB | Diária/semanal |\n| IPCA, PIB, população, pesquisas | IBGE | Diária/mensal |\n| Cotações, Ibovespa | B3 | Diária (dias úteis) |\n| Fundos, fatos relevantes, cotas | CVM | Diária |\n| Candidatos, bens, doações, filiados | TSE | Anual / On-demand |\n| Licitações PNCP | Portal da Transparência | Diária |\n| Acórdãos, certidões, inabilitados | TCU | Semanal |\n| Deputados, senadores, proposições | Câmara/Senado | Diária |\n| RREO, RGF, Tesouro Direto | Tesouro Nacional | Diária/mensal |\n| Exportações, importações | ComexStat | Mensal |\n| Tarifas, geração, carga | ANEEL/ONS | Semanal/diária |\n| Medicamentos | ANVISA | Mensal |\n| Operadoras, planos | ANS | Semanal |\n| DETER, PRODES, MapBiomas | INPE | Diária/mensal |\n| Embargos | IBAMA | Semanal |\n| Aeronaves, transportadores, acidentes | ANAC/ANTT/PRF | Semanal/mensal |\n| Censo escolar | INEP | Semestral |\n| RAIS, CAGED | MTE (FTP) | Mensal/anual |\n| Decisões STF, STJ | Tribunais superiores | Diária |\n| Combustíveis | ANP | Semanal |\n| Séries macro | IPEA | Diária |\n| Diários oficiais | Querido Diário | On-demand |\n| CNPJ | minhareceita.org | On-demand |\n| Compliance CEIS/CNEP | CGU | On-demand |\n| Processos judiciais | DataJud CNJ | On-demand |\n| Carga tributária NCM/NBS | IBPT | On-demand |\n| Acordos leniência, PEP, renúncias, PGFN | CGU/Portal da Transparência | On-demand |\n| Operações de crédito | BNDES (CKAN) | On-demand |\n| Alíquotas ICMS (27 UFs) | CONFAZ/SEFAZ | Estático (2026) |\n\n---\n\n## Desenvolvimento local\n\n### Pré-requisitos\n\n- Go 1.24+\n- Docker (PostgreSQL + Redis)\n\n### Setup\n\n```bash\ngit clone https://github.com/igorpdev/databr.git\ncd databr\n\n# Subir PostgreSQL e Redis\ndocker-compose up -d\n\n# Configurar variáveis\ncp .env.example .env\n# Editar .env com suas configurações\n\n# Rodar API\ngo run cmd/api/main.go\n\n# Rodar coletores (em outro terminal)\ngo run cmd/collector/main.go\n\n# Testes\ngo test ./...\n```\n\nA API sobe em `http://localhost:8080`. Sem `WALLET_ADDRESS` configurado, os endpoints `/v1/*` funcionam sem pagamento (modo dev).\n\n### Estrutura\n\n```\ndatabr/\n├── cmd/\n│   ├── api/              # Entrypoint REST API + MCP\n│   └── collector/        # Scheduler de coletores\n├── internal/\n│   ├── handlers/         # 30+ handlers HTTP (122 endpoints)\n│   ├── collectors/       # 23 pacotes de coletores (50 fontes)\n│   ├── repositories/     # PostgreSQL (pgx/v5)\n│   ├── cache/            # Redis + cache em memória\n│   ├── x402/             # Middleware de pagamento + pricing\n│   ├── mcp/              # MCP Server (170+ tools)\n│   ├── domain/           # Entidades e interfaces\n│   ├── metrics/          # Prometheus\n│   └── logging/          # Structured logging (slog)\n├── sdk/python/           # Python SDK (PyPI: databr)\n├── docs/\n│   ├── openapi.yaml      # Especificação OpenAPI 3.0\n│   └── landing.html      # Landing page\n├── migrations/           # Schema PostgreSQL\n├── Dockerfile            # API (multi-stage, ~23MB)\n├── Dockerfile.collector  # Coletores\n└── docker-compose.yml    # Dev: PostgreSQL 16 + Redis 7\n```\n\n---\n\n## Stack\n\n| Camada | Tecnologia |\n|--------|-----------|\n| Backend | Go 1.24, Chi Router |\n| Banco | PostgreSQL 16 (pgx/v5) |\n| Cache | Redis (Upstash em produção) |\n| Pagamentos | x402 protocol, USDC, Base network |\n| Deploy | Railway |\n| Métricas | Prometheus |\n| MCP | mcp-go (Mark3Labs) |\n| SDK | Python (PyPI) |\n\n---\n\n## Variáveis de ambiente\n\n```bash\n# Obrigatórias\nDATABASE_URL=postgres://databr:databr@localhost:5432/databr\nREDIS_URL=redis://localhost:6379\n\n# x402 (testnet)\nWALLET_ADDRESS=0x...\nX402_NETWORK=base-sepolia\nX402_FACILITATOR_URL=https://facilitator.x402.rs\n\n# x402 (mainnet)\n# X402_NETWORK=base\n# X402_FACILITATOR_URL=https://api.cdp.coinbase.com/platform/v2/x402\n# CDP_KEY_ID=...\n# CDP_KEY_SECRET=...\n\n# APIs externas (opcionais)\nTRANSPARENCIA_API_KEY=    # Portal da Transparência (CGU)\nDATAJUD_API_KEY=          # DataJud (CNJ)\nMINHARECEITA_URL=https://minhareceita.org\n```\n\n---\n\n## Links\n\n- **API**: https://databr.api.br\n- **Docs (Scalar)**: https://databr.api.br/docs\n- **OpenAPI spec**: https://databr.api.br/openapi.yaml\n- **MCP discovery**: https://databr.api.br/.well-known/mcp.json\n- **x402 discovery**: https://databr.api.br/.well-known/x402\n- **Python SDK**: https://pypi.org/project/databr/\n- **Health**: https://databr.api.br/health\n\n---\n\n## Licença\n\nMIT\n",
  "bytes": 15671,
  "sha": "201570472fd5efe20333dded5b0dfc006b18b29b15db31afc3c270bf3ea4e396",
  "repo_slug": "igorpdev/databr",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_igorpdev_databr_32b1fbad/readme"
}