Brazil Cvm Financials

@pipeworx/brazil-cvm-financials

巴西上市公司的年度财务报表（资产负债表、损益表、现金流量表、增值表），数据来自 CVM（Comissao de Valores Mobiliarios）开放数据——可按 CNPJ 或公司名称查询，包含 CVM 科目代码和名称，金额均为完整 BRL。

属于 Pipeworx——连接 AI Agent 与 1872+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未获其认可，也非其发布。

工具

• br_financials(cnpj | name, year?, scope?, statement?, max_depth?, limit?, offset?) -- 返回某家公司某一财年的报表科目行 （代码、葡萄牙语名称、BRL 金额）。默认深度为 2，返回主要科目； 提高 max_depth 可查询子科目。每条响应都会注明范围 （合并/单体）、申报版本和申报金额单位。如果数据中没有该公司或年份，则返回 found:false 和 data_as_of。
• br_financials_search(name, limit?) -- 按名称查找公司（名称中的每个词 都必须匹配；忽略重音符号）；返回 CNPJ、CVM 代码和可用财年。
• br_financial_series(cnpj | name, account_code, from_year?, to_year?, scope?) -- 查询某个科目跨年度的数据（例如，3.01 损益表主要科目、1 总资产、2.03 权益），并附带每年的名称、范围和申报版本；缺失年份会列入 missing_years，而不会被省略。

身份验证

无需密钥。

数据来源

• CVM（Comissao de Valores Mobiliarios，巴西）开放数据——上市公司 2019 财年起的年度财务报表（DFP）。

许可证。 CVM 根据 Open Data Commons Open Database License (ODbL) 发布此数据集。此处的数据是数据库副本，因此适用 ODbL：须注明 CVM，并对数据库采用相同方式共享。每条响应都包含 source 和 licence 字段。

副本包含和不包含的内容——引用数字前请先阅读。

• 仅保留最新申报版本。 CVM 的档案会将申报的每次修订作为额外行保存（并每周更新重新申报的数据）。每家公司每个参考日期仅保留最高版本；响应会报告 filing_version 和 filing_versions_seen。已被取代的修订版本不可用。
• 仅保留当年列。 每份申报还会将上一年列为比较数据；该列会被删除（这是重述数据，会作为下一年度申报中的当年列出现）。因此，数字表示“该财年申报时的数据”，而不是“之后重述的数据”。
• 保留的报表： 资产负债表资产（BPA）和负债/权益（BPP）、损益表（DRE）、间接法现金流量表（DFC_MI）和直接法现金流量表（DFC_MD）、增值表（DVA），包括合并报表和单体报表。不保留：权益变动表、综合收益表、审计师意见、股本构成。
• 范围： 合并报表代表整个集团；单体报表仅代表母公司。若公司提交了合并报表，则默认使用合并报表。
• 单位和货币： 申报方以单位或千为金额单位；响应会应用倍数并返回完整 BRL，同时注明申报时的单位。所有载入的报表均以 BRL 计价。
• 科目表因行业而异。 CVM 科目代码采用统一编号（1 为资产、2 为负债和权益、3 为损益、6 为现金流量、7 为增值），但银行和保险公司使用不同的损益表科目表：3.01 对工业企业表示收入，对银行则表示金融中介收入。每个数值都会附带名称，以便识别不匹配情况。
• 每股科目： 每股收益科目（3.99.*）以每股 BRL 计价，不会乘以申报金额单位；这些数值会作为 value_brl_per_share 返回。
• 财年标签遵循参考日期；年结日不在 12 月的公司会按其参考日期所在的日历年列出。

更新数据

CVM 每周重新提交文件。使用以下命令重新加载（需要先登录 Pipeworx Cloudflare 账户中的 wrangler）：

node scripts/brazil-cvm-financials/load-data.mjs --from 2019

加载器会删除并重新加载表格，验证行数是否与其生成的数量一致；如果不一致，则以非零状态码退出。每个响应中的 data_as_of 是最近一次加载的日期；latest_filing_received 是其中最新的文件接收日期。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "brazil-cvm-financials": {
      "url": "https://gateway.pipeworx.io/brazil-cvm-financials/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/brazil-cvm-financials/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 及网关范围内的其他工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除了列出该工具包自身的工具，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当天有效的权威信息。

这是有意设计的，并非意外的多路复用。元工具让受限连接也能回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录路由——无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的模式占用的上下文超过路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接获取每个工具包列出的全部工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1872+ 个数据源。唯一的区别是直接列出哪个工具包的工具；ask_pipeworx 从任一端点都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/br_financials \
  -H 'Content-Type: application/json' \
  -d '{"cnpj":"33.000.167/0001-01","year":2024,"statement":"DRE"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/br_financials。查找工具：使用 {"query":"..."} 向 POST https://gateway.pipeworx.io/v1/tools/search_packs 发送请求。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需通过网关往返：

{
  "mcpServers": {
    "brazil-cvm-financials": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-brazil-cvm-financials"]
    }
  }
}

或者直接运行，以确认它能正常启动：

npx -y @pipeworx/mcp-brazil-cvm-financials

它通过 stdin/stdout 使用 MCP 通信，并仅为此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗的英语提问，而不是直接调用工具——此方式既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Brazil Cvm Financials data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT