Dados B3

Dados B3 — MCP サーバー（ブラジル株式市場、監査可能なファンダメンタルズ）

Português abaixo

AI エージェント（Claude、ChatGPT、Cursor など）が、上場ブラジル企業（B3）のファンダメンタルズに、銀行や保険会社も含めて2010年から現在までアクセスできるMCP コネクターです。手法はすべて公開されています。ROE、ROIC、利益率、成長率、純有利子負債/EBITDA、ポイント・イン・タイムの倍率（P/E、P/B、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 イメージ（コマンド 1 つ、ローカルの 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）。目的は 2 つあります。コマンド 1 つでインストールできるようにすることと、MCP ディレクトリがサーバーを実際に実行して評価できるようにすることです。

ツール

ツール	機能	無料？
listar_empresas	対象企業すべて（社名、納税者番号、ティッカー）。銀行と保険会社を含みます	はい
indicadores_anuais	ROE、ROIC、利益率、成長率、純有利子負債／EBITDA — 2010年以降の年次系列	WEGE3 は無料。他の銘柄にはキーが必要です
multiplos	時点別の P/E、P/B、EV/EBITDA、過去12か月の P/E	WEGE3 は無料。他の銘柄にはキーが必要です
fatos_contabeis	各数値の出典である CVM コードを付した標準化済み財務諸表	WEGE3 は無料。他の銘柄にはキーが必要です
dividendos	現金分配、年次概要、12か月の配当利回り	WEGE3 は無料。他の銘柄にはキーが必要です
scores	9つの基準をすべて表示する Piotroski F-Score と Graham テスト	WEGE3 は無料。他の銘柄にはキーが必要です
reapresentacoes	訂正済みの提出書類 — 元の数値と修正後の数値を並べて表示します	WEGE3 は無料。他の銘柄にはキーが必要です
trimestres	四半期系列：提出時点の Q1／Q2／Q3 財務諸表、四半期の株価、利益率、過去12か月の ROE	WEGE3 は無料。他の銘柄にはキーが必要です
etfs_ranking	B3 ETF：取引高上位、純資産額上位、同日 NAV に対するプレミアム／ディスカウントが大きい順、12か月 NAV リターン、実質手数料が低い順	はい
etf	1つの ETF：日次 NAV（FNET 提出書類）、プレミアム／ディスカウント、月次実質手数料、ポートフォリオ（CDA）、同業 ETF との重複	BOVA11 は無料。他の銘柄にはキーが必要です
auditar_amostra	YOUR seed を使って事例を抽出し、CVM ファイルと照合して各数値を再計算できます（計算式、勘定科目、確認箇所）	はい
fiis_ranking	ディスカウント率が高い FII（時点別 P/B）、12か月利回りが高い順、セグメント別中央値	キーが必要です
hoje	過去30日間の変更内容：公開された提出書類、再提出された提出書類、配当、ファンド分配、コーポレートアクション、ティッカー変更	はい
fii	1つの不動産ファンド：時点別 P/B、12か月利回り、空室率、最近の分配	MXRF11 は無料。他の銘柄にはキーが必要です
fiis	P/B と配当利回りの範囲でファンドを絞り込みます	キーが必要です
screener	指標の範囲で市場全体を絞り込みます。as_of で、ある日付に公開されていた情報を確認できます（先読みなし）。recibo=True にすると、回答を永続的に引用可能なアドレスに固定します	キーが必要です
recibo	固定されたスクリーナークエリを読み込みます：質問、基準日、データバージョン、結果、sha256	はい
veredito	1銘柄の記述的な概要：3つの質問に対する6つの数値、それぞれの数値範囲と比較（セクター中央値、企業自身の過去、株式市場全体）、およびデータ信頼度フラグ — 事実のみで、助言ではありません	はい、すべての銘柄
desempenho	「投資する価値はあったか？」を少数の数値でサーバー側で算出します：リターン、最大ドローダウン、ボラティリティ、21日×100日の移動平均クロスオーバーとバイ・アンド・ホールドとの比較。株式分割調整後の株価を使用し、配当が記録されている場合はトータルリターン（権利落ち日に配当と JCP を再投資）も算出します。すべてのティッカーで利用できます	はい
desempenho_fii	不動産ファンドについて同じ内容を算出します（価格のみ。分配金はトータルリターンにのみ含まれます。1日の変動が35％を超えると confiavel: false と表示されます）	はい
desempenho_etf	ETF について同じ内容を算出します（価格のみ。1日の変動が35％を超えるとフラグが表示されます）	はい
indice	ベンチマーク：B3 指数（IBOV、IFIX、SMLL など）のパフォーマンス。コードを空にすると一覧を表示します	はい
indice_precos	指数の日次終値（ポイント）。キーなしの場合は30営業日のサンプル	サンプル
bdr	B3 上場の BDR：一覧（無料）、または1つの BDR のリターン、レアル建ての分配金、株式分割	一覧は無料。AAPL34
bdr_precos	BDR の日次価格。キーなしの場合は30営業日のサンプル	サンプル
precos	1銘柄の日次価格系列（始値、高値、安値、終値、出来高）。古い順に表示し、期間中のコーポレートイベントも含みます。未調整です。キーなしの場合は、全データの取得方法を案内する通知付きの30営業日分のサンプルです	WEGE3 は無料。他の銘柄はサンプルのみ。全データにはキーが必要です
eventos	株式分割、併合、株式配当、スピンオフ。各イベントの出典（B3 が発表したもの、または当方が見つけたもの）と当日の純影響を表示します	WEGE3 は無料。他の銘柄にはキーが必要です
dicionario	各指標の計算式、CVM 勘定科目、利益の基準を JSON 形式で表示します	はい
metodologia	公開されている方法論ページをテキストで表示します	はい
saude	現在の対象範囲と最終取り込み日時	はい
trimestres が第3四半期で止まるのは意図的です。中間報告（ITR）に単独の第4四半期は含まれません。通期 − 9か月 で算出でき、実際に算出する場合もあります。ここでは算出しません。算出した数値を会社が報告した数値と同じリストに並べると、2つの報告書に含まれる誤差を引き継ぎ、提出された数値とこちらで計算した数値の境界が曖昧になるためです。確定した年度については、年次系列をリクエストしてください。

WEGE3 と方法論全体は公開されており、キーは不要です。他の会社については、https://dadosb3.com/chave-gratis?de=github で無料キーを作成するか（1日あたり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 エージェント（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 イメージ（1つのコマンドで、ローカルの Python は不要）

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

イメージは main への push ごとに公開されます。目的は2つあります。1つのコマンドだけでインストールできる方法を提供すること、そして MCP ディレクトリーでサーバーを実行して評価できるようにすることです。

通常の Python をお使いですか？

pip install dadosb3 — 同じ API を利用する公式クライアントです。エラーは適切に処理され、ツールごとのメソッドを備えています：https://pypi.org/project/dadosb3/

ツール

ツール	機能	無料？
listar_empresas	対象企業一覧（社名、CNPJ、ティッカー）。銀行と保険会社を含みます	はい
indicadores_anuais	ROE、ROIC、利益率、成長率、純有利子負債／EBITDA — 2010年以降の年次系列	WEGE3は無料、それ以外はキーが必要
multiplos	P/L、P/VP、EV/EBITDAの時点別データ、TTM P/L	WEGE3は無料、それ以外はキーが必要
fatos_contabeis	各数値の出典となるCVM勘定科目を含む標準化済み勘定科目	WEGE3は無料、それ以外はキーが必要
dividendos	株主還元、年間サマリー、12か月の配当利回り	WEGE3は無料、それ以外はキーが必要
scores	9つの評価基準を公開したPiotroski F-Scoreと、Grahamの基準	WEGE3は無料、それ以外はキーが必要
reapresentacoes	再公表された財務諸表 — 旧版と改訂版を並べて表示	WEGE3は無料、それ以外はキーが必要
trimestres	四半期系列：公表時点の1Q／2Q／3Qの勘定科目、四半期株価、利益率、TTM ROE	WEGE3は無料、それ以外はキーが必要
etfs_ranking	B3 ETF：取引量上位、純資産上位、当日基準価額に対するプレミアム／ディスカウントが大きいもの、基準価額ベースの12か月リターン、実効手数料が最も低いもの	はい
etf	1つのETF：日次基準価額（FNET）、プレミアム／ディスカウント、月ごとの実効手数料、ポートフォリオ（CDA）、同業ETFとの重複	BOVA11は無料、それ以外はキーが必要
auditar_amostra	あなたのシードでケースを抽出し、CVMファイルを照合して各数値を再計算します（計算式、勘定科目、確認場所）	はい
fiis_ranking	割安度の高いFII（時点別P/VP）、12か月DY上位、セグメント別中央値	キーが必要
hoje	過去30日間の変化：公表された財務諸表、再送信された財務諸表、株主還元、FIIの分配金、企業イベント、ティッカー変更	はい
fii	1つの不動産投資信託：時点別P/VP、12か月DY、空室率、最近の分配金	MXRF11は無料、それ以外はキーが必要
fiis	P/VPと配当利回りの範囲でファンドを絞り込みます	キーが必要
screener	指標の範囲で市場全体を絞り込みます。as_ofを指定すると、未来の情報を参照せず、指定日時点で公開されていた情報を返します。recibo=Trueを指定すると、引用可能な恒久的なアドレスに結果を固定します	キーが必要
recibo	固定されたスクリーナーのクエリを読み取ります：質問、基準日、データバージョン、結果、およびそのsha256	はい
veredito	株式の説明的な概要：3つの質問に対する6つの数値。それぞれ数値範囲と比較（セクター中央値、自社の過去実績、市場全体）、およびデータの信頼性フラグを示します — 事実であり、助言ではありません	はい、すべての株式
desempenho	「投資する価値はありましたか？」を少数の数値で表示します。サーバー側で計算したリターン、最大下落率、ボラティリティ、21日移動平均と100日移動平均のクロスを、買って保有する場合と比較します。イベント調整後価格を使用し、株主還元がある場合は配当とJCPを権利落ち日に再投資したトータルリターンも表示します。すべてのティッカーで利用できます	はい
desempenho_fii	不動産投資信託について同様の情報を表示します（価格のみ。分配金はトータルリターンのみ。35%を超える日次変動にはconfiavel: falseのマークが付きます）	はい
desempenho_etf	ETFについて同様の情報を表示します（価格のみ。35%を超える日次変動にはマークが付きます）	はい
indice	ベンチマーク：B3指数（IBOV、IFIX、SMLLなど）のパフォーマンス。コードを空欄にすると一覧を表示します	はい
indice_precos	指数の日次終値（ポイント）。キーなしで30取引日のサンプルを取得できます	サンプル
bdr	B3のBDR：一覧（無料）、または1つの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 から算出でき、そうする人もいます。私たちは算出しません。私たちが計算した数値を、会社が報告した数値と同じリストに載せると、2つのファイルに由来する誤差を含み、「公表された数値」と「私たちが計算した数値」の境界が曖昧になるからです。通期については、年次系列をリクエストしてください。

WEGE3 と metodologia は、キーなしでお試しいただけます。その他の企業については、https://dadosb3.com/chave-gratis?de=github で 無料キー を作成するか（1日200件、カード不要）、https://dadosb3.com/assinar?de=github で Pro に登録し、引数 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）であり、サービスは標準化、方法論、テストを追加しています。