companieswise

---

询问大模型“公司 00445790 的注册名称和状态是什么？”，它会信心十足地回答——而且通常是错的：名称是编造的，状态不正确，成立日期也是杜撰的。公司记录存在于 Companies House 登记簿中，而非模型的权重里。companieswise 会在官方 Companies House 快照中查询该编号，并返回真实的注册信息——如果查不到，也会如实说明*“未找到”*，而不是胡乱猜测。

⚠️ 请先阅读——数据说明

• 覆盖英国全境（英格兰和威尔士、苏格兰、北爱尔兰）。
• 每月更新的实时登记簿快照。公司状态截至数据集日期，并非实时状态——上周解散的公司可能仍显示为“Active”，直到下次快照更新；通常已解散的公司不会出现在快照中。要查询当前状态，请查看实时登记簿。
• **不构成建议。**不构成法律、财务、信用或 KYC/AML 建议，也不能替代法定尽职调查。

安装

{ "mcpServers": { "companieswise": { "command": "npx", "args": ["-y", "companieswise"] } } }

然后加载一次真实数据（软件包仅附带少量示例数据）：

npx -p companieswise companieswise-update

此操作会将最新的月度 Companies House 快照（约几十 MB）下载到本地缓存。需要刷新时可重新运行；GitHub Action 每月重建快照，因此 companieswise-update 始终会获取当月数据。在运行此命令之前，validate_company_number 可正常使用，而 lookup_company/search_company 会明确提示当前使用的是示例数据。

可选：实时模式（自带密钥）

默认情况下，companieswise 使用每月的快照（离线运行，无需密钥）。如果设置免费的 Companies House API key，则会切换为通过官方 Companies House API 进行实时查询——使用你自己的密钥获取登记簿的实时状态，包括已解散公司（不与他人共享速率限制）：

{
  "mcpServers": {
    "companieswise": {
      "command": "npx",
      "args": ["-y", "companieswise"],
      "env": { "COMPANIESWISE_CH_API_KEY": "your-companies-house-api-key" }
    }
  }
}

设置密钥后，lookup_company 和 search_company 会使用实时 API（结果标记为 "dataset": "live"）；未设置时则回退到快照（"dataset": "snapshot"），因此数据来源始终清晰。无论哪种模式，validate_company_number 都可离线运行。密钥只会发送到官方 Companies House API。CH_API_KEY 也可用作别名。

作为库使用

npm i companieswise

import { lookupCompany, validateCompanyNumber, searchCompany } from "companieswise";

validateCompanyNumber("SC123456");   // { valid: true, prefix: "SC", meaning: "Company registered in Scotland" }
validateCompanyNumber("6").number;   // "00000006" — normalises/zero-pads
lookupCompany("00000006");           // official name, status, type, incorporation date, postcode, SIC — or found:false
searchCompany("greggs");             // companies whose registered name contains your words

格式正确但未出现在快照中的编号会返回 found: false，并附上明确说明——绝不会捏造公司信息。

工具 — 3 个

工具	功能
lookup_company	根据编号查询公司的官方注册信息（名称、状态、类型、成立日期、注册邮政编码、主要 SIC）
validate_company_number	判断编号是否为格式正确的英国公司编号，并说明其前缀含义（仅验证格式——没有校验位）
search_company	反向查询——根据公司名称查找其编号

数据与每月自动刷新

数据来自 Companies House Free Company Data Product（覆盖英国全境的实时登记册），依据 Open Government Licence v3.0 发布。由于真实数据集约有 560 万家公司，远远超出可打包进 npm 软件包的大小，因此设计将代码与数据分开：

• 代码发布在 npm 上（体积很小）。
• 数据由 GitHub Action（.github/workflows/refresh-data.yml）每月构建：下载官方快照、编译成紧凑的构件，并将其作为 GitHub Release 资源发布。
• companieswise-update 会将该构件下载到本地缓存；每个响应都会报告其 datasetVersion（快照日期）。

无需 API 密钥、没有速率限制，也无需按请求付费——查询会在本地使用缓存的快照运行。关于原因以及托管式／实时路径，请参阅 ARCHITECTURE.md。

它不是什么

• 不是实时数据。 这是实时登记册的月度快照；状态以数据集日期为准。如需查询实时状态，请使用 Companies House API／网站。
• 不是完整登记册。 免费快照包含当前有效的公司；已解散的公司通常不在其中（缺失 ≠“从未存在”）。
• 不是建议，也不是法定的 KYC/AML 审查。
• 不会猜测——未知编号会如实返回“未找到”。

隐私

此工具在你的设备本地运行，其设计不会收集、存储或传输你的数据——没有分析、没有遥测，也无需账户。默认情况下，它会离线使用内置／缓存的数据；只有在你设置了 Companies House API 密钥时，它才会将你的查询和密钥直接发送到官方 Companies House API（绝不会发送给 Qiniso）。完整政策：https://qinisolabs.github.io/privacy.html。

许可证

Apache-2.0。公司数据 © Crown copyright、Companies House，依据 Open Government Licence v3.0 发布；详见 NOTICE。