Firmenbuch

agentic-firmenbuch

奥地利完整的公司注册数据，可供 AI Agent 通过自然语言查询。 为每家公司提供官方主数据、年度账目和关键比率——通过 MCP 提供服务，基于真实数据作答，而非产生幻觉。

试用在线体验  ·  免费开始：50 个额度，有效期 7 天  ·  快速入门 ↓

这是基于奥地利 Firmenbuch（欧盟免费 HVD／高价值数据集）构建的实时自动化数据产品，通过多租户 MCP 服务提供。确定性 Azure 流水线从官方登记处获取已发布的 Jahresabschluss（年度财务报表）申报文件，解析并按公司合并，计算比率／增长／趋势，然后将结果提供给 MCP 客户端。整个登记处包含约 64 万个法人实体；目前提供的数据约覆盖 34.1 万个，随着历史数据回填持续推进，覆盖范围还会扩大。版本 1 = 仅提供事实和清晰的派生数据（不含评分、第三方数据补充、NACE 或 AI 摘要）。

还提供德国和更广泛的 DACH 地区数据。 除此奥地利产品外，统一的 agentic-register 端点通过单个 MCP 提供奥地利 Firmenbuch 和德国 Handelsregister / Unternehmensregister 的数据。它已列入官方 MCP 注册表，名称为 io.github.jkbngb/handelsregister（规范：handelsregister.server.json），可通过 https://register.agentic-firmenbuch.at/mcp 访问，使用相同的账户和访问规则（免费试用，之后为 Pro）。搜索结果会包含两个国家的数据，并以 country（AT／DE）标记。

快速入门

使用托管服务——通过接受 HTTP 请求头密钥的 MCP 客户端（Claude Code、带 GitHub Copilot 的 VS Code、Cursor 等）查询官方 Firmenbuch 数据：

1. 在 agentic-firmenbuch.at 获取 API 密钥。每个新账户都会获得 50 个免费额度，有效期 7 天（每家公司消耗 1 个额度，因此约可查询 50 家公司），网页控制台和 Claude 共用此额度。试用期结束后，通过 Claude、Cursor 或任何 MCP／API 客户端访问都需要订阅 Pro，价格为每月 €79，另加增值税：公平使用限制内的查询不限量（每天 10,000 次调用、20,000 行导出数据、每月 50 份文档），按月取消。额度包是网页控制台专属产品，不能解锁 MCP／API 访问权限。（通过 Claude Cowork／claude.ai 等沙盒客户端连接时，首次连接即可获得 50 个额度，无需密钥，见下文。）
2. 添加服务。Claude Code（终端），一行命令：

   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. 用自然语言提问，例如 “奥地利上奥地利州活跃的 GmbH，资产负债表总额超过 500 万欧元，按营收排序。” Agent 会调用 search_companies／get_company_details，并以官方数据作答——无需 SDK。

Claude Cowork 和 claude.ai（沙盒客户端）不接受 API 密钥请求头——请通过 Settings → Connectors → Add custom connector，使用 URL https://mcp.agentic-firmenbuch.at/mcp 和一次性电子邮件登录（OAuth，无需密钥）进行连接。附截图的分步说明：agentic-firmenbuch.at/cowork.html。

想先试用再注册？请使用**在线体验**。

或者自行运行流水线——克隆项目，执行 uv sync 和 uv run pytest（离线运行，无需 Azure）。参见开发。

可用的 MCP 工具

工具	用途
search_companies	按地区、规模、资产负债表总额、权益比率、营收、增长情况、管理层年龄、最近申报年份和状态筛选／排序奥地利公司。每个匹配项返回一张精简结果卡片。
get_company_details	提供一家公司的完整档案：身份信息、所在地、成立／申报年份、规模类别、多年资产负债表及损益表、13 项计算得出的比率、增长情况、管理层和申报文件列表。
get_full_record	get_company_details 的超集：完整的 317 项 UGB 分类体系、未处理代码的透传、完整性信息、损益表年份、签字人历史记录和派生数据注册表。
get_company_history	按申报文件逐项提供所有已报告项目的时间序列，支持查询一家公司的数据，也可通过 fnrs 批量查询（最多 50 家；适用额度时，每家找到的公司扣 1 个额度）。
find_peers	在某家公司的规模类别／地区范围内，查找与其最相近的 K 家同类公司。
get_cohort_summary	提供筛选后群组的汇总统计（数量、百分位数、分布）。
get_coverage	提供已服务数据集按 Bundesland／Rechtsform／规模类别划分的覆盖统计。
list_sectors	列出筛选条件可用的法律形式（Rechtsform）和 Bundesland 代码。
describe_fields	提供自描述字段字典，包含类型、空值规则以及 EBIT／EBITDA 定义。
get_document	获取原始已申报年度财务报表的 URL／blob 键（XML 或 PDF）。
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，并注明原始来源，以便 Agent 正确标注数据来源；如需权威记录，应以官方 Firmenbuch 为准。

目前已提供：约 341,000 家活跃法人实体，涵盖所有 Rechtsformen（GmbH、AG、KG、OG、EU、Genossenschaft、Privatstiftung、SE 等）。完整登记册约有 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）。

Monorepo 布局（agentic-first）

此仓库是 agentic-first Monorepo 总仓。它将与数据源无关的共享代码与按数据源划分的产品分开，因此可以添加其他特定数据源的产品，而无需修改奥地利管道：

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 的直写缓存——始终可从原始数据重新生成，因此可以安全删除/重建；设立它是为了让重新处理（在逻辑变更后重新合并/派生）时跳过所有申报文件的重新解析，并确保每份合并文档中的溯源 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 文档
90_raw	…/90_ingest	fbl_ingest	Blob 90-raw	原始 Meta + 清单	阶段 0
70_parsed	…/70_parse	fbl_parse	Blob 70-parsed	ParsedFiling	阶段 1
50_consolidated	…/50_consolidate	fbl_consolidate	Cosmos 50_consolidated	ConsolidatedCompany	阶段 2
30_derived	…/30_derive	fbl_derive	Cosmos 30_derived	DerivedCompany	阶段 3
10_presentation	…/10_present	fbl_present	Cosmos 10_presentation	PresentedCompany	阶段 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 行业分类、注册变更事件、通过统一端点覆盖德国 Handelsregister，以及上文所述的先试用后升级 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 许可的欧盟高价值数据集。重新分发数据时，必须保留归属声明 "Quelle: Österreichisches Firmenbuch / BMJ – Justiz (CC BY 4.0)"（参见 NOTICE）。

免责声明——不提供保证，使用风险自负

本软件及其生成的任何数据均按 “原样”提供，不作任何形式的保证，无论明示或暗示（参见 MIT License）。处理后的数据由公开的 Firmenbuch 自动生成，不保证其准确性、完整性、时效性或适用于任何特定用途。这些内容不构成法律、税务或财务建议，也不能替代 Firmenbuch 的官方摘录——官方登记信息始终具有优先效力。

使用本软件及其数据的全部风险由您自行承担。 在法律允许的最大范围内，作者和版权持有人对因使用本软件及其数据而产生的任何直接、间接、附带或后果性损害不承担任何责任。使用或重新分发数据时，您有责任遵守 CC BY 4.0 的归属要求以及所有适用的数据保护、竞争和版权法律。