Dados B3

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

Português abaixo

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

数据来源：CVM 开放数据（ODbL）和 B3（COTAHIST）。每项数据都标注了对应的 CVM 科目，且只有通过一整套不变量测试后才会发布数据——资产负债表必须平衡，利润表必须勾稽，价格不得早于其所依据的申报信息。

产品与套餐：https://dadosb3.com/?de=github

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

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

https://dadosb3.com/mcp/

在 Claude 中：Settings → Connectors → add custom connector → 粘贴 URL。

用法 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 目录能够实际运行服务以进行评估。

工具

工具	功能	免费？
listar_empresas	所有已覆盖的公司（名称、税号、股票代码），包括银行和保险公司	是
indicadores_anuais	ROE、ROIC、利润率、增长率、净债务/EBITDA——自 2010 年起的年度序列	WEGE3 免费；其他股票需要密钥
multiplos	特定时点的市盈率、市净率、EV/EBITDA；滚动市盈率	WEGE3 免费；其他股票需要密钥
fatos_contabeis	标准化财务报表，标明每个数值所依据的 CVM 代码	WEGE3 免费；其他股票需要密钥
dividendos	现金分配、年度汇总和 12 个月股息率	WEGE3 免费；其他股票需要密钥
scores	展示全部九项标准的 Piotroski F-Score，以及 Graham 测试	WEGE3 免费；其他股票需要密钥
reapresentacoes	重述后的申报文件——并列展示原始数值和修订后的数值	WEGE3 免费；其他股票需要密钥
trimestres	季度序列：按申报文件记录的 Q1/Q2/Q3 财务数据、该季度股价、利润率和滚动 ROE	WEGE3 免费；其他股票需要密钥
etfs_ranking	B3 ETF：成交量最大、净资产最高、相对当日 NAV 的溢价/折价最大、12 个月 NAV 回报最高、实际费用最低	是
etf	单只 ETF：每日 NAV（FNET 申报文件）、溢价/折价、月度实际费用、投资组合（CDA）及与同类 ETF 的重合度	BOVA11 免费；其他 ETF 需要密钥
auditar_amostra	使用你自己的种子抽取案例，以便你根据 CVM 文件重新计算每个数值（公式、科目、查找位置）	是
fiis_ranking	折价最大的 FII（特定时点市净率）、12 个月收益率最高的 FII，以及按类别划分的中位数	需要密钥
hoje	过去 30 天的变化：已发布的申报文件、重新提交的申报文件、股息、基金分配、公司行动、股票代码变更	是
fii	单只房地产基金：特定时点市净率、12 个月收益率、空置率、近期分配	MXRF11 免费；其他基金需要密钥
fiis	按市净率和股息收益率范围筛选基金	需要密钥
screener	按指标范围筛选整个市场；as_of 可查询某个日期的公开信息（无前视偏差）；recibo=True 会将结果固定在永久且可引用的地址	需要密钥
recibo	读取已固定的筛选查询：问题、截止日期、数据版本、结果及其 sha256	是
veredito	单只股票的描述性摘要：围绕三个问题提供六个数值，每个数值都附有数值区间和比较对象（行业中位数、公司自身历史、整个市场），以及数据可信度标记——只提供事实，绝非建议	是，适用于任意股票
desempenho	用几个由服务端计算的数值回答“值得吗？”：回报率、最大回撤、波动率，以及 21 x 100 移动平均线交叉策略与买入并持有策略的比较。基于拆股调整后的价格；有股息记录时，还会计算总回报（在除息日再投资股息和 JCP）。适用于所有股票代码	是
desempenho_fii	房地产基金的同类表现数据（仅价格；总回报才包含分配；单日涨幅超过 35% 时会标记为 confiavel: false）	是
desempenho_etf	ETF 的同类表现数据（仅价格；单日涨幅超过 35% 时会标记）	是
indice	基准：B3 指数（IBOV、IFIX、SMLL……）的表现；代码留空即可列出指数	是
indice_precos	指数每日收盘点位（无需密钥即可获取 30 个交易日的样本）	样本
bdr	B3 上的 BDR：BDR 列表（开放访问），或单只 BDR 的回报、以雷亚尔计价的分配和拆分信息	列表免费；AAPL34
bdr_precos	BDR 每日价格（无需密钥即可获取 30 个交易日的样本）	样本
precos	单只股票的每日价格序列（开盘价、最高价、最低价、收盘价、成交量），按时间从早到晚排列，并附上该时期的公司事件；未经调整。无需密钥时提供 30 个交易日的样本，并说明如何获取完整数据	WEGE3 免费；其他股票提供样本，获取完整数据需要密钥
eventos	拆股、反向拆股、送股和分拆，注明各项事件的来源（B3 公布或由我们发现）及当日净影响	WEGE3 免费；其他股票需要密钥
dicionario	以 JSON 格式提供各项指标的公式、CVM 科目和收益计算基础	是
metodologia	已发布的方法论页面，以文本形式呈现	是
saude	当前覆盖范围和最近一次数据导入	是
trimestres 会有意地在 Q3 截止。中期申报（ITR）不会单独列出第四季度——可以用 全年 − 九个月 推算，有些工具也确实会这么做。我们不会：自行计算的数值若与公司报告的数值出现在同一列表中，就会同时承受两份申报中的误差，并模糊已申报数据与计算数据之间的界限。对于已结束的年度，请请求年度序列。

WEGE3 和整套方法论均开放使用，无需密钥。对于其他公司，请在 https://dadosb3.com/chave-gratis?de=github 创建一个免费密钥（每天 200 次查询，无需银行卡），或在 https://dadosb3.com/assinar?de=github 订阅 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?de=github

更喜欢纯 Python？

pip install dadosb3——同一 API 的官方客户端，提供类型化错误，并为每个工具提供一个方法：https://pypi.org/project/dadosb3/

许可证

MIT（本连接器）。底层数据为公开数据（CVM/B3）；该服务提供标准化处理、方法论和测试。

---

Dados B3 — MCP 服务（巴西证券交易所，可审计的基本面数据）

MCP 连接器，可让你的 AI Agent（Claude、ChatGPT、Cursor 等）访问巴西上市公司（B3）的基本面数据，包括银行和保险公司，数据范围从 2010 年至今，并提供100% 公开的方法论：ROE、ROIC、利润率、增长、净债务/EBITDA、时点倍数（P/L、P/VP、EV/EBITDA，采用资产负债表实际发布后的第一个交易日价格——无前视偏差，适用于回测）、股息和股息收益率、现成评分（Piotroski F-Score 和 Graham）以及资产负债表重述历史。

来源：CVM（开放数据，ODbL）和 B3（COTAHIST）。每个数值都注明其来源 CVM 科目；只有通过一整套不变性测试后才会发布数据（资产负债表平衡，损益表平衡，价格绝不早于发布日期）。

产品和套餐：https://dadosb3.com/?de=github

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

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

https://dadosb3.com/mcp/

在 Claude 中：设置 → 连接器 → 添加自定义连接器 → 粘贴 URL。

用法 2 — 本地（stdio）

pip install -r requirements.txt
python server.py

用法 3 — Docker 镜像（一条命令，无需本地 Python）

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

每次向 main 推送时都会发布镜像。它有两个用途：提供一条命令即可完成安装的途径，并让 MCP 目录能够运行该服务以进行评估。

更喜欢纯 Python？

pip install dadosb3——同一 API 的官方客户端，提供经过处理的错误，并为每个工具提供一个方法：https://pypi.org/project/dadosb3/

工具

工具	功能	免费？
listar_empresas	所有涵盖的公司（名称、CNPJ、股票代码），包括银行和保险公司	是
indicadores_anuais	ROE、ROIC、利润率、增长、DL/EBITDA——自 2010 年起的年度序列	WEGE3 免费；其他需要密钥
multiplos	P/E、P/B、EV/EBITDA 时点值；TTM P/E	WEGE3 免费；其他需要密钥
fatos_contabeis	标准化科目，并列出每个数字对应的来源 CVM 科目	WEGE3 免费；其他需要密钥
dividendos	分红、年度摘要和 12 个月股息收益率	WEGE3 免费；其他需要密钥
scores	Piotroski F-Score（列出全部九项标准）和 Graham 标准	WEGE3 免费；其他需要密钥
reapresentacoes	重述后的财报——并排展示原始版本和修订版本	WEGE3 免费；其他需要密钥
trimestres	季度序列：按发布内容列出的第 1/2/3 季度科目、季度价格、利润率和 TTM ROE	WEGE3 免费；其他需要密钥
etfs_ranking	B3 ETF：交易量最高、资产规模最大、相对当日净值溢价/折价最高、按净值计算的 12 个月回报率、最低实际费率	是
etf	单只 ETF：每日净值（FNET）、溢价/折价、逐月实际费率、持仓（CDA）以及与同类 ETF 的重叠情况	BOVA11 免费；其他需要密钥
auditar_amostra	使用您自己的种子随机抽取案例，对照 CVM 文件重新核验每个数字（公式、科目、查询位置）	是
fiis_ranking	折价最高的房地产基金（时点 P/B）、12 个月股息收益率最高的基金以及各细分领域的中位数	需要密钥
hoje	过去 30 天的变动：已发布的财报、重新提交的财报、分红、房地产基金收益、公司事件、股票代码变更	是
fii	单只房地产基金：时点 P/B、12 个月股息收益率、空置率、近期收益	MXRF11 免费；其他需要密钥
fiis	按 P/B 和股息收益率区间筛选基金	需要密钥
screener	按指标区间筛选整个市场；as_of 可查询某日期公开的信息（不查看未来）；recibo=True 会将结果冻结到一个永久且可引用的地址	需要密钥
recibo	读取已冻结的筛选查询：问题、截止日期、数据版本、结果及其 sha256	是
veredito	股票描述性摘要：通过三个问题展示六个数字，每个数字都附有数值区间和比较结果（行业中位数、公司自身历史、整个市场），以及数据可信度标记——仅陈述事实，绝非建议	是，适用于任何股票
desempenho	“值得买吗？”用几个数字回答，由服务端计算：回报率、最大跌幅、波动率，以及 21 日均线与 100 日均线交叉信号，并与买入并持有策略对比；按公司事件调整价格，并在有分红时计算总回报（在除息日将股息和 JCP 再投资）。适用于任何股票代码	是
desempenho_fii	房地产基金的同类分析（仅价格；收益仅计入总回报；每日涨跌幅超过 35% 时会标记为 confiavel: false）	是
desempenho_etf	ETF 的同类分析（仅价格；每日涨跌幅超过 35% 时会标记）	是
indice	基准：B3 指数表现（IBOV、IFIX、SMLL……）；留空代码则列出指数	是
indice_precos	指数每日收盘点位（无需密钥即可获取 30 个交易日的样本）	样本
bdr	B3 的 BDR：开放列表，或单只 BDR 的回报、雷亚尔计价的分红和拆分信息	列表免费；AAPL34
bdr_precos	BDR 每日价格（无需密钥即可获取 30 个交易日的样本）	样本
precos	股票的每日价格序列（开盘价、最高价、最低价、收盘价、成交量），按时间从早到晚排列，并附上期间内的公司事件；未经调整。无需密钥即可获取 30 个交易日的样本，并附上如何获取全部数据的说明	WEGE3 免费；其他提供样本，完整数据需要密钥
eventos	拆股、合股、送股和分拆，并注明每项事件的来源（B3 公告或我们发现）及其当日净影响	WEGE3 免费；其他需要密钥
dicionario	每项指标的公式、CVM 科目和利润基准，以 JSON 格式提供	是
metodologia	已发布的方法论页面，以文本形式提供	是
saude	当前覆盖范围和最近一次数据导入时间	是
之所以故意不提供 trimestres 中的第 3 季度数据，是因为 ITR 从不单独提供第 4 季度数据——
它是用 exercício cheio − 9 meses 算出来的，有些人会据此推算。我们不会这样做：我们计算出的数字会与公司报告的数字出现在同一列表中，
既带有两个文件中的误差，也模糊了「已发布」和「我们计算」之间的界限。若要查询完整年度数据，请请求年度序列。

WEGE3 公司和方法论开放试用，无需密钥。 其他公司需要在 https://dadosb3.com/chave-gratis?de=github 创建一把免费密钥（每天 200 次查询，无需信用卡），或订阅 Pro： https://dadosb3.com/assinar?de=github，然后通过参数 chave_api（或环境变量 DADOS_B3_API_KEY）传入密钥。

这里故意不写公司数量：随着 CVM 发布数据，覆盖范围会不断扩大，而 README 中固定的数字会在无人察觉时变得过时。要查询今天的数量，请调用 saude。

银行和保险公司

金融机构使用专属科目表（没有 EBIT，也没有销售收入）。连接器会根据实际科目表对其进行分类，并提供适用的指标——ROE、利润率、增长、P/L、P/VP、股息——且不会为其发布 ROIC/EBITDA/EV-EBITDA（这些指标不适用）。例如：Itaú、Bradesco、Banco do Brasil、BB Seguridade、IRB。

为什么选它，而不是其他工具

方法论 100% 公开，每次发布前都会测试不变量，多重估值不会泄露未来信息，并且会记录历史重述。诚实的比较，包括竞争产品更胜一筹的方面：https://dadosb3.com/comparativo?de=github

许可证

MIT（此连接器）。数据为公开数据（CVM/B3）；服务额外提供标准化、方法论和测试。