eu-registry

@czagents/eu-registry

在一个 MCP 中查询欧洲企业注册信息——通过官方国家注册机构以及 GLEIF/LEI + VIES，核验 16 个欧盟/欧洲经济区国家的企业。9 个国家提供完整的国家级数据；立陶宛提供部分 JAR 数据；其他 6 个国家提供身份与所有权基线信息。包括实体状态、注册信息、地址、母公司解析和欧盟 VAT 验证。可直接在 AI 助手中开展跨境尽职调查和 KYC。

属于 cz-agents 套件。

支持的注册机构

完整的国家级数据（实体、状态、地址、注册日期）：

国家	来源	备注
GB	Companies House	需要从 developer.company-information.service.gov.uk 获取免费的 CH_API_KEY
SK	ORSR / RPO	无需身份验证
PL	KRS	无需身份验证
FR	SIRENE	无需身份验证
NO	Brønnøysund (BRREG)	无需身份验证
DK	CVR (Erhvervsstyrelsen)	可选 DK_CVR_USER/DK_CVR_PASS（免费，可发送请求至 [email protected] 获取）；否则使用公共备用数据源
FI	PRH YTJ Open Data v3	免费，无需 API 密钥，CC BY 4.0
EE	RIK open data dump	通过 EE_RIK_DB_PATH 每日批量导入到本地 SQLite；无需 API 密钥，CC BY 4.0
SE	Bolagsverket HVD API	从 Bolagsverket 获取免费的 OAuth 凭据；支持精确的组织编号查询。名称搜索使用 GLEIF/LEI，因为 HVD 没有名称搜索接口。

部分国家注册机构数据：立陶宛

国家	来源	备注
LT	Registrų centras JAR open data	通过 LT_JAR_DB_PATH 每月导入到本地 SQLite；CC BY 4.0。名称、代码和注册日期来自 JAR。官方法律状态分类标签以 status_label 的形式提供；应用程序的 status 仍为未知，normalized_status 为 null。不发布或补充地址和高管信息；JADIS 及其他数据补充不在范围内。如果本地存储不可用或没有匹配记录，则回退到 VIES/GLEIF。

身份与所有权基线信息（名称、地址、状态、VAT 有效性、GLEIF/LEI 母公司解析——不含高管/董事会数据；适用于需要付费访问的注册机构）：

国家	来源	备注
DE	GLEIF/LEI + VIES	无需身份验证
NL	GLEIF/LEI + VIES	无需身份验证
IT	GLEIF/LEI + VIES	无需身份验证
AT	GLEIF/LEI + VIES	无需身份验证
ES	GLEIF/LEI + VIES	对于 ES，VIES 仅返回有效性（不含名称/地址）
BE	GLEIF/LEI + VIES	无需身份验证

工具

每个示例都是一个 MCP 工具调用参数对象。

• search_company — 按完整或部分公司名称搜索支持的非捷克注册机构。若已有确切的国家 ID，或对于仅支持 GLEIF 的国家需要完整的国家级数据，请勿使用。示例：{"name":"Tesco","country":"GB","limit":5}。
• get_company — 按国家 ID 和国家代码获取受支持的非捷克公司信息。请勿用于捷克公司，也不要用名称代替对应国家的标识符。示例：{"id":"14356670","country":"GB"}。
• lookup_company_by_vat — 通过 VIES 验证欧盟 VAT 号码，并返回公开的注册信息。请勿用于获取董事/董事会数据，也不要假设每个成员国都能提供名称/地址。示例：{"vat":"NL123456789B01"}。

配置

变量	必填	描述
CH_API_KEY	否	英国 Companies House API 密钥。未设置时，GB 适配器会返回空结果。
GLEIF_CACHE_PATH	否	GLEIF 响应的 SQLite 缓存文件路径（DE/NL/IT/AT/ES/BE/LT）。未设置时会回退到内存缓存。
GLEIF_CACHE_TTL_DAYS	否	缓存 TTL（天）。默认值：7。
DK_CVR_USER / DK_CVR_PASS	否	丹麦 CVR 数据凭据（免费，可发送邮件至 [email protected] 申请）。未设置时，DK 适配器会使用公开备用方案。
EE_RIK_DB_PATH	否	爱沙尼亚 RIK 批量数据的 SQLite 存储路径。默认值：./ee-rik.db。
LT_JAR_DB_PATH	否	立陶宛 Registrų centras JAR 开放数据的 SQLite 存储路径。默认值：./lt-jar.db。
SE_BOLAGSVERKET_CLIENT_ID / SE_BOLAGSVERKET_CLIENT_SECRET	否	瑞典 Bolagsverket HVD OAuth 凭据。未设置时，精确的 SE 查询不会返回结果；名称搜索仍会使用 GLEIF。
PORT	否	HTTP 传输端口。默认值：3036。

使用方法

npx（stdio 传输）

{
  "mcpServers": {
    "eu-registry": { "command": "npx", "args": ["-y", "@czagents/eu-registry"] }
  }
}

托管端点（无需安装）

{
  "mcpServers": {
    "eu-registry": { "url": "https://eu-registry.cz-agents.dev/mcp" }
  }
}

相关软件包

• @czagents/ares — 捷克 ARES 商业注册信息
• @czagents/dd — 捷克尽职调查聚合器（Compliance 层级包含 get_eu_parent 和 get_eu_dd_report）
• @czagents/sanctions — EU FSF + OFAC 制裁筛查

开发

npm run build
npm test
npm run start:http

爱沙尼亚批量导入：

EE_RIK_DB_PATH=/absolute/path/ee-rik.db npm run build --workspace=@czagents/eu-registry
EE_RIK_DB_PATH=/absolute/path/ee-rik.db npm run ingest:ee-rik --workspace=@czagents/eu-registry

立陶宛 JAR 批量导入（每月运行）：

LT_JAR_DB_PATH=/absolute/path/lt-jar.db npm run build --workspace=@czagents/eu-registry
LT_JAR_DB_PATH=/absolute/path/lt-jar.db npm run ingest:lt-jar --workspace=@czagents/eu-registry

如果可用，LT 结果会将上游的 Last-Modified 值作为 source_snapshot_at 提供，并单独提供 ingested_at，同时注明 CC BY 4.0 署名信息。官方 JAR 开放数据端点显示，pilnas_adresas 和 adresas 的非空值均为零；因此，实现始终不返回地址，并标记为“开放数据中未公布地址”。它不会获取 JADIS、管理人员信息或源自 GLEIF 的地址。