swissreg

swissreg

スイスの企業に関する9つの読み取り専用の質問に、スイス自身が公開する公的登録情報をもとに回答します。基本的な機能ではアカウントは不要です。情報源は、LINDAS 経由の商業登記簿、スイス官報、simap 調達プラットフォーム、FINMA の認可機関リスト、GLEIF 法人データベース、連邦 ARAMIS 研究データベースなどのオープンデータです。

回答はすべて、同じ形式の JSON オブジェクトで返されます。rows（各行には、そのツールについて説明されているフィールドのみが順番どおりに含まれます）、count、および情報源が示せる内容の限界を説明する notes が含まれます。たとえば、LEI がないのは通常のことであること（スイスの法人で LEI を保有するのは約28,000社のみです）や、企業はディレクトリのプロフィールを保有していなくても simap で入札できることなどです。

9つのツール：

• swissco_lookup — UID を指定して、商業登記簿が公開する企業情報をすべて取得します。FINMA のライセンス項目と、統合親会社を含む LEI を追加することもできます。
• swissco_search — 法人名または定款上の事業目的に検索語を含む企業を検索します。LINDAS 経由では、州および法人形態で絞り込めます。
• swissco_publications — 日付範囲内の官報掲載情報を取得し、州、下位分類、タイトルのテキスト、イベント種別でクライアント側から絞り込めます。
• swissco_events — 1社の登記事項を取得します。各項目は、掲載情報に記載された UID が指定した UID と一致する場合にのみ含まれます。
• swissco_tenders — simap で公開された公共調達プロジェクトを、日付範囲、州、掲載種別で取得します。
• swissco_vendor — 企業が simap のベンダープロフィールを保有しているか、そのプロフィールに何が記載されているかを確認します。
• swissco_finma — FINMA の認可銀行および証券会社リストに掲載された機関を取得します。名称、UID、ライセンス種別、監督区分で絞り込めます。
• swissco_lei — 企業の LEI、その企業を統合する法人、統合階層の最上位、および必要に応じて統合対象の子会社を取得します。
• swissco_research — 企業名が記載された連邦助成研究プロジェクト（Innosuisse および SNSF の資金を含む）を、テキストまたは参加者の UID で検索します。

スイスの UID は厳密に扱われます。UID は正規化され（CHE444420929、CHE-444.420.929、小文字表記のいずれも使用できます）、リクエストを行う前に modulo-11 のチェックディジットが検証されます。出力される UID は常に CHE-XXX.XXX.XXX の形式です。日付は YYYY-MM-DD 形式です。官報で対応できない日付範囲は最新の日付に切り詰められ、その旨が notes に記載されます。

設定

認証情報は不要です。次の2項目は任意です。

export ZEFIX_USER="..."        # Zefix PublicREST account
export ZEFIX_PASSWORD="..."

これらを設定すると、swissco_search を via: "rest"（より豊富なフィールドを含む名前の前方一致検索）で実行できます。設定していない場合、この経路は2つの変数名を明示して失敗します。それ以外の登記簿検索は LINDAS 経由で実行され、認証情報を設定すると資本金、ステータス、旧名称、企業関係を追加できることが示されます。

CLI

各ツールは、1つの JSON 引数文字列を受け取るサブコマンドです。

npx @reneturcios/swissreg swissco_lookup '{"uid":"CHE-444.420.929","lei":true}'
npx @reneturcios/swissreg swissco_search '{"term":"pharma","canton":"BS"}'
npx @reneturcios/swissreg swissco_tenders '{"pub_types":["award"],"cantons":["ZH"]}'
npx @reneturcios/swissreg --version

出力はツールの JSON 形式のエンベロープです。終了コード：成功時は 0、実行時エラー（検証エラーや上流サービスのエラーを含む）時は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/swissreg mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "swissreg": {
      "command": "npx",
      "args": ["-y", "@reneturcios/swissreg", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/swissreg
docker run --rm ghcr.io/cloudcorprecords/swissreg swissco_finma '{"licence_type":"Bank"}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch + fake clock, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios