swissreg

Name: swissreg
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords商业与营销01 周前更新

代码仓库

关于 swissreg

swissreg 是用于查询瑞士公共公司登记及相关数据的 MCP 服务和 CLI，面向研究人员与组织，提供只读结构化结果，涵盖公司记录、公告、采购、金融、LEI 和研究项目。

主要功能

01瑞士商业登记查询与搜索
02商业公报公告及公司事件
03公共采购项目与供应商资料
04FINMA 机构和 LEI 记录
05联邦资助的研究项目
06UID 校验与结构化 JSON 输出

适用场景

01按 UID 查询瑞士公司
02按日期范围查找公报公告
03查看公共招标和供应商状态
04追踪 LEI 关系或资助研究

MCP 相关

向 MCP 客户端提供九种只读工具，用于查询瑞士公司及公共登记数据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-swissreg": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/swissreg"
      ]
    }
  }
}

启动命令npx -y @reneturcios/swissreg

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/swissreg0.1.0stdio

ocighcr.io/cloudcorprecords/swissreg:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
lei	boolean	否	添加 LEI 字段（lei、lei_status、direct_parent、ultimate_parent）。默认为 false。
uid	string	是	公司的瑞士 UID，格式为 CHE-XXX.XXX.XXX（会剥除空格、点号和短横线，并验证校验位）。
finma_licence	boolean	否	添加 FINMA 许可证字段（finma_licence、finma_category、finma_city、finma_flags）。默认为 false。

详细介绍

swissreg

九个关于瑞士公司的只读查询，答案来自瑞士公开发布的登记册——核心查询路径无需账户，因为这些来源都是开放数据：通过 LINDAS 查询商业登记册、瑞士《商业公报》、simap 采购平台、FINMA 获授权机构名单、GLEIF 法人实体数据库，以及联邦 ARAMIS 研究数据库。

每个答案都采用相同的结构：一个 JSON 对象，包含 rows（每行都严格按照该工具文档规定的顺序携带相应字段）、count，以及说明数据来源限制的 notes——例如，缺少 LEI 是常态（只有约 28,000 家瑞士实体持有 LEI），或者公司无需拥有目录资料也能在 simap 上投标。

九个工具：

swissco_lookup — 按 UID 查询商业登记册发布的某家公司全部信息；还可选择添加其 FINMA 许可证字段和 LEI，以及合并该公司的母公司。
swissco_search — 搜索法定名称或章程宗旨中包含某个词语的公司；使用 LINDAS 路径时可按州和法律形式筛选。
swissco_publications — 查询指定日期范围内的《商业公报》公告，并在客户端按州、子类别、标题文本或事件类型筛选。
swissco_events — 查询某家公司的登记事件；仅保留公告自身 UID 与查询 UID 相符的事件。
swissco_tenders — 按日期范围、州和公告类型查询在 simap 上发布的公共采购项目。
swissco_vendor — 查询某家公司是否有 simap 供应商资料，以及该资料包含哪些信息。
swissco_finma — 查询 FINMA 获授权银行和证券公司的名单，可按名称、UID、许可证类型和监管类别筛选。
swissco_lei — 查询某家公司的 LEI、合并该公司的实体、该层级关系的最顶层实体，以及可选的合并子公司。
swissco_research — 查询联邦资助的研究项目（包括 Innosuisse 和 SNSF 资助），可按文本或参与方 UID 搜索提及某家公司的项目。

瑞士 UID 会经过严格校验：UID 会先标准化（CHE444420929、CHE-444.420.929 和小写形式都有效），并在发出任何请求前验证其模 11 校验位；输出的 UID 始终采用 CHE-XXX.XXX.XXX 格式。日期格式为 YYYY-MM-DD；如果《商业公报》无法提供整个日期范围的数据，就会将范围截短至最新日期，并附注说明。

配置

无需凭据。以下两项为可选配置：

export ZEFIX_USER="..."        # Zefix PublicREST account
export ZEFIX_PASSWORD="..."

设置后，swissco_search 可以通过 via: "rest" 运行（支持名称前缀搜索并返回更丰富的字段）；未设置时，该路径会明确报错并指出所需的两个变量。其他登记查询通过 LINDAS 执行，并会注明凭据可以额外提供哪些信息：资本、状态、曾用名和公司关系。

CLI

每个工具都是一个子命令，接收一个 JSON 参数字符串：

npx @reneturcios/swissreg swissco_lookup '{"uid":"CHE-444.420.929","lei":true}'
npx @reneturcios/swissreg swissco_search '{"term":"pharma","canton":"BS"}'
npx @reneturcios/swissreg swissco_tenders '{"pub_types":["award"],"cantons":["ZH"]}'
npx @reneturcios/swissreg --version

输出为工具的 JSON 结构。退出代码：成功时为 0，运行时错误（包括验证错误或上游服务失败）时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/swissreg mcp

MCP 客户端配置：

{
  "mcpServers": {
    "swissreg": {
      "command": "npx",
      "args": ["-y", "@reneturcios/swissreg", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/swissreg
docker run --rm ghcr.io/cloudcorprecords/swissreg swissco_finma '{"licence_type":"Bank"}'

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch + fake clock, no network)
npm run dev     # run the CLI from source