Regon Pl

@pipeworx/regon-pl

波兰企业登记簿（REGON / BIR1.1）——通过 NIP、 REGON 或 KRS 编号查询任意波兰公司，获取其注册名称、法定地址和实体类型，数据来自 波兰统计局的官方登记簿。

属于 Pipeworx——一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

• regon_search_nip({ nip, environment, _apiKey }) — 按税务识别号查询。
• regon_search_regon({ regon, environment, _apiKey }) — 按 9 位或 14 位 REGON 统计编号查询。
• regon_search_krs({ krs, environment, _apiKey }) — 按国家法院登记簿编号查询。

这三个工具均会返回注册名称、另外两个标识符、实体类型 （法人 / 个体经营者 / 地方单位）、省、县、市镇、 地区、邮政编码和注册地址。

身份验证

平台密钥（PLATFORM_REGON_KEY），支持通过 ?_apiKey= 使用自带密钥覆盖，另有 无需凭据的测试路径。

• environment: "production"（默认）——实时登记簿。需要 API 密钥。可在 https://api.stat.gov.pl/Home/RegonApi 免费注册；GUS 会签发 20 个字符的用户密钥。
• environment: "test" ——GUS 自己提供的公开测试服务，使用 GUS 在文档中公布的测试密钥。无需凭据且会返回真实响应，但数据来自一个固定的小型测试数据库（地址显示为「ul. Test-Wilcza」）。 可用它检查响应格式，但切勿用它核实真实公司的信息。 该服务的每个响应都包含一个 disclaimer 字段，说明这一点。

数据源

• https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc — 生产环境 BIR1.1。
• https://wyszukiwarkaregontest.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc — 测试环境 BIR1.1。

注意事项

• 使用 SOAP 1.2 over MTOM，而非 REST。 每次查询需要调用两次：Zaloguj 使用用户密钥换取会话 ID，然后搜索请求携带该 ID。
• 会话 ID 必须放在 HTTP sid 标头中，而不是 SOAP 信封中。 若将其放进信封，服务会把你视为未通过身份验证的用户，并在不返回错误的情况下给出空结果。
• 无匹配结果并非空文档。 返回的是一条已填充的 <dane> 记录，其中唯一的字段为 ErrorCode 4 和 ErrorMessageEn "No data found for the specified search criteria"。若直接解析，会得到一条所有字段均为 null 的结果——这是典型的静默零结果。此工具包会检测 ErrorCode，并通过 found: false 返回上游消息。
• 无法识别的用户密钥会得到空的 ZalogujResult，而非 HTTP 错误。此工具包会明确对此抛出异常。
• 响应采用 MIME multipart 格式，载荷是 SOAP 结果元素内经过 XML 转义的字符串——需要解包两次。
• 会话会在工作进程内存中缓存 30 分钟（上游允许约 60 分钟）。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/regon-pl/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 都会连接到同一个网关和相同的 1683+ 个数据源。唯一的区别是哪个工具包的工具会被直接列出；无论连接哪一个，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/regon_search_nip \
  -H 'Content-Type: application/json' \
  -d '{"nip":"7740001454","environment":"test"}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/regon_search_nip。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

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

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经由网关中转：

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

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

npx -y @pipeworx/mcp-regon-pl

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

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Regon Pl data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT