Brazil Cvm Financials

@pipeworx/brazil-cvm-financials

CVM（Comissao de Valores Mobiliarios）のオープンデータから取得した、ブラジル上場企業の年次財務諸表（貸借対照表、損益計算書、キャッシュフロー計算書、付加価値計算書）です。CNPJまたは会社名で検索でき、CVM勘定科目コードと名称を含み、金額はすべてBRLで表示されます。

Pipeworxの一部です。AI エージェントを1872以上の稼働中データソースにつなぐMCPゲートウェイです。独立した非公式の連携であり、上流プロバイダーとは提携しておらず、その承認を受けたものでも、同プロバイダーが公開したものでもありません。

ツール

• br_financials(cnpj | name, year?, scope?, statement?, max_depth?, limit?, offset?) -- 1社の1会計年度分の財務諸表を、勘定科目の行（コード、ポルトガル語の名称、BRLでの金額）として返します。デフォルトの深度は2で、主要な科目が返されます。補助科目を含めるにはmax_depthを大きくします。各レスポンスには範囲（連結／個別）、提出バージョン、提出時の単位が示されます。データにない会社または年度を指定した場合は、data_as_ofとfound:falseが返されます。
• br_financials_search(name, limit?) -- 会社名で検索します（すべての単語が一致する必要があり、アクセント記号は無視されます）。CNPJ、CVMコード、利用可能な会計年度が返されます。
• br_financial_series(cnpj | name, account_code, from_year?, to_year?, scope?) -- 複数年度にわたる1つの勘定科目（例：3.01 損益計算書の最上位項目、1 総資産、2.03 純資産）を返します。各年度の名称、範囲、提出バージョンが含まれます。また、欠損年度は省略せずmissing_yearsに記載されます。

認証

キーは不要です。

データソース

• CVM（Comissao de Valores Mobiliarios、ブラジル）のオープンデータ：上場企業の年次財務諸表（DFP）、対象は2019会計年度以降です。

ライセンス。 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は、製造業では収益を示しますが、銀行では金融仲介による収益を示します。値ごとに名称も返されるため、この不一致を確認できます。
• 1株当たりの項目： 1株当たり利益の勘定科目（3.99.*）は1株当たりの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を通じて回答できます。そのため、2つ目の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