Cro Ireland

@pipeworx/cro-ireland

爱尔兰法定公司登记册——每家注册公司的名称/编号/状态/类型/地址/注册成立日期——由 CRO（Companies Registration Office）作为开放数据发布。申报/提交历史通过 CRO 自有 API 实时单独查询（自备密钥）。

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

Fleet #3346，补齐了我们尚未覆盖的一个欧盟登记册缺口（Companies House、Brønnøysund、Estonia、Latvia、GLEIF 已上线）。2026-10-19 实时加载：827,248 条 ie_companies 记录，与载入清单中的表行数核对一致。

工具

• ie_search_companies(name, status?, limit?) -- 按公司当前注册名称的前缀搜索（例如，"Ryanair" 会找到“RYANAIR DESIGNATED ACTIVITY COMPANY”和“RYANAIR HOLDINGS PUBLIC LIMITED COMPANY”）。返回每个匹配项的 CRO 编号、状态、类型、注册地址、eircode 和注册成立日期。status 用于筛选登记册自身的某个状态 TEXT 值（如“Normal”“Dissolved”“Liquidation”等）——状态代码有 30 多种，开放数据已为每行提供人类可读的标签，因此此处按标签而非数字代码筛选。
• ie_get_company(cro_number) -- 根据 CRO 编号查询一家公司的信息：当前名称、状态、类型、注册地址、eircode、注册成立日期、最近/下次年度申报日期、最近账目日期，以及适用时的解散日期。若编号没有匹配项，会返回 found: false, reason: "not_held"，而不是一个没有说明的错误。
• ie_get_filings(cro_number, _apiKey, _apiSecret) -- 爱尔兰公司的申报/提交历史（年度申报、账目、押记等），通过 CRO 自有的 Open Services REST API 实时获取。需要你自己的 CRO Open Services 凭证（见“身份验证”）——其他两个工具读取的开放数据快照中不包含这些信息，只有 CRO 的实时受控访问 API 才提供。

身份验证

混合模式。ie_search_companies 和 ie_get_company 无需密钥——它们仅通过持有 D1 镜像的 Pipeworx 网关提供服务；单独执行 npm install 时没有可读取的数据，这些工具会明确报错“not bound in this runtime”，而不是返回空列表。

ie_get_filings 需自备密钥，平台不提供密钥。 CRO 的 Open Services API（services.cro.ie）要求提供 CustomerKey，且 CRO 只会在收到签署的 Open Services Terms & Conditions 后签发此密钥——2026-10-19 已实时验证：完全不提供凭证时，每个端点都会返回 401 Access denied. Invalid API credentials in Header.。这是一个合同流程（CLAUDE.md“我们将采购的内容”——是否接受供应商条款应由 Bruce 决定，而不是 Agent），因此此工具采用 BYOK：将你注册账户的电子邮件地址作为 _apiKey 传入，将 CRO 签发给你的 API 密钥作为 _apiSecret 传入。缺少其中任一项时，它会明确提示“CRO Open Services requires an API key”，而不会猜测或用其他数据代替。已提交一个 Needs Bruce 事项，待决定是否申请平台密钥。

数据源

• CRO（Companies Registration Office），Company Records 开放数据。许可协议：Creative Commons Attribution 4.0（CC BY 4.0）。由 CRO 在其自有开放数据门户按日发布快照，并根据爱尔兰《开放数据指令》指定为“高价值数据集”。确切的下载路径仅记录在 scripts/cro-ireland/refresh.sh 中（CLAUDE.md 第 9b 步）。
• CRO（Companies Registration Office），Open Services REST API（services.cro.ie）——实时提供，仅用于申报/提交。自备凭证；平台不提供密钥。

刷新镜像

bash scripts/cro-ireland/refresh.sh build   # download + build local SQLite; no remote writes
bash scripts/cro-ireland/refresh.sh load    # the above, then replace the D1 tables and verify

CRO 每天重新发布 Company Records 快照；请按相同频率运行此操作（手动执行，或在应用计划工作流后通过该工作流执行）。

架构

scripts/cro-ireland/schema.sql：ie_companies（每家公司一行）+ ie_meta（键值：data_as_of、source、licence）。必须与 src/store.ts 中的 CompanyRow 保持同步。

快速开始

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

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

此端点实际提供的内容

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

这是有意为之，并非意外的多路复用。元工具可以让限定范围的连接通过 ask_pipeworx（它会在整个目录中路由）回答此工具包不涵盖的问题，无需你添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义耗费的上下文超过路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是此工具包的工具：

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

两个 URL 都连接到同一个网关和同一批 1875+ 个数据源。唯一的区别在于直接列出的是哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

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

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

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

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

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

{
  "mcpServers": {
    "cro-ireland": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-cro-ireland"]
    }
  }
}

也可以直接运行，确认它能启动：

npx -y @pipeworx/mcp-cro-ireland

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具——不含上述网关连接额外提供的任何共享元工具。相同的源码，相同的工具，但不支持 ask_pipeworx 路由。

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Cro Ireland data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT