dados-b3-mcp 是一个 MCP 连接器，让 AI 智能体（Claude、ChatGPT、Cursor 等）可以访问巴西上市公司（B3）的基本面数据，覆盖 2010 年至今，包括银行和保险公司。
用途 为 AI 智能体提供巴西股票市场（B3）的可审计基本面数据，用于基本面分析、估值和回测等场景。
主要能力
- 财务指标：ROE、ROIC、利润率、增长、净债务/EBITDA。
- 时点估值倍数：P/E、P/B、EV/EBITDA，价格取自财报实际公开当日或之后的首个交易日——无前视偏差（no look-ahead），可用于回测。
- 股息与股息收益率（dividends and dividend yield）。
- 现成评分：Piotroski F-Score 和 Graham。
- 财报重述（restatements）记录：公司重新申报时，两个版本并存保留。
- 银行与保险公司：财务机构使用不同的会计科目表（没有 EBIT 和销售收入）。连接器按其实际科目表分类，返回对其有意义的指标——ROE、利润率、增长、P/E、P/B、股息——并有意不发布 ROIC、EBITDA 或 EV/EBITDA，因为这些指标不适用。示例包括 Itaú、Bradesco、Banco do Brasil、BB Seguridade、IRB。
数据来源与质量 数据来源为 CVM 开放数据（ODbL）和 B3（COTAHIST）。每个数字都携带其来源的 CVM 科目；只有通过一系列不变量测试（资产负债表平衡、利润表对账、价格不早于其依据的财报）后才会发布。
使用方式 使用 1——远程（无需安装，推荐）：将远程连接器添加到 AI 客户端。在 Claude 中：设置 → 连接器 → 添加自定义连接器 → 粘贴 URL。远程地址：https://dados-b3.onrender.com/mcp/ 使用 2——本地（stdio）。 使用 3——Docker 镜像（一条命令，无需本地 Python）：镜像在每次推送到 main 时发布。 针对 MCP 目录：可让目录实际运行服务器以进行评估。 Python 客户端：pip install dadosb3 — 同一 API 的官方客户端，具有类型化错误和每个工具对应一个方法：https://pypi.org/project/dadosb3/
访问与密钥 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。
限制
- trimestres 有意止于第三季度。中期报告（ITR）从不包含单独第四季度——它可由全年减去九个月推导，但本项目不推导：计算出的数字会与公司报告的数字出现在同一列表中，携带两个文件带来的误差，并抹去“已发布”与“我们计算”之间的界限。需要完整年度请查询年度序列。
- 银行与保险公司不发布 ROIC、EBITDA 或 EV/EBITDA，因为这些指标对其不适用。
许可 连接器为 MIT 许可。底层数据为公开数据（CVM/B3）；服务增加了标准化、方法论和测试。
