Dados B3 — MCP 서버 (브라질 주식 시장, 검증 가능한 펀더멘털)

아래는 포르투갈어 버전

AI 에이전트(Claude, ChatGPT, Cursor 등)가 브라질 상장기업(B3) — 은행과 보험사 포함 — 의 2010년부터 오늘까지의 펀더멘털에 접근할 수 있게 해주는 MCP 커넥터입니다. 방법론이 완전히 공개되어 있습니다: ROE, ROIC, 마진, 성장률, 순부채/EBITDA, 특정 시점(point-in-time) 배수(P/E, P/B, EV/EBITDA — 공시가 실제로 공개된 이후 첫 거래일에 가격으로 산정, 선견(look-ahead) 정보가 없어 백테스트에 사요 가능), 배당금과 배당수익률, 바로 사⭐용할 수 있는 스코어(Piotroski F-Score 및 Grahaham), 재작성 공시 기록까지 포함합니다.

출처: CVM 공개 데이터(ODbL)와 B3(COTAHIST). 모든 수치에는 출처가 된 CVM 계정이 함께 표시되며, 불변성 테스트 묶음이 통과해야만 게시됩니다 — 대차대조표의 균형이 맞고, 손익계산서가 부합하며, 가격이 그 가격을 정당화하는 공시를 앞지르지 않는다는 조건입니다.

제품 및 요금제: https://dadosb3.com

사용법 1 — 원격 (설치 항목 없음, 권장)

이 원격 커넥터를 AI 클라이언트에 추가하세요:

https://dadosb3.com/mcp/

Claude에서: 설정 → 커넥터 → 사용자 지정 커M커넥터 추가 → URL 붙여넣기.

Related MCP server: brdata-mcp

사용법 2 — 로컬 (stdio)

pip install -r requirements.txt
python server.py

{
  "mcpServers": {
    "dados-b3": {
      "command": "python",
      "args": ["server.py"],
      "env": { "DADOS_B3_API_KEY": "your_optional_key" }
    }
  }
}

사용법 3 — Docker 이미지(명령 한 번, 로컬 Python 불필요)

docker run -i --rm -e DADOS_B3_API_KEY=your_optional_key ghcr.io/val7h/dados-b3-mcp:latest

{
  "mcpServers": {
    "dados-b3": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/val7h/dados-b3-mcp:latest"]
    }
  }
}

이 이미지는 main에 푸시할 때마다 배포됩니다(.github/workflows/publicar-imagem.yml). 이미지는 두 가지 이유로 존재합니다: 한 번의 명령으로 원하는 설치 경로를 제공하고, MCP 디렉터리가 이 서버를 실제로 실행하여 평가할 수 있게 해주기 때문입니다.

도구

WEGE3와 전체 방법론은 키 없이 공개되어 있습니다. 그 외 기업은 무료 키(하루 200회 조회, 카드 불필요)를 만들거나 https://dadosb3.com의 Pro 를 구독하고, 가 me_api 인수나 DADOS_B3_API_KEY 환경 변수로 전달하세요.

회사 수는 의도적으로 여기 적어두지 않았습니다. CVM이 공시할 때마다 대상 종목이 늘어나고, README에 고정된 숫자는 누구도 알아차리지 못한 채 낡기 때문입니다. 오늘의 수치는 saude로 확인하세요.

은행과 보험

금융기관은 다른 계정과목 체계로 공시합니다 — EBIT도 매출도 없습니다. 이 커넥터는 이들을 실제 계정과목 체계로 분류해 의미 있는 지표 — ROE, 마진, 성장률, P/E, P/B, 배당금 — 를 제공하고, 적용되지 않는 ROIC, EBITDA, EV/EBITDA는 의도적으로 게시하지 않습니다. 예: Itaú, Bradesco, Banco do Brasil, BB Seguridade, IRB.

왜 이 것인가

설명이 아니라 실제로 공개된 방법론, 모든 배포를 관문하는 불변성 테스트, 미래 정보가 새어 나오지 않는 배수, 그리고 재작성 이력을 유지 — 기업이 공시를 다시 공시하면 두 버전은 나란히 남습니다. 경쟁사가 더 나은 경우도 포함한 솔직한 비교: https://dadosb3.com/comparativo

라이선스

MIT(이 커넥터). 기초 데이터는 공개(CVM/B3)이며, 서비스는 표준화, 방법론, 테스트를 더합니다.

Dados B3 — servidor MCP (bolsa brasileira, fundamentos auditáveis)

Conector MCP que dá ao seu agente de IA (Claude, ChatGPT, Cursor e outros) acesso a dados fundamentalistas das companhias abertas brasileiras (B3) — inclusive bancos e seguradoras —, de 2010 até hoje, com metodologia 100% pública: ROE, ROIC, margens, crescimento, dívida líquida/EBITDA مركز, múltiplos ponto-no-tempo (P/L, P/VP, EV/EBITDA com o preço do 1º pregão após a publicação real do balanço — sem look-ahead,próprio para backtest), dividendos e dividend yield, scores prontos (Piotroski F-Score e Graham) e histórico de reapresentações de balanço.

Fonte: CVM (dados abertos, ODbL) e B3 (COTAHIST). Cada número carrega a conta CVM de origem; nada é publicado sem uma bateria de testes de invariantes passando (o balanço fecha, a DRE fecha, o preço nunca antecede a publicação).

Produto e planos: https://dadosb3.com

Uso 1 — remoto (nada para instalar, recomendado)

Adicione este conector remoto ao seu cliente de IA:

https://dadosb3.com/mcp/

No Claude: Configurações → Conectores → custom connector → cole a URL.

Uso 2 — local (stdio)

pip install -r requirements.txt
python server.py

Uso 3 — imagem Docker (um comando, sem Python local)

docker run -i --rm -e DADOS_B3_API_KEY=sua_chave_opcional ghcr.io/val7h/dados-b3-mcp:latest

A imagem é publicada a cada push na main. Ela é publicada por dois motivos: dar um caminho de instalação de um só comando, e permitir que diretórios de MCP rodem o servidor para avaliá-lo.

Ferramentas

A empresa WEGE3 e a metodologia são abertas para degustação, sem chave. Para as demais, crie umacluding chave grátis 200 consultas/dia, sem cartão ou assine o Pro em https://dadosb3.com, usando a chave em chave_api ou variável DADOS_B3_API_KEY.

A contagem das empresas ficou typed over: o universo cresce e um número congelado envelhecimento sem atenção. Para hoje, chame saude.

Empresas de bancos e seguradoras — planos de contas próprios, sem EBIT ou receita de vendas; os indicadores são limitados a ROE, margem, growth, P/L, P/VP, dividends, e não há ROIC/EBITDA/EV –Exemplos: Itaú, Bradesco, Banco do Brasil, BB Seguridade, RRB.

Plano de negócios

Metodologia open, testes, sem primeiro, histórico de reapresentações registrado, honest comparison e transparency, including comparação com comparência onde são melhores: https://dadosb3.com/comparativo

Licença

LICENÇA MIT (este conector). Dados públicos (CVM/B3); o serviço inclui padronização, dedução de regras e quebra de testes.