companieswise

---

LLM に「会社 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 はサンプルデータを使用していることを明示します。

オプション：ライブモード（API キーを用意）

デフォルトでは、companieswise は月次スナップショットを提供します（オフライン、API キー不要）。無料の Companies House API キーを設定すると、代わりに公式の Companies House API に対してライブクエリを実行します。独自の API キーを使うため、共有レート制限はありません。解散済みの会社を含む、登記簿のリアルタイムのステータスを取得できます。

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

API キーが設定されている場合、lookup_company と search_company はライブ API を使用し（結果には "dataset": "live" とタグ付けされます）、設定されていない場合はスナップショットにフォールバックします（"dataset": "snapshot"）。そのため、どちらのデータを取得したかは常に明確です。validate_company_number はどちらの場合もオフラインで動作します。API キーは公式の 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 を参照してください。