Estonia Business Register

@pipeworx/estonia-business-register

爱沙尼亚电子商业登记册，由 RIK（爱沙尼亚登记与信息系统中心）以开放数据形式发布：每个已注册、正在清算或已破产实体的身份、法律形式、状态和地址、当前申报的经营领域（EMTAK/NACE），以及已提交年度报告中的部分财务指标和按经营活动分类的销售额明细。Fleet #2927。

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

RIK 不提供单条记录的实时 API — 仅提供批量开放数据文件 — 因此 Pipeworx 会每日刷新一份登记册副本。

工具

• ee_company(registry_code?, name?) — 根据实体的登记代码或当前登记的准确名称查询单个实体：身份信息（名称、法律形式、VAT 编号）、登记状态、地址和当前申报的 EMTAK/NACE 经营领域。按公司曾用名（更名之前的名称）无法匹配 — 请改用登记代码查询。对于部分名称，请先使用 ee_company_search。
• ee_company_search(name, status?, limit?) — 按公司当前名称的开头进行搜索（仅前缀匹配 — “Bolt”能找到“Bolt Technology OÜ”，但找不到“EuroBolt OÜ”），不区分变音符号，可选择按登记状态筛选。
• ee_annual_report_stats(registry_code, year?) — 查询已提交的年度报告：仅传入 registry_code 可列出所有已提交报告的年份（提交日期、是否经过审计、申报人规模类别）；添加 year 可查询该年份的部分财务指标（收入、利润/亏损、总资产、权益、平均全职员工人数）及按 EMTAK 经营领域分类的销售收入。不是完整报告 — 仅包含 RIK 自有提取数据中带有标准化元素名称的指标。某些已提交的报告（部分大型企业/集团申报人有此情况）带有元数据，但 RIK 提取数据中没有匹配的数值；此时仍会返回报告行，数值为 null，而非悄然返回空结果。
• ee_beneficial_owners(registry_code?, name?) — 查询实体的受益所有人：每位所有人的姓名、出生日期和国籍均与登记册中的显示内容完全一致，以及控制权的行使方式（直接/间接持股等）和该持股关系的起始日期。与此处的其他工具不同，此工具会在每次请求时实时读取登记册自身的公开页面——RIK 的批量开放数据提取文件完全不含受益所有人数据，只有公司页面才提供这些信息，因此 data_as_of 反映的是 RIK 自身最近更新该页面受益所有人部分的日期，而非每日镜像刷新日期。Fleet #3332，Bruce 关于构建姓名的裁定（CLAUDE.md 中的“What we will source” -> 个人数据）。任何出现在此处的人均可发送邮件至 [email protected] 请求删除；已记录删除请求的数据会被静默隐藏，并计入 withheld_by_removal_request。

每个响应都包含 data_as_of（镜像最近刷新的日期；仅对于 ee_beneficial_owners，则为 RIK 最近更新该页面受益所有人部分的日期）、source，以及（适用许可条款时的）licence。

查询更名后的实体

RIK 的基本/通用提取数据仅包含各实体的当前名称 — 登记数据不包含曾用名索引。一个著名的例子：现名为“Microsoft Development Center Estonia OÜ”的公司（登记代码 11056239）从 2004 年起以“Skype Technologies OÜ”之名经营，直到 2021 年更名。ee_company(name: "Skype Technologies") 会正确返回 not_found，并提示尝试使用登记代码；ee_company(registry_code: "11056239") 则可找到该公司。

状态代码

status_code 是 R（已注册／正常运营）、L（清算中）或 N（破产）之一——这是 RIK 基础开放数据摘录包含的三种状态。 status_label 字段以英文写明这些状态；status.text_et 则同时保留 RIK 自己使用的爱沙尼亚语表述。

活动领域

ee_company 的 activities 列表和 ee_annual_report_stats 的销售额 明细采用爱沙尼亚的 EMTAK 分类（同时列出对应的欧盟 NACE 代码），数据 截至镜像的 data_as_of 日期——不包含历史或已结束的活动领域条目。

身份验证

无需密钥。工具仅通过 Pipeworx 网关提供响应，该网关保存着登记册副本；单独执行 npm install 时没有数据可供读取，并且每个工具都会清晰地报错“在此运行时中未绑定”，而不会返回空列表。

个人数据（仅限 ee_beneficial_owners）

受益所有人的姓名、出生日期和国籍依据 Bruce 的 build-names 裁定提供（fleet #3329/#3332，已于 2026-10-18/19 在线验证，无需登录）。共享的移除机制（@pipeworx/shared 的 applyRemovals，也是 sos-entities 在 2026-10-08 姓名与职务裁定下使用的机制）会根据请求隐去任何姓名，请发送邮件至 [email protected]。RIK 页面上没有任何地址；此数据包不会收集或提供地址。

数据来源

• RIK（爱沙尼亚注册和信息系统中心）的电子商务登记册开放数据——基础和通用实体摘录（身份信息、法律形式、增值税号、状态、地址、当前报告的活动领域），每日更新；以及月度年度报告摘录（提交元数据、选定的财务报表指标和按活动领域划分的销售额明细），涵盖 2019–2025 年提交的报告。

许可：知识共享署名 4.0（CC BY 4.0）。 下载 RIK 开放数据需要接受其条款，其中要求注明来源——此处的每个响应都会准确提供 source + data_as_of。如果开放数据包含个人数据，后续处理须遵守 GDPR；RIK 已从 2024-11-01 起停止在这些文件中发布个人识别码。

为什么不支持全文姓名搜索

此处的姓名搜索是在标准化索引列上执行前缀范围扫描（折叠变音符号并转换为大写），而不是使用 FTS5 索引。对于此数据集的规模和前缀匹配场景，这种方式更简单，还能避开 D1 分块导入中的一个已知问题：FTS5 虚拟表的倒排记录不会通过通用分块导出／导入流程传输，因此每次加载后都需要在服务器端单独分批重建。普通的索引范围查询则无需这些操作。

为什么部分年度报告没有数据

五项财务指标（revenue、profit_loss、assets、 equity、employees_fte）来自 RIK 的月度“报告元素”摘录，并通过一小组标准化元素名称进行匹配（例如 Revenue、TotalProfitLoss、Assets、Equity、 AverageNumberOfEmployeesInFullTimeEquivalentUnits；如果合并与非合并形式同时存在，则优先采用非合并形式）。某些提交者的报告——在一些大型企业／控股公司提交者中观察到——在该摘录中某些年份完全没有对应行，尽管报告本身已提交，且其元数据（日期、审计标记、类别）也已保存。此时，ee_annual_report_stats 仍会返回真实元数据，并将数据字段设为 null，绝不会静默返回空结果。

快速开始

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

{
  "mcpServers": {
    "estonia-business-register": {
      "url": "https://gateway.pipeworx.io/estonia-business-register/mcp"
    }
  }
}

此端点实际提供的内容

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

这是有意为之，并非意外地进行了多路复用。元工具能让限定范围的连接回答该工具包未涵盖的问题——通过可跨整个目录路由的 ask_pipeworx 实现——无需再添加第二个 MCP 服务。目前无法挂载不带这些工具的工具包端点；如果额外的架构消耗的上下文超过了路由带来的收益，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的所有工具，而不仅仅是这个工具包的工具：

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

两个 URL 都会连接到同一个网关和相同的 1866+ 个数据源。唯一的区别在于，哪个工具包的工具会被直接列出；无论连接哪一个，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/ee_company \
  -H 'Content-Type: application/json' \
  -d '{"registry_code":"12417834"}'

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

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

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

{
  "mcpServers": {
    "estonia-business-register": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-estonia-business-register"]
    }
  }
}

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

npx -y @pipeworx/mcp-estonia-business-register

它通过 stdin/stdout 使用 MCP 通信，并仅针对这个工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接所添加的任何共享元工具。相同的源代码，相同的工具，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Estonia Business Register data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT