Dados Financeiros Abertos
robertoecf/openfindata
Infraestrutura financeira pública do Brasil via MCP, REST, CLI e Python
Ver no GitHubServidor MCP que agrega fontes públicas brasileiras (BCB, CVM, B3, Tesouro, IBGE, IPEA) em uma camada única e auditável. Oferece biblioteca Python assíncrona, API REST com Swagger/ReDoc, CLI e registro offline para resolver CNPJ/ticker. Sem dependência de chaves de API para fontes principais.
Instalação
npx convez-ai robertoecf/openfindata1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Análise de dados financeiros brasileiros em tempo real
- Integração de cotações e séries históricas em aplicações
- Pesquisa macroeconômica com dados do BCB, IPEA e IBGE
- Automação de consultas a CNPJ, ticker e informações de empresas
Veredito

Ferramenta madura e bem documentada para acesso estruturado a dados financeiros públicos brasileiros. Cobertura ampla de fontes (13+), suporte MCP nativo e sem overhead de autenticação tornam viável para agentes Claude consultarem dados econômicos reais. Status alpha requer avaliação de estabilidade em produção.
README
A tradução para o português deste README ainda está na fila.
Dados Financeiros Abertos
Infraestrutura open source para consultar dados financeiros públicos do Brasil em Python, REST, CLI e MCP.
O que é
O projeto agrega fontes públicas brasileiras em uma camada única e auditável para analistas, desenvolvedores, pesquisadores e agentes:
- biblioteca Python assíncrona;
- API REST com Swagger e ReDoc;
- CLI
findata; - servidor MCP em
/mcp; - registro local para resolver CNPJ, ticker e nome.
As fontes principais não exigem chaves de API e os testes unitários não acessam a
rede. O slug de distribuição continua sendo findata-br; o pacote importável e a
CLI continuam sendo findata.
Instalação
pip install findata-br
Para desenvolvimento local:
git clone https://github.com/robertoecf/findata-br.git
cd findata-br
pip install -e '.[dev]'
bash scripts/git/install-hooks.sh
Uso rápido
CLI
findata bcb get selic -n 10
findata bcb ptax
findata cvm search Petrobras
findata b3 quote PETR4
findata registry lookup 33000167000101
findata serve
Python
import asyncio
from findata.registry import lookup
from findata.sources.bcb import sgs
async def main() -> None:
selic = await sgs.get_series_by_name("selic", n=5)
print(selic)
entity = await lookup("PETR4")
print(entity.entities[0])
asyncio.run(main())
REST e MCP
findata serve
curl 'http://localhost:8000/bcb/series/name/selic?n=5'
curl 'http://localhost:8000/registry/lookup?q=PETR4'
- Site local:
http://localhost:8000/ - Chart Lab:
http://localhost:8000/charts - Swagger:
http://localhost:8000/api/docs - ReDoc:
http://localhost:8000/redoc - MCP:
http://localhost:8000/mcp
O Chart Lab é a referência visual e informacional para gráficos do projeto, mas o renderer pode ser SVG, PNG, HTML inline ou TradingView Lightweight Charts. O contrato detalhado fica em docs/CHART_STANDARDS.md.
Fontes suportadas
O README mantém só o mapa de alto nível. A matriz completa de fontes, endpoints, notas de autenticação e exemplos de consulta fica em docs/SOURCES_AND_ENDPOINTS.md.
Fontes hoje expostas: BCB, Base dos Dados, CVM, Tesouro, IBGE, IPEA, Open Finance Brasil, B3, Yahoo Finance experimental, ANBIMA, Receita Federal, ANEEL, SUSEP e o registro offline CNPJ/ticker/nome.
Documentação
- Fontes e endpoints
- Padrão de gráficos
- Deploy público
- Open Finance público
- Fontes com autenticação
- Prioridades de fontes
- Manifesto
- Contribuição
Qualidade
Antes de propor merge ou release, rode pelo menos:
ruff format --check src/ tests/ scripts/
ruff check src/ tests/ scripts/
mypy src/findata
pytest tests/ -q
Os testes de integração contra APIs públicas reais ficam separados por marcador:
pytest -m integration
Escopo
Este projeto consulta dados públicos. Ele não consulta dados privados de clientes, não armazena credenciais de usuário e não depende de fornecedores comerciais como camada central.
Licença
MIT.