convez.ai
MCP ServerFinanceiroIntermediário
robertoecf

Dados Financeiros Abertos

robertoecf/openfindata

Infraestrutura financeira pública do Brasil via MCP, REST, CLI e Python

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor 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/openfindata

1 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

Estrelas
13
Forks
3
Acompanhando
0
Saúde
71%
Último commit
há 3 dias
Versão
v0.3.1
Issues abertas
3
Contribuidores
1

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.

CI Versão Python Licença MIT Estado

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

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.

Ver o original no GitHub

Bom para

Relacionados