Openregistry

OpenRegistry——全球首个可直接从世界各地官方政府注册机构获取实时公司申报数据的 MCP 和 API

通过 MCP 实时直接访问约 80 多个官方政府注册机构未经修改的数据和原始申报文件。

工具：搜索公司、获取公司资料、管理人员、股东、押记、申报文件和财务报表文档。

覆盖英国 Companies House、爱尔兰 CRO、法国 RNE、西班牙 BORME、意大利 InfoCamere、挪威 Brreg、波兰 KRS、荷兰 KVK、比利时 KBO、瑞士 Zefix、芬兰、捷克、韩国、台湾、新西兰、开曼群岛、澳大利亚、加拿大等众多地区。

提供免费套餐；付费密钥可获得更高配额和更多数据。

数据获许可自 🇬🇧 UK Companies House · 🇮🇪 CRO Ireland · 🇳🇴 Brønnøysund · 🇨🇭 Zefix · 🇵🇱 KRS Ministry of Justice — 以及更多来源。

**上图：**一个 AI Agent 深入追踪 Iceland Foods Ltd 的股东，跨越 4 家英国控股公司——WD FF MIDCO → ICELAND VLNCO → LANNIS → WD FF LIMITED——并找出实际拥有该连锁企业的 8 位个人（最大股东 Tarsem Dhaliwal 持股 41.35%，Walker 家族合计持股 51.31%）。所有股份数量和百分比均逐字读取自注册机构自己的 CS01 PDF。

**我们返回注册机构自己的响应，不做任何修改。**政府系统输出的每个字段名称、每个状态值以及每个原始申报文件字节（XHTML iXBRL / PDF / XBRL）都原样保留。借助标识符和司法管辖区路由信息，你可以还原任意记录对应的政府 URL。没有聚合平台标记。不会重命名字段。不会重新渲染文档。不会由 AI 重新解读。没有过期缓存。

在单个提示词中跨境串联查询——英国 Ltd → 其卢森堡 SARL → 其开曼 LP → 泽西信托 → 个人受益人，在一次对话中完成。沿着 80 多个司法管辖区的所有权结构追踪，揭示任何公司背后的真实个人。

托管端点：https://openregistry.sophymarine.com/mcp

由 Sophymarine 打造的平台。

6 大支柱

1. 实时	每次工具调用都会在你发起请求时，实时查询上游政府注册机构 API。
2. 直连政府	没有聚合商、没有第三方数据仓库、没有夜间抓取。你的 AI 会直接与英国 Companies House、法国 INSEE、德国 Registerportal、韩国 FSS OpenDART 通信。
3. 原样返回 + 来源可追溯	每个字段名称、每个状态码、每个原始申报字节都按原样返回。保留注册机构自身的标识符，因此每条响应都能追溯到政府记录。企业版会额外提供预先合成的 source_url / registry_url / data_license 字段。
4. 零过期	我们控制的缓存层绝不会过期。政府记录更新的那一刻，你就能看到更新。相比之下，商业数据提供商提供的快照通常会滞后 6-24 小时。
5. 稳定	生产级可靠性，运行于 Cloudflare Workers 全球边缘网络，并为有状态的注册机构配备常驻的按司法管辖区划分的工作进程池。
6. 跨境	在一条提示词中串联查询 80 多个注册机构。无需离开对话，即可沿着 UK Ltd → LU SARL → KY LP → 个人进行追踪。

OpenRegistry 有何不同

	OpenRegistry	OpenCorporates	Companies House API 直连	Bureau van Dijk Orbis
覆盖范围	80 多个国家注册机构	约 140 个，主要聚合自上游来源	仅英国	约 4.3 亿家公司，经过聚合
数据新鲜度	实时 — 每次调用都会访问上游	抓取并缓存（滞后数小时至数天）	实时	每 7 天至每季度刷新一次
字段格式	上游原样载荷 + 统一封装	规范化为 OC 自有架构	各注册机构分别采用 CH 架构	BvD 自有架构
保留来源标识符	是 — 可根据响应还原注册机构 URL	OC ID 为主标识；映射回来源时会丢失信息	原生	BvD ID 为主标识
申报 PDF / iXBRL 字节	原始返回	仅元数据；完整字节需付费	原生	需付费
跨境链式追踪	一条 MCP 提示词，覆盖 ≤80+ 个司法管辖区	需手动拼接各国 ID	不在范围内（仅英国）	仅限由 BvD 掌握的实体
身份验证	OAuth 2.1 + DCR	API 密钥（需注册）	API 密钥（需注册）	按席位授权，每年 $30k–$50k+
面向 AI Agent 打造	原生支持 MCP，通过 Streamable HTTP 使用 JSON-RPC	REST；无 MCP 封装	REST；无 MCP 封装	REST；无 MCP 封装

一句话概括。 OpenCorporates 和 BvD 是会重新整理数据并进行缓存的聚合商；CH 直连仅覆盖单一司法管辖区。OpenRegistry 是 AI Agent 与原始政府 API 之间的桥接层——原样、实时、覆盖多国，免费版无需 API 密钥。

对于 OpenRegistry 刻意不提供数据的情形，响应会包含一个结构化的 alternative_url，指向仅供负有反洗钱义务者使用的法定门户。我们不会假装拥有自己并没有的数据。

快速调用示例

以下提供最常用工具的 3 个完整请求 → 响应示例。3 个示例都可在免费版中复现。调用使用 MCP Streamable HTTP 上的 JSON-RPC，地址为 https://openregistry.sophymarine.com/mcp；为简洁起见，我们只展示工具名称、参数和未封装的响应。

1. search_companies — 查找一家英国公司

// Request
{
  "name": "search_companies",
  "arguments": { "jurisdiction": "GB", "query": "Monzo Bank", "limit": 5 }
}

// Response (truncated to 1 result)
{
  "jurisdiction": "GB",
  "count": 5,
  "results": [
    {
      "jurisdiction": "GB",
      "company_id": "09446231",
      "company_name": "MONZO BANK LIMITED",
      "status": "active",
      "incorporation_date": "2015-02-06",
      "registered_address": "Broadwalk House, 5 Appold Street, London, England, EC2A 2AG",
      "jurisdiction_data": {
        "company_number": "09446231",
        "company_status": "active",
        "company_type": "ltd",
        "date_of_creation": "2015-02-06",
        "title": "MONZO BANK LIMITED",
        "address_snippet": "Broadwalk House, 5 Appold Street, London, England, EC2A 2AG",
        "kind": "searchresults#company",
        "links": { "self": "/company/09446231" }
        // ... 20+ verbatim CH fields
      }
    }
  ]
}

2. get_persons_with_significant_control — 查询已知公司的英国 PSC

// Request
{
  "name": "get_persons_with_significant_control",
  "arguments": { "jurisdiction": "GB", "company_id": "OC404063" }
}

// Response
[
  {
    "jurisdiction": "GB",
    "psc_id": "...",
    "name": "[REDACTED — UK CH residential-address suppression]",
    "kind": "individual-person-with-significant-control",
    "nature_of_control": ["ownership-of-shares-25-to-50-percent"],
    "notified_on": "2024-08-15",
    "is_active": true,
    "jurisdiction_data": {
      "etag": "...",
      "natures_of_control": ["ownership-of-shares-25-to-50-percent"],
      "notified_on": "2024-08-15",
      "country_of_residence": "United Kingdom",
      "date_of_birth": { "month": 7, "year": 1985 },
      "address": { "country": "United Kingdom" },
      "links": { "self": "/company/OC404063/persons-with-significant-control/individual/..." }
      // ... full CH PSC record
    }
  }
]

PSC ≠ 股东。 英国 Companies House 发布结构化的 PSC 登记册，以及一份单独的（仅包含申报信息的）股本声明。两者内容并不一致：持有 10% 股份的股东会出现在股本声明中，但不会出现在 PSC 登记册中；公司受托人会出现在 PSC 登记册中，却不一定是股东。我们分别通过 get_persons_with_significant_control 和 get_shareholders 提供这两类信息——请参阅股东与 PSC 案例研究。

3. fetch_document — iXBRL 年度账目的原始字节

// Request — get the document_id from list_filings or get_financials first
{
  "name": "fetch_document",
  "arguments": { "document_id": "MzQ0MTUyNDU5N2FkaXF6a2N4", "max_bytes": 5000000 }
}

// Response (metadata + base64-encoded body)
{
  "jurisdiction": "GB",
  "document_id": "MzQ0MTUyNDU5N2FkaXF6a2N4",
  "content_type": "application/xhtml+xml",
  "size_bytes": 348721,
  "encoding": "base64",
  "content": "PCFET0NUWVBFIGh0bWwgUFVCTElDIC...",
  // signed proxy URL for human download / out-of-band fetch
  "proxy_url": "https://openregistry.sophymarine.com/document/gb/MzQ0MTUyNDU5N2FkaXF6a2N4/content?token=..."
}

content 是 Companies House 发送的原始 iXBRL 字节——AI Agent 可按需解析或重新渲染。我们不会重新编码、规范化标签，也不会将数字提取到自有架构中。传入 format: "png"（需要 Browser Rendering），即可接收扫描版 PDF 按页栅格化后的渲染结果。

配额、错误和退避

OpenRegistry 会通过结构化响应呈现三种不同类型的失败，以便 AI Agent 据此分支处理。

速率限制

匿名用户按 IP 限制，已登录用户按用户限制。跨境扇出上限是独立的计数器，用于限制调用方在滚动 60 秒窗口内通过 search_companies 查询的不同司法管辖区数量。

超过任一限制时，响应为 HTTP 429：

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32000,
    "message": "rate-limited",
    "data": {
      "reason": "rate-limited",
      "retry_after_ms": 12400,
      "scope": "ip"           // or "user" or "fanout"
    }
  }
}

HTTP 层还会设置标准的 Retry-After: 13 标头（秒，向上取整）。请严格遵守 retry_after_ms——无需再叠加指数退避；限制窗口采用固定滚动方式，而非自适应方式。扇出上限（scope: "fanout"）采用 60 秒滚动窗口——最早查询的国家/地区一旦移出窗口，即可查询新的国家/地区。Pro 层级上限为每 60 秒 10 个不同国家/地区，Max 为 30 个，Enterprise 不设上限。

法定访问限制（CJEU C-37/20 及类似情况）

CJEU C-37/20 判决之后，部分受益所有权登记系统仅限负有反洗钱义务的实体访问（DE、ES、IT、NL、LU、AT、MT、PT）；开曼《受益所有权透明法》也有类似限制。我们不会代理访问这些登记系统——工具会返回 HTTP 501 和结构化指引：

{
  "jurisdiction": "DE",
  "error": "not_proxied_by_design",
  "reason": "CJEU-C-37-20",
  "alternative_url": "https://www.transparenzregister.de",
  "alternative_access": "AML-obliged entities only (banks, lawyers, notaries, etc.)",
  "human_message": "The German Transparency Register is statutorily gated since 22 Nov 2022."
}

这是设计如此的响应，并非暂时性故障——重试无济于事。alternative_url 是法定官方入口，符合条件的实体可在此注册以获取访问权限。

上游错误和工具级结构化 501 错误

上游登记系统发生故障时，我们会原样呈现其错误，并附上结构化包装：

{
  "jurisdiction": "ES",
  "error": "upstream_error",
  "upstream_status": 524,
  "human_message": "Spain BORME upstream timed out (Madrid bulletin renderer slow). Retry in 30-60s.",
  "retry_after_ms": 45000
}

建议的客户端退避策略

错误	操作
429 rate-limited	等待 retry_after_ms，然后重试一次。
429 fanout	不要重试相同调用；将下一个请求路由到窗口内已查询过的国家/地区。
501 not_proxied_by_design	不要重试。向用户显示 alternative_url。
501 alternative_tool_required	使用 alternative_tool + alternative_args 重新发起请求。
5xx upstream_error	如果存在 retry_after_ms，则等待相应时间；否则等待 30 秒。最多重试 3 次。
4xx not_found	不要重试。使用 search_companies 重新搜索，以查找有效 ID。

每份框架集成指南都在 /docs/integrations 下发布了退避策略参考实现。

开箱即用的技能

我们为最常见的 OpenRegistry 工作流发布了 10 个专业的 Claude Agent Skills。将它们放入 Claude Code 项目的 .claude/skills/ 目录，或放入任何兼容 Claude 的 Agent 中，即可按意图调用。

#	技能	一条提示词即可获得
1	KYC 与跨境尽职调查	完整的法定档案：概况 + 董事 + 最终受益所有人（UBO）+ 股东 + 抵押事项 + 最新账目
2 ⭐	跨境 UBO 链条追踪器	跨司法管辖区追踪所有权链，直至找到真实个人
3	董事搜索与 PEP 筛查	某人担任过董事的所有公司 + 联合董事关系网络
4	实时公司账目与 XBRL 财务数据	最新法定账目，提供机器可读的 XBRL / iXBRL / PDF 格式 + 关键数据
5	公司申报监控与事件提醒	指定时间范围内的重要申报，分类并标记
6	全球公司名称可用性检查	一个名称是否可在 10+ 个国家/地区注册？
7	行业与竞争对手公司搜索	在 N 个司法管辖区内查找某行业的所有公司，并进行排名和信息补全
8	空壳公司检测器	标记仅有 1 名董事 + 无账目 + 海外办公室的空壳公司（AML 信号）
9	凤凰公司雷达	检测解散后重生的欺诈模式（同一董事、同一地址）
10	行业准入把关名单	所有获得 CIMA / FCA / BaFin / FSS 许可的受监管实体

请参阅 skills/README.md 了解技能包概览。

同样的 10 个工作流，也提供为 MCP 提示词

上述每项技能也由 MCP 服务作为具名提示词提供，因此任何兼容 MCP 的客户端（Claude Desktop、Cursor、Cline、Goose、Zed 等）都能在提示词选择器中显示它们，无需安装技能文件。调用 prompts/list 发现提示词，调用 prompts/get 使用提示词。名称相同：kyc_cross_border_due_diligence、ubo_cross_border_chain_walker、director_search_pep_screening、live_company_accounts_xbrl、corporate_filing_monitor、global_company_name_availability、industry_competitor_search、shell_company_detector、phoenix_company_radar、sector_gatekeeper_list。

连接

OpenRegistry 兼容所有主流支持 MCP 的客户端。同一个 https://openregistry.sophymarine.com/mcp 端点适用于所有客户端。

Claude Desktop

设置 → 连接器 → 添加自定义连接器 → 粘贴 https://openregistry.sophymarine.com/mcp。

对于没有“连接器”界面的旧版构建，请添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "openregistry": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://openregistry.sophymarine.com/mcp"]
    }
  }
}

Claude Code

claude mcp add --transport http openregistry https://openregistry.sophymarine.com/mcp

在 Claude Code 2.1.1+ 中，也可以使用 JSON 格式：

claude mcp add-json openregistry '{"type":"http","url":"https://openregistry.sophymarine.com/mcp"}'

Gemini CLI

通过此仓库中的 gemini-extension.json 清单一键安装：

gemini extensions install https://github.com/sophymarine/openregistry

或者手动添加到 ~/.gemini/settings.json（Gemini 使用 httpUrl，而不是 url）：

{
  "mcpServers": {
    "openregistry": {
      "httpUrl": "https://openregistry.sophymarine.com/mcp"
    }
  }
}

Google 面向消费者的 Gemini 应用（gemini.google.com）目前不支持自定义 MCP，只有 CLI 和 Gemini Enterprise（Google Cloud 管理路径）支持。

ChatGPT

仅限 Plus / Pro / Business / Enterprise / Education 计划（免费版不提供开发者模式）。

1. 设置 → 应用和连接器 → 高级设置 → 启用开发者模式。
2. 在连接器页面，点击创建并粘贴 https://openregistry.sophymarine.com/mcp。

请参阅 OpenAI 的开发者模式帮助文章。

Perplexity

仅适用于 Pro / Max / Enterprise 方案。设置 → 连接器 → 添加自定义远程连接器 → 粘贴 URL → 选择 OAuth。可用于常规聊天、Comet 浏览器和 Computer Agent 工作流。(更新日志 2026-03-13。)

Cursor

或者手动添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "openregistry": {
      "url": "https://openregistry.sophymarine.com/mcp"
    }
  }
}

VS Code (1.101+, Copilot Agent 模式)

或者添加到 .vscode/mcp.json（工作区）或用户设置 → MCP。VS Code 使用 servers（而非 mcpServers），并要求设置 type: "http"：

{
  "servers": {
    "openregistry": {
      "type": "http",
      "url": "https://openregistry.sophymarine.com/mcp"
    }
  }
}

GitHub Copilot 在 JetBrains、Visual Studio、Xcode 和 Eclipse 中也支持通过相同的 mcp-config.json 模式使用自定义 MCP — IDE 专属设置请参阅 docs.github.com/copilot。Copilot CLI 使用 ~/.copilot/mcp-config.json 或交互式 /mcp add 命令。

Microsoft 365 Copilot (Word / Excel / PowerPoint / Teams / Outlook)

通过 Microsoft Copilot Studio Agent 路径进行组织级部署。需要 Microsoft 365 Copilot 许可证。

1. 在 Microsoft Copilot Studio 中，打开或创建一个 Agent → 工具 → 添加工具 → 新建工具 → Model Context Protocol。
2. 粘贴 https://openregistry.sophymarine.com/mcp，然后在 身份验证 中选择 OAuth 2.0 → 动态发现（OpenRegistry 通过发现机制实现 DCR — 无需配置）。
3. 发布 Agent 并提交管理员审批。Global / Teams Admin 在 Microsoft 365 管理中心批准后，该 Agent 会显示在 Teams、Outlook、Word、Excel 和 PowerPoint 中的 Agent Store。

请参阅 Microsoft 的 Copilot Studio MCP 文档和 Agent Store 指南。

Cline

设置 → Cline → MCP 服务 → 编辑设置 → 粘贴到 cline_mcp_settings.json：

{
  "mcpServers": {
    "openregistry": {
      "url": "https://openregistry.sophymarine.com/mcp",
      "transport": "streamable-http"
    }
  }
}

自动化的 LLM 驱动安装请参阅 llms-install.md。

Windsurf

Cascade 面板 → 锤子图标 (🔨) → 配置，打开 ~/.codeium/windsurf/mcp_config.json。添加此代码块（注意 Windsurf 使用 serverUrl，而非 url），然后点击 刷新 (🔄)：

{
  "mcpServers": {
    "openregistry": {
      "serverUrl": "https://openregistry.sophymarine.com/mcp"
    }
  }
}

其他支持 MCP 的客户端

Zed、Goose、Continue 及其他任何 MCP 2025-06-18 客户端均可使用标准配置：

{
  "mcpServers": {
    "openregistry": {
      "url": "https://openregistry.sophymarine.com/mcp"
    }
  }
}

根据 MCP 规范 2025-06-18使用 Streamable HTTP 传输。采用 OAuth 2.1 授权流程（通过 RFC 7591 进行动态客户端注册 — 无需粘贴 API 密钥）。

AI Agent 框架（代码示例）

每个主流 Agent 框架都提供通用的 MCP 适配器，因此 OpenRegistry 的 27 个工具和 10 个提示词工作流无需编写任何框架专属代码即可接入。每个框架的最小可用示例：

• LangChain / LangGraph（Python）→ openregistry.sophymarine.com/docs/integrations/langchain
• LlamaIndex（Python）→ /docs/integrations/llamaindex
• CrewAI（Python）→ /docs/integrations/crewai
• Haystack（Python）→ /docs/integrations/haystack
• AutoGen（Microsoft）（Python）→ /docs/integrations/autogen
• Vercel AI SDK（TypeScript）→ /docs/integrations/vercel-ai-sdk

数据来源与可审计性

每个响应都会保留上游注册机构的标识符，以便核验任何事实是否与政府记录相符：

• jurisdiction + company_id → 重建政府 URL（例如 https://find-and-update.company-information.service.gov.uk/company/09446231）
• document_id → 政府自己的备案标识符，可据此回溯至其门户网站
• jurisdiction_data → 保留所有字段名称的原始上游对象
• 备案文件（XHTML iXBRL / PDF / XBRL）以原始字节形式返回，不会重新渲染

企业版会预先将 source_url / registry_url / registry_name / data_license / alternative_url 合成到每个响应中，以便在合规报告中一键审计追踪。

安全与合规

• 身份验证：OAuth 2.1 + PKCE、无密码电子邮件魔法链接、RFC 7591 动态客户端注册。无需预共享 API 密钥。
• 隐私：OpenRegistry 代理官方公共注册机构的数据。
• 速率限制：经过身份验证的流量按用户限制，匿名流量按 IP 限制；此外还设有所有用户共享的按司法管辖区划分的上游保护上限，确保 OpenRegistry 能够善待我们所依赖的注册机构。

支持

• 托管应用 + 账户管理：openregistry.sophymarine.com/account
• 工具能力矩阵：调用 list_jurisdictions 或访问 openregistry.sophymarine.com/jurisdictions
• 企业咨询 / 合作伙伴关系：https://sophymarine.com/about/contact-us
• 状态 + 正常运行时间：openregistry.sophymarine.com/status
• 本仓库仅包含文档。OpenRegistry 服务实现为闭源；请在此提交与集成体验（文档、示例、安装流程）相关的问题。

安全

发现漏洞？请使用我们的联系表单，不要公开提交问题。完整的报告政策、范围和免责条款请参阅 SECURITY.md。

行为准则

参与本项目须遵守我们的行为准则，该准则改编自 Contributor Covenant 2.1。请将问题报告至 [email protected]。

贡献

欢迎提交以下方面的问题和拉取请求：

• 桥接程序错误（server.mjs）
• 文档改进（README、llms-install.md、GEMINI.md）
• 技能 / 提示词优化（skills/、commands/、.claude-plugin/）
• 品牌素材和元数据（brand/、glama.json、.mcp.json、gemini-extension.json）

OpenRegistry 服务实现（司法管辖区适配器、MCP 服务、计费、身份验证）为闭源内容，不接受通过 PR 提交的修改。若要针对托管服务提出工具 / 行为方面的需求，请提交问题并说明使用场景。

更新日志

带标签的版本发布于 GitHub Releases 页面。版本遵循 SemVer：修订版本用于修复，次要版本用于新增内容，主要版本用于对桥接协议或工具接口约定进行不兼容变更。

许可证

本仓库中的文档、技能和品牌素材采用 CC-BY-4.0 许可发布——注明出处后，你可以出于任何目的分享和改编这些内容。为保持一致，openregistry stdio 桥接（server.mjs）也采用 CC-BY-4.0 许可发布。托管 MCP 服务的实现并非开源，并按照单独的商业条款运营；请参阅 服务层级 部分。

第三方署名信息请参阅 NOTICE.md。

---

OpenRegistry 是 Sophymarine 的平台。

© 2026 Sophymarine。OpenRegistry 和 Sophymarine 是 Sophymarine 的商标。本仓库中的文档依据 CC-BY-4.0 许可发布。