Dados B3 — MCP 服务器（巴西股市，可审计的基本面数据）

葡萄牙语版本见下方

一个 MCP 连接器，让您的 AI 代理（Claude、ChatGPT、Cursor 等）能够访问巴西上市公司（B3）的基本面数据——包括银行和保险公司——从 2010 年至今，并配有完全公开的方法论：ROE、ROIC、利润率、增长、净债务/EBITDA、时点倍数（P/E、P/B、EV/EBITDA，以财报实际公开之后的第一个交易日的价格定价——无前视偏差，可用于回测）、股息和股息收益率、现成的评分（Piotroski F-Score 和 Graham）以及重述财报的记录。

数据来源：CVM 开放数据（ODbL）和 B3（COTAHIST）。每个数字都带有其来源的 CVM 科目，并且只有通过一系列不变性测试后才会发布——资产负债表平衡、利润表对账一致、价格永远不会先于证明其合理性的财报出现。

产品与方案：https://dadosb3.com

用法 1 — 远程（无需安装，推荐）

将此远程连接器添加到您的 AI 客户端：

https://dadosb3.com/mcp/

在 Claude 中：设置 → 连接器 → 添加自定义连接器 → 粘贴 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，并通过 chave_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 → adicionar conector personalizado → 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 existe por dois motivos: dar um caminho de instalação de um comando só, 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 uma chave grátis (200 consultas/dia, sem cartão) ou assine o Pro em https://dadosb3.com e passe a chave no argumento chave_api (ou na variável DADOS_B3_API_KEY).

A contagem de empresas não fica escrita aqui de propósito: o universo cresce quando a CVM publica, e um número congelado num README envelheceria sem ninguém ver. Para o número de hoje, chame saude.

Bancos e seguradoras

Instituições financeiras têm plano de contas próprio (não há EBIT nem receita de venda). O conector as classifica pelo plano de contas real e entrega os indicadores que fazem sentido — ROE, margem, crescimento, P/L, P/VP, dividendos — e não publica ROIC/EBITDA/EV-EBITDA para elas (não se aplicam). Ex.: Itaú, Bradesco, Banco do Brasil, BB Seguridade, IRB.

Por que este e não outro

Metodologia 100% pública, testes de invariantes antes de cada publicação, múltiplos sem vazamento de informação futura, e histórico de reapresentações registrado. Comparativo honesto, inclusive onde os concorrentes são melhores: https://dadosb3.com/comparativo

Licença

MIT (este conector). Os dados são públicos (CVM/B3); o serviço adiciona padronização, metodologia e testes.