Hk Companies

@pipeworx/hk-companies

香港会社登録所（香港公司註冊處）のオープンデータ — 新たに設立、登録、または名称変更された会社のライブフィード。名称／BR 番号による検索と、HKEX ティッカーとの結合に対応しています。

Pipeworx の一部です。AI エージェントを1881以上のライブデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携、推奨、公開の関係にありません。

ツール

• hk_company_search({ name?, brn?, type?, since?, limit? }) — 会社名（英語または中国語、部分一致）または完全一致の BR 番号で検索します。BR 番号、英語名／中国語名、種類、設立日／登録日、名称変更日（該当する場合）、および名称から上場株式を特定できた場合は対応する HKEX ティッカーを返します。
• hk_company({ brn, since? }) — BR 番号を指定して、1社の全履歴（当初の設立／登録と名称変更（該当する場合））を検索します。
• hk_new_companies({ since?, type?, limit? }) — 指定日以降に新たに設立または登録された会社を、最新のものから順に返します。
• hk_company_name_changes({ since?, limit? }) — 指定日以降に登録名称を変更した会社を、最新のものから順に返します。

認証

認証キーは不要です。data.gov.hk と cr.gov.hk は公開されている、認証不要のオープンデータです。

データソース — 2026-09-07にライブで検証済み

会社登録所のオープンデータのランディングページ（cr.gov.hk/en/open-data/）は404であり、data.gov.hk のHTMLデータセット一覧はクライアント側でレンダリングされます（ページソース内の <a href> は0件）。そのため、実際のリソースURLは、登録所の組織スラッグを使って見つけた data.gov.hk のCKAN形式APIからのみ取得できます。

https://data.gov.hk/en-data/api/3/action/organization_show?id=hk-cr
https://data.gov.hk/en-data/api/3/action/package_show?id=hk-cr-crdata-list-newly-registered-companies-2526

このパッケージには、2024-12-30以降の毎週分、約350組のCSVリソースが掲載されています。

• https://www.cr.gov.hk/docs/wrpt/RNC063/RNC063L_YYYYMMDD.csv — 香港域内の会社（新規設立／本拠地移転／名称変更）
• https://www.cr.gov.hk/docs/wrpt/RNC063/RNC063F_YYYYMMDD.csv — 香港域外の会社（新規登録／本拠地移転／名称変更）

YYYYMMDD は対象週の月曜日です。各ファイルはその月曜日から翌日曜日までを対象とします。公開はおおむね1週間遅れます（2026年8月24日〜30日の週は9月2日に公開されました）。

このパックは、呼び出しごとに package_show から最新のリソース一覧を取得し（URLパターンの推測は行いません）、一致する可能性がある週のCSVだけを並行して取得します。1回の呼び出しにつき会社種別ごとに最大20週に制限されるため、1つのリクエストで上流への取得が数百件に膨れ上がることはありません。since が指定されていない場合、hk_company_search と hk_company は過去12週間を対象とします（データセット開始日の 2024-12-30 まで遡れます）。hk_new_companies と hk_company_name_changes は、最新公開週の7日前からを対象とします。

CSVの形式（それぞれ異なります — 両方のライブ取得で検証済み）

香港域内（RNC063L）：Seq, Current Company Name in English, Current Company Name in Chinese, BR Number, Date of Incorporation / Re-domiciliation Date, Date of Change of name — 英語名と中国語名は、すでに別々の列に分かれています。

香港域外（RNC063F）：Seq, Current Corporate Name / Other Corporate Name, Current Approved Name for Carrying on Business in H.K., BR Number, Date of Registration, Date of Change of name — 中国語名専用の列はありません。英語名と中国語名の両方を持つ香港域外の会社は、同じBR番号とSeqを持つ2つの物理行に分かれ、単一の「Current Corporate Name / Other Corporate Name」列に1行につき1つの名称が記載されています。このパックは、それらを2つの別会社として表示するのではなく、BR番号ごとに統合し（CJKテキストを name_zh に、それ以外を name_en に振り分けます）。

スコープの制限 — 調査で判明したものであり、推測ではありません

これは、Companies Registry が公開している唯一の企業レベルのオープンデータセットです。data.gov.hk にある同機関の残り3つのパッケージ（org hk-cr の crdata-stat-non-hk-companies、crdata-stat-local-companies-incorporated、crdata-stat-local-companies）は、会社ごとの記録ではなく、公開会社／非公開会社／保証有限会社の合計を示す月次集計件数です。最新のデータを確認しましたが、名前、BR 番号、住所の各フィールドは含まれていません。Inland Revenue Department（org hk-ird）の data.gov.hk 上のデータセットはゼロ件のため、Business Registration データにもオープン API はありません。

任意の香港企業について、登録住所やステータスを返すキー不要のオープン API はありません。これは Companies Registry の有料 Cyber Search Centre（ICRIS）サービスであり、オープンデータではなく、書類ごとの商用検索です。そのため：

• このパックでは、2024-12-30以降に新たに設立、登録、または社名変更された企業の名前または BR 番号を検索できます。
• この期間外の企業（既存企業の大半を含み、HKEX 上場の優良企業はすべて該当します）について、「<any company> の登録住所は何か」という質問には回答できません。その情報を提供するオープンソースは実際に存在しないためです。すべてのツールの説明にこの点を記載し、データが裏付けていない情報まで得られると呼び出し元が誤解しないようにしています。
• 当初の依頼では金貸業者と TCSP ライセンシーの登録簿も対象でしたが、どちらも data.gov.hk にオープンデータセットとして存在しません（CKAN API で「money lender」「TCSP」「trust company」「licensed money lenders」を検索し、該当がゼロ件であることを確認済みです）。そのため構築していません。

HKEX ティッカーとの紐付け

hk_company_search と hk_company は、@pipeworx/hk-stocks の hk_resolve_symbol が使用するものと同じ、キー不要の Yahoo Finance 検索エンドポイントを呼び出します（パック同士は実行時に相互呼び出ししないため、ここから直接呼び出します）。.HK で終わるシンボルに限定し、正規化した名前が完全一致した場合にのみティッカーを付与します（「Limited」／「Ltd」／「Co」／「Holdings」／「Group」と英数字以外の文字を除去）。曖昧な推測は行いません。実際には、この処理が行われることはまれです。このフィードに登場する企業は過去約20か月以内に新たに設立、登録、または社名変更された企業であり、HKEX 上場企業はほぼ常にそれより古いためです。

データの遅延

フィードの公開は約1週間遅れます。最新の公開週より後の日付を since に指定すると、count: 0 と、これが「新しい企業がない」のではなく公開の遅延であることを説明する data_lag_note フィールドが返されます。結果を問題なしと判断してゼロを読み取る前に、このフィールドを確認してください。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "hk-companies": {
      "url": "https://gateway.pipeworx.io/hk-companies/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/hk-companies/mcp の tools/list は、上の表に記載されたツールに加え、Pipeworx 共通のメタツールである ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使用できるツールも返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールとともに、共通ツールが約30件一覧表示されます。接続の initialize 応答には、その正確なスコープが記載されており、特定の日における確定情報となります。

これは意図的な仕様であり、偶然の多重化ではありません。ask_pipeworx を通じてカタログ全体を検索することで、このパックの対象外の質問にも回答できるメタツールです。これにより、MCP サーバーを追加する必要はありません。現時点では、メタツールを含めずにパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

このパックのツールだけでなく、各パックのすべてのツールを直接一覧表示するには、Pipeworx のフルゲートウェイに接続します：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイに接続し、同じ1881以上のデータソースにアクセスします。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらから接続しても、ask_pipeworx ですべてのツールを利用できます。

MCP クライアントがなくても、HTTP 経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/hk_company_search \
  -H 'Content-Type: application/json' \
  -d '{"name":"HSBC"}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/hk_company_search を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "hk-companies": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-hk-companies"]
    }
  }
}

または、直接実行して起動することを確認します。

npx -y @pipeworx/mcp-hk-companies

stdin/stdout 経由で MCP を通信し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングもありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、ゲートウェイ全体でも利用できます。

ask_pipeworx({ question: "your question about Hk Companies data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT