Firmenbuch

agentic-firmenbuch

オーストリアの全企業登記簿を、AI エージェントが自然言語で検索できます。 すべての企業の公式基本データ、年次決算書、主要比率を MCP 経由で提供し、幻覚ではなく実際の数値に基づいて回答します。

プレイグラウンドを試す  ·  無料で開始：50 クレジット、7 日間  ·  クイックスタート ↓

オーストリアのFirmenbuch（無料の EU HVD／高価値データセット）を対象とする、稼働中の自動データ製品です。マルチテナント MCP サーバーを通じて提供されます。決定論的な Azure パイプラインが公式登記簿で公開されている Jahresabschluss（年次財務諸表）の提出書類を取得、解析し、企業ごとに統合して、比率・成長率・傾向を算出し、その結果を MCP クライアントに提供します。登記簿全体には約 640k の法人が登録されており、現在提供しているのは約 341k 社分で、バックフィルの進行に伴い増加しています。バージョン 1＝事実と明確な派生データのみ（スコアリング、サードパーティによる情報拡充、NACE、AI による要約はありません）。

ドイツおよび DACH 地域全体にも対応しています。 オーストリア向け製品に加えて、統合された agentic-register エンドポイントが、オーストリアのFirmenbuchとドイツのHandelsregister / Unternehmensregisterの両方を単一の MCP 経由で提供します。公式 MCP レジストリには io.github.jkbngb/handelsregister（仕様：handelsregister.server.json）として掲載されており、同じアカウントと同じアクセスルール（無料トライアル後は Pro）で https://register.agentic-firmenbuch.at/mcp に接続できます。検索結果には両国の該当企業が含まれ、country（AT / DE）で識別できます。

クイックスタート

ホステッドサービスを利用する – HTTP ヘッダーキーに対応する MCP クライアント（Claude Code、GitHub Copilot を搭載した VS Code、Cursor など）から、公式 Firmenbuch データを検索できます。

1. agentic-firmenbuch.at で API キーを取得します。新規アカウントにはすべて、有効期間 7 日間の無料クレジット 50 件が付与されます（1 社あたり 1 クレジットのため、約 50 社分）。この利用枠はウェブコンソールと Claude で共有されます。トライアル終了後、Claude、Cursor、その他の MCP/API クライアントからアクセスするには、月額 €79（税別）の Pro が必要です。公正利用の範囲内で無制限に検索できます（1 日あたり 10,000 回の呼び出し、エクスポート行数 20,000 行、月あたり 50 件のドキュメント）。月ごとに解約できます。クレジットパックはウェブコンソール向けの商品であり、MCP/API アクセスは利用できません。（Claude Cowork / claude.ai のようなサンドボックス型クライアント経由で接続すると、キー不要で初回接続時に 50 クレジットが付与されます。詳細は以下を参照してください。）
2. サーバーを追加します。Claude Code（ターミナル）の場合、次の 1 行を実行します。

   claude mcp add --scope user --transport http agentic-firmenbuch https://mcp.agentic-firmenbuch.at/mcp --header "X-API-Key: <your-key>"
   

   GitHub Copilot / VS Code の場合：code --add-mcp "{\"name\":\"agentic-firmenbuch\",\"type\":\"http\",\"url\":\"https://mcp.agentic-firmenbuch.at/mcp\",\"headers\":{\"X-API-Key\":\"<your-key>\"}}"。その他の HTTP-MCP ヘッダー対応クライアントの場合：URL は https://mcp.agentic-firmenbuch.at/mcp、ヘッダーは X-API-Key: <your-key> です。
3. たとえば、自然言語で 「Aktive GmbHs in Oberösterreich mit Bilanzsumme über 5 Mio. €, sortiert nach Umsatz.」 と質問します。エージェントが search_companies / get_company_details を呼び出し、公式データを使って回答します。SDK は不要です。

Claude Cowork と claude.ai（サンドボックス型クライアント）は API キーヘッダーを受け付けません。URL https://mcp.agentic-firmenbuch.at/mcp を指定し、Settings → Connectors → Add custom connector から一度限りのメールログイン（OAuth、キー不要）で接続してください。スクリーンショット付きの手順については、agentic-firmenbuch.at/cowork.html をご覧ください。

登録前に試してみたい場合は、**プレイグラウンド**をご利用ください。

または、パイプラインを自分で実行する – クローンして、uv sync、uv run pytest を実行します（オフラインで動作し、Azure は不要です）。開発を参照してください。

利用可能な MCP ツール

ツール	目的
search_companies	地域、規模、貸借対照表合計、自己資本比率、売上高、成長プロファイル、経営陣の年齢、直近の提出年、ステータスでオーストリア企業を絞り込み／順位付けします。一致した各企業の簡潔な結果カードを返します。
get_company_details	1社の詳細な提供プロフィール：企業情報、所在地、設立年／提出年、規模区分、複数年の貸借対照表と損益計算書、算出済みの13の比率、成長、経営陣、提出書類の一覧。
get_full_record	get_company_details の上位互換：UGB の全317項目の分類体系、未知のコードのそのままの受け渡し、完全性、GuV の年次データ、署名権者の履歴、算出根拠の登録簿。
get_company_history	報告されたすべての項目を提出書類ごとに時系列で返します。1社、または fnrs による一括取得（最大50社。クレジットが適用される場合、見つかった企業1社につき1クレジット）。
find_peers	企業の規模区分／地域内で、類似度が高い企業をK社抽出します。
get_cohort_summary	フィルターに一致する企業群の集計統計（件数、パーセンタイル、分布）。
get_coverage	提供データセットの州（Bundesland）別／法的形態（Rechtsform）別／規模区分別のカバレッジ統計。
list_sectors	フィルターで使用できる法的形態（Rechtsform）および州（Bundesland）のコードを一覧表示します。
describe_fields	型、null のルール、EBIT／EBITDA の定義を含む、自己記述型のフィールド辞書。
get_document	原本の提出済み年次財務諸表（XML または PDF）の URL／blob キーを取得します。
get_document_text	提出済み年次財務諸表（解析済み XML／PDF）から抽出したテキストを返し、そのまま読めるようにします。
list_documents	企業の Abschluss 文書を新しい順にまとめた一覧を返します。提出済み年次財務諸表に加え、登記簿が保管する PDF（Konzernabschluss、HV-Protokoll）も Dokumentart とともに含まれます。
search_person	役員／代表者（代表取締役、取締役、署名権者）の氏名から企業を検索します。
benchmark_company	企業を同業企業群と比較し、主要指標のパーセンタイル順位を示します。
list_events	企業または企業群の登記変更イベント（社名／本店所在地／法的形態／資本金／経営陣の変更。2026-07 以降、日次で算出）。
get_event_stats	フィルターに一致する企業群について、イベントの集計統計（種別／期間別の件数）を返します。
export_companies_csv	フィルターに一致する企業群を CSV としてエクスポートします（サーバー生成の有効期限付きリンク）。
get_my_usage	呼び出し元自身の利用状況、プラン、残りのトライアルクレジット、アップグレードリンクを返します。
ping	接続テスト。常に無料です。

すべてのツールは、オーストリアの公式 Firmenbuch データを加工した派生データを返します（出典：BMJ – Justiz、CC BY 4.0）。具体的には、登記簿から公開済みの提出書類を取り込み、解析・統合して比率を算出し、それを独自のデータベースから提供しています。ウェブスクレイピング、LLM による要約の生成、第三者データの混在はありません（V1）。すべての応答には provenance.data_version と built_at が含まれ、元の出典も明記されるため、エージェントは適切に出典を示せます。権威ある記録については、常に公式 Firmenbuch が優先されます。

現在提供中：全 Rechtsformen（GmbH、AG、KG、OG、EU、Genossenschaft、Privatstiftung、SE など）にわたる、約341,000の有効な法人。登記簿全体には約640,000の法人があります。差分は、Jahresabschluss が公開されていない企業と、活動を停止／削除された項目であり、順次追加しています。

ドキュメント

バージョン規約（提供済みの _v1 仕様と、今後の ROADMAP.md ＋ V2 設計仕様）を含む全項目の一覧は、docs/README.md をご覧ください。 主要なドキュメント：

ドキュメント	内容
docs/pipeline-step-samples.md	ファイル形式と、各パイプライン段階のゴールデンサンプルです。
docs/FIELD_REFERENCE.md	提供フィールドの辞書 – 各 MCP ツールが返すすべてのフィールドと、その型および null の規則です。公開ページ：felder.html。
ROADMAP.md	今後の計画 – ステータス／優先度と、V2 の方向性（銀行／保険会社、GISA、Ediktsdatei）です。
docs/appendix_position_mapping.json	317 項目すべてを網羅する標準ポジション分類 → products/agentic-firmenbuch/packages/core_at/…/mapping/ にコピーされています。
docs/reference/	公式の参照資料（API リファレンス、JAb 4.0 の XSD／Excel）です。

モノレポの構成（agentic-first）

このリポジトリは、agentic-first モノレポの上位リポジトリです。ソースに依存しない共有コードとソースごとの製品を分離しているため、オーストリアのパイプラインに手を加えずに、別のソース固有の製品を追加できます。

agentic-first/                       (this repo)
├── packages/                        SHARED — source-agnostic, zero Firmenbuch/UGB knowledge
│   ├── core/    (fbl_core)          lineage/meta + metric contracts, config, storage clients
│   └── auth/    (fbl_auth)          signup, token issue/validate, metering, 00_accounts
└── products/
    └── agentic-firmenbuch/           AUSTRIA product (live) — README below
        ├── packages/
        │   ├── core_at/  (fbl_core_at)   UGB taxonomy, Firmenbuch domain models, ÖNACE, FI dirs
        │   ├── firmenbuch_client, 99_registry, 90_ingest, 70_parse,
        │   │   50_consolidate, 30_derive, 10_present, mcp_server, orchestration
        │   └── …
        └── tests/                   AT integration tests + golden fixtures

ソース固有の製品を追加する場合は、packages/{core,auth} を依存関係として利用する独立した別のリポジトリに追加します（このリポジトリではひな形を作成しません）。1:1／適応／製品ローカルでの再利用の明確な境界については、技術仕様の**再利用表（付録 R）**を参照してください。一般的な手順はdocs/monorepo/ADDING_A_PRODUCT.mdに記載されています。

製品の README： agentic-firmenbuch · 共有の core · auth

パイプライン（番号付きレイヤー、90 → 10）

99_registry (foundation: all companies)  →  90_raw (Blob)  →  70_parsed (Blob)  →  50_consolidated  →  30_derived  →  10_presentation  →  MCP
                                                                        (Cosmos)            (Cosmos)        (Cosmos)
   side: 00_accounts (MCP signup) · 00_directories (register-based FI flag, OeNB)   reserved for v2: 40_enriched, 20_scored

90_raw は不変の信頼できる唯一の情報源です（ダウンロードしたすべての XML／PDF を永久に保持します）。70_parsed は、提出書類ごとの ParsedFiling JSON のライトスルーキャッシュです。常に raw から再生成できるため、安全に削除して再構築できます。再処理（ロジック変更後の再統合／再派生）で、すべての提出書類の再解析をスキップできるようにするため、また各統合ドキュメントの系譜 inputs[] が実在する解析済みドキュメントを参照できるようにするために存在します。50/30/10 はクエリ可能な Cosmos レイヤーであり、10_presentation が MCP によって提供されます。

LAYER_MAP – どのコードがどのレイヤーを担当するか

各パイプラインステージのパッケージディレクトリには、レイヤー番号が接頭辞として付いているため、各データレイヤーの担当が一目でわかります。（Python のモジュール名は数字で始められないため、インポート可能なパッケージ名は fbl_* のままです。各ステージパッケージでは LAYER 定数として番号も公開しています。）

すべての AT ステージパッケージは products/agentic-firmenbuch/packages/ 以下にあります（以下では …/ と略記します）。

レイヤー	パッケージ（ディレクトリ）	インポート	ストア／コンテナー	Pydantic モデル	サンプル
99_registry	…/99_registry	fbl_registry	Cosmos 99_registry	RegistryDoc	§15a.0 doc
90_raw	…/90_ingest	fbl_ingest	Blob 90-raw	raw Meta + manifest	Stage 0
70_parsed	…/70_parse	fbl_parse	Blob 70-parsed	ParsedFiling	Stage 1
50_consolidated	…/50_consolidate	fbl_consolidate	Cosmos 50_consolidated	ConsolidatedCompany	Stage 2
30_derived	…/30_derive	fbl_derive	Cosmos 30_derived	DerivedCompany	Stage 3
10_presentation	…/10_present	fbl_present	Cosmos 10_presentation	PresentedCompany	Stage 4

番号なし。 共通パッケージ（packages/ 内）：core（fbl_core、ソース非依存のリネージ／メタデータとメトリクスのコントラクト、設定、ストレージ）および auth（fbl_auth、00_accounts）。AT 固有パッケージ（products/agentic-firmenbuch/packages/ 内）：core_at（fbl_core_at、UGB 分類体系 + Firmenbuch ドメインモデル + ÖNACE + FI ディレクトリ）、firmenbuch_client（fbl_firmenbuch_client、HVD SOAP アダプター）、orchestration（fbl_orchestration、--mode ジョブのエントリーポイント）、mcp_server（fbl_mcp_server、サービス提供）。さらに、products/agentic-firmenbuch/tests/（フィクスチャ）と docs/（API プローブの調査結果を含む）があります。

ビルド状況 – 本番環境で稼働中 ✅

すべてのビルドステージが実装され、サービスは本番環境で稼働中です。マルチテナントの MCP サーバーがデプロイされ、日次パイプラインが cron で実行され、バックフィルによって提供対象のデータが増え続けています。V1 のローンチ以降、レジストリにはセマンティックベクトル検索、ÖNACE/WZ 産業分類、レジストリ変更イベント、統合エンドポイントを通じたドイツ商業登記簿のカバレッジ、および上記のトライアル後に Pro へ移行するアクセスモデルが追加されています。CI では ruff + mypy --strict + pytest（カバレッジゲート 80%）がすべて成功しています。バックエンドのデプロイはレビュー後に手動で行います。

開発

uv sync                            # create the workspace venv
uv run pytest                      # all fixture/unit/integration tests (offline)
uv run mypy packages products      # strict types (shared + products)
uv run ruff check packages products  # lint

真のエンドツーエンド（実環境）： 別のテストを用意しており、環境フラグで実行を制御します。このテストでは、実際の FNR をいくつか使って、すべてのレイヤー（API → 90_raw → … → 10_presentation → MCP）を通して実行します。デフォルトではスキップされます。

FBL_E2E=1 uv run pytest products/agentic-firmenbuch/tests/e2e -q  # needs FIRMENBUCH_API_KEY

products/agentic-firmenbuch/tests/e2e/ を参照してください。インメモリストアと小規模な実データ取得を使用します。Azure は不要で、完全なバックフィルも不要です（デプロイはレビュー後に手動で行います）。

ライセンスとデータ

MIT License の下でライセンスされています（LICENSE を参照）。

データは Austrian Firmenbuch（BMJ – Justiz）に由来し、CC BY 4.0 の下でライセンスされた EU の高価値データセットです。データを再配布する場合は、必ず次のクレジットを保持してください。 "Quelle: Österreichisches Firmenbuch / BMJ – Justiz (CC BY 4.0)"（NOTICE を参照）。

免責事項 – 保証なし、自己責任でご利用ください

本ソフトウェアおよび本ソフトウェアが生成するデータは、明示または黙示を問わず、「現状のまま」かつ「いかなる種類の保証もない」状態で提供されます（MIT License を参照）。処理済みデータは公開されている Firmenbuch から自動的に生成されたものであり、正確性、完全性、適時性、または特定目的への適合性を一切保証せずに提供されます。これは法律、税務、または財務に関する助言ではなく、公式の Firmenbuch 抄本に代わるものではありません。常に公式の登記簿が優先されます。

本ソフトウェアおよびデータのご利用は、すべてご自身の責任で行ってください。 法律で認められる最大限の範囲において、作者および著作権者は、その使用に起因する直接的、間接的、偶発的、または結果的な損害について、一切の責任を負いません。データを使用または再配布する際は、CC BY 4.0 のクレジット表示要件および適用されるすべてのデータ保護法、競争法、著作権法を遵守する責任があります。