companies-house

Companies House CLI 和 MCP

通过终端、脚本或 AI 助手读取英国 Companies House 公共登记信息。搜索公司、查看公司记录、追溯所有权、获取申报文件，并下载已提交的文件本身。

所有操作都使用你自己的免费 API 密钥。没有托管后端、共享密钥或代理——请求直接从你的设备发送到 Companies House。

文档：companies-house.uk

选择使用方式

在 AI 助手中——Claude Code、Claude Desktop、Codex、Cursor、Zed：

npx -y companies-house-mcp

在客户端配置中设置 COMPANIES_HOUSE_API_KEY。各客户端的完整设置说明：companies-house.uk/mcp。

在终端中——使用 ch 命令：

npm install -g companies-house-cli
ch config set-key your-key-here
ch report 00445790

完整参考：companies-house.uk/cli。

在自己的服务上——可选的 Cloudflare Worker，可部署到你自己的账户中，让 Claude Code 能够远程访问。请参阅 companies-house.uk/self-hosting 或部署指南。

在 developer.company-information.service.gov.uk 免费获取 API 密钥，大约需要一分钟。

可以做什么

查找公司——按名称使用 search_companies / ch search 搜索，并按状态、类型、成立日期、所在地和 SIC 代码筛选。search_officers / ch search-officers 可在整个登记库中搜索相关人员。

查看公司记录——使用 get_company_profile / ch profile 查看状态、地址、SIC 代码和申报日期。使用 get_charges、get_insolvency、get_company_registers、get_exemptions 和 get_uk_establishments 查看其他信息。

追溯人员和所有权——使用 get_officers / ch officers 查看在任人员，使用 get_appointments 和 officer_network 查看某人的所有任职情况，使用 get_ownership / ch ownership 查看具有重大控制权的人士，并使用 get_officer_disqualifications 查看被取消资格的董事名册。

查看申报文件——使用 get_filings / ch filings 查看申报历史记录，使用 get_filing_document 详细查看某一份申报文件，并使用 download_filing_document / ch document 下载已提交的 PDF 文件本身。

一次了解全貌——company_report / ch report 可通过一次调用读取主要记录。due_diligence_check / ch check 会根据登记信息筛查公司，并报告审查人员需要关注的条目。

完整参数参考：companies-house.uk/tools。

本工具不是什么

Companies House 记录公司提交的信息。它会进行基本的完整性检查，但不会核实信息是否准确。

因此，这里的内容不构成核实、信用审查、制裁筛查、政治公众人物筛查或批准决定。due_diligence_check 是一份筛查摘要：它会告知你登记了哪些信息，以及哪些内容无法检查。它不会断定某家公司经营稳健。没有不利记录，并不代表不存在不利事项，只能说明没有任何不利事项被提交。

登记信息也不涵盖经营表现、诉讼，或由重大控制权人士制度之外的主体持有的实益所有权。根据《经济犯罪和企业透明度法》，现有董事和 PSC 的身份核验仍在逐步推行，因此某个姓名出现在登记信息中，并不意味着该姓名背后的人已通过身份核验。

你的密钥，你的数据

你的 API 密钥始终由你保管。CLI 会依次从 --key、COMPANIES_HOUSE_API_KEY 和 ~/.config/companies-house/config.json 读取密钥；该配置文件仅授予所有者权限。ch config show 只会显示密钥的最后四个字符。

除 Companies House 外，不会向任何地方发送数据。此工具不收集遥测数据。

Companies House 对每个密钥的限制为每五分钟 600 次请求。客户端会对请求排队，以遵守此限制；如果确实触及限制，只有在 Companies House 表示限制窗口即将重置时才会等待，否则会报告限制，而不会停滞。

官员记录包含公开登记册中公布的任职地址和出生日期。请将这些信息视为个人数据。

开发

git clone https://github.com/aicayzer/companies-house-mcp.git
cd companies-house-mcp
pnpm install && pnpm build && pnpm test:unit

请参阅 CONTRIBUTING.md。

免责声明

本项目与 Companies House 或英国政府无关联，也未获其认可。使用公开的 Companies House API。

许可

MIT