apify-public-registries

公開企業登記情報 — 11 か国

Python スクリプト（REST API に直接アクセス）または Apify アクターのフォールバック（API が存在しない場合のスクレイピング）を利用して、欧州の公的登記機関から公式な企業データを検索します。

前提条件

• Python 3（スクリプトは標準ライブラリを使用するため、ほとんどの国では pip 依存関係はありません）
• Apify へのアクセス（DE、UK、PL の財務情報、CZ の justice.cz、RO のフォールバックのみ） — apify CLI が推奨されます（npm install -g apify-cli && apify login）。代替手段として、Apify MCP コネクター（call-actor ツール）も利用できます。両方を利用できる場合は、CLI のほうが高速で推奨されます。
• NL：KVK_API_KEY 環境変数（developers.kvk.nl で登録してください。REGISTRATION/NL.md を参照）
• PL GUS：GUS_API_KEY 環境変数（[email protected] にメールしてください）
• SE：Bolagsverket には登録が必要です（REGISTRATION/SE.md を参照）
• HR：Sudski registar には OAuth 登録が必要です（REGISTRATION/HR.md を参照）

${CLAUDE_PLUGIN_ROOT} はプラグインのルートディレクトリ（.claude-plugin/ がある場所）です。プラグインのインストール時には Claude Code が自動的に解決します。開発時には --plugin-dir のパスを設定します。

ワークフローのチェックリスト

以下をコピーし、進捗に合わせてチェックを入れてください。

Task Progress:
- [ ] Step 0: Verify prerequisites — run `python3 --version` (required); for Apify-dependent registries: try `apify --version && apify info`, or check for `call-actor` MCP tool; if neither, tell user to install apify CLI or Apify MCP connector
- [ ] Step 1: Identify country + identifier type (IČO/KRS/CUI/LEI/company name)
- [ ] Step 2: Run the lookup command per country table
- [ ] Step 3: Interpret results (key fields vary by source)
- [ ] Optional: Apify fallback for scraping-based registries
- [ ] Optional: Cross-reference with EU-level sources (GLEIF LEI, ESMA bonds, EBA)

クイックリファレンス — 国別の検索

すべてのパスは ${CLAUDE_PLUGIN_ROOT}/skills/apify-public-registries/ からの相対パスです。

国	コマンド	識別子	アクセス
CZ	python3 reference/scripts/CZ/fetch_all.py lookup <IČO>	IČO（8 桁）	無料（ARES API）
SK	python3 reference/scripts/SK/fetch_all.py lookup <IČO>	IČO	無料（ORSR スクレイピング）
PL	python3 reference/scripts/PL/fetch_all.py lookup <KRS>	KRS（10 桁、ゼロ埋め）	無料（KRS API）
PL	python3 reference/scripts/PL/fetch_all.py lookup_nip <NIP>	NIP（10 桁）	無料（Biała Lista、1 日 100 件）
PL GUS	（バッチ処理 fetch_all.py に含まれます）	NIP	GUS_API_KEY が必要 — 設定しない場合、テスト用の偽データが警告なしで返されます（注意点を参照）
DE	python3 reference/scripts/DE/fetch_all.py keyword <name>	会社名	Apify（mcpc CLI）
UK	python3 reference/scripts/UK/fetch_all.py search <name>	会社名	Apify（mcpc CLI）
NL	python3 reference/scripts/NL/fetch_all.py	KVK 番号（設定済み）	API キー（KVK_API_KEY）
RO	python3 reference/scripts/RO/fetch_all.py lookup <CUI>	CUI 番号	無料（ANAF — 2026-03 以降オフライン）
HR	手動 — REGISTRATION/HR.md を参照	OIB / MBS	OAuth 登録
SE	手動 — REGISTRATION/SE.md を参照	Org.nr	Bolagsverket への登録
EU	python3 reference/scripts/EU/fetch_all.py lookup <name>	会社名	無料（GLEIF + ESMA + TED）
EU	python3 reference/scripts/EU/fetch_all.py lookup_lei <LEI>	LEI（20 文字）	無料（GLEIF）
ESG	python3 reference/scripts/ESG/fetch_all.py lookup <country>	国名／ISO コード	無料

データの種類別

必要な情報	最適な情報源	コマンド
基本プロフィール（名称、住所、法人形態）	CZ：ARES、SK：ORSR、PL：KRS、DE：Handelsregister、UK：Companies House	上記の国別テーブルを参照
所有関係／企業グループ	EU GLEIF	EU/fetch_all.py lookup_lei <LEI>
財務書類（CZ）	Justice.cz sbírka listin（Apify による代替取得）	CZ/fetch_all.py justice
財務書類（SK）	FinStat.sk	SK/fetch_all.py finstat
財務書類（PL）	Apify 経由の eKRS	PL/fetch_all.py financials
債券・金融商品	ESMA FIRDS	EU/fetch_all.py lookup <name>
VAT／デューデリジェンス（CZ）	DPH register	CZ/fetch_all.py lookup に含まれています
VAT／デューデリジェンス（PL）	Biała Lista	PL/fetch_all.py lookup_nip <NIP>
銀行の規制データ	EBA Transparency CSVs（100MB 以上）	EU/fetch_all.py eba
ESG／排出量	Climate TRACE + EU ETS	ESG/fetch_all.py lookup <country>
規制対象事業体（CZ）	ČNB bank list + OAM	CZ/fetch_all.py cnb_banks / cnb_oam
公共調達	TED	EU/fetch_all.py lookup <name>

ステップ 1：国と識別子を特定する

• ${CLAUDE_PLUGIN_ROOT}/data/companies.json の identifiers.registry_ids を確認し、既存の ID を調べます。
• 識別子が不明な場合は、EU GLEIF で名称を検索します。国別の検索に使用できる LEI と登録番号が返されます。

国別の識別子の種類：

• CZ/SK：IČO（8 桁）
• PL：KRS（先頭をゼロで埋めた 10 桁）または NIP（10 桁）
• DE：会社名のキーワード
• UK：会社名
• NL：KVK 番号（8 桁）
• RO：CUI（数字）
• HR：OIB（11 桁）または MBS
• SE：Organisationsnummer（10 桁、例：559124-6847）
• EU：LEI（英数字 20 文字）または会社名

ステップ 2：検索を実行する

国別テーブルのコマンドを実行します。スクリプトの場所： ${CLAUDE_PLUGIN_ROOT}/skills/apify-public-registries/reference/scripts/<CC>/fetch_all.py

例 — チェコの ARES で会社を検索：

python3 ${CLAUDE_PLUGIN_ROOT}/skills/apify-public-registries/reference/scripts/CZ/fetch_all.py lookup 25099345

例 — GLEIF で所有関係をたどる：

python3 ${CLAUDE_PLUGIN_ROOT}/skills/apify-public-registries/reference/scripts/EU/fetch_all.py lookup_lei 31570048XH84U51GGT05

例 — KRS で InPost を検索：

python3 ${CLAUDE_PLUGIN_ROOT}/skills/apify-public-registries/reference/scripts/PL/fetch_all.py lookup 0000536554

一括取得（国の全企業）：

python3 reference/scripts/CZ/fetch_all.py          # all CZ sources (ares, dph, cnb_banks, cnb_oam, justice)
python3 reference/scripts/PL/fetch_all.py          # all PL sources (krs, biala_lista, gus, financials)
python3 reference/scripts/EU/fetch_all.py          # all EU sources except EBA (gleif, ted, esma, eurostat)

ステップ 3：結果を解釈する

主なフィールドは情報源によって異なります。

情報源	主なフィールド
ARES（CZ）	obchodniJmeno、dic、sidlo.textovaAdresa、czNace、datumVzniku、pravniForma
DPH（CZ）	nespolehlivyPlatce（信頼性に欠ける納税者のフラグ）、銀行口座
GLEIF（EU）	lei、legalName、jurisdiction、status、registeredAs、親会社の LEI と名称
KRS（PL）	nazwa、nip、regon、kapital（資本金）
Biała Lista（PL）	statusVat、krs、regon、accountNumbers
ORSR（SK）	name、address、legal_form、share_capital、registration_date
FinStat（SK）	revenue、profit、employees、assets
Handelsregister（DE）	名称、法人形態、資本金、経営陣、HRB 番号
Companies House（UK）	会社番号、SIC コード、取締役、設立日
ESMA FIRDS（EU）	isin、lei、金融商品名、cfi_code、status
TED（EU）	buyer-name、winner-name、total-value、procedure-type
ANAF（RO）	denumire、adresa、scpTVA（VAT 納税者のフラグ）、有効ステータス

Apify による代替取得

直接 API がない場合は、特定の actor または apify/website-content-crawler を使って Apify CLI を使用します。

apify call apify/website-content-crawler \
  --input '{"startUrls":[{"url":"https://or.justice.cz/ias/ui/rejstrik-$firma?ico=25099345"}],"maxCrawlPages":1}' \
  --user-agent apify-awesome-skills/apify-public-registries

Apify に依存する登録機関：

国	登録機関	Actor	実行条件
DE	Handelsregister	radeance/handelsregister-api	DE/fetch_all.py keyword <name>
UK	Companies House	dhrumil/company-house-scraper	UK/fetch_all.py search <name>
PL	eKRS Financials	minute_contest/poland-krs-financial-scraper	PL/fetch_all.py financials
CZ	Justice.cz filings	apify/website-content-crawler	apify CLI から直接実行
RO	ListaFirme.ro	apify/website-content-crawler	RO/fetch_all.py listafirme
SE	Allabolag.se	apify/website-content-crawler	手動（住宅用プロキシが必要）

注：DE、UK、RO のスクリプトは、内部で apify CLI ではなく mcpc CLI を使用します。

依存関係

Python 標準ライブラリのみ（pip 不要）

CZ（ares、dph、cnb_banks、cnb_oam、justice）、SK（orsr、finstat）、PL（krs、biala_lista、gus）、 EU（gleif、esma、ted、eurostat）、ESG（ets、climate_trace）、RO（anaf）

Apify と APIFY_TOKEN が必要

DE（handelsregister）、UK（companies_house）、PL（eKRS 経由の financials）、 CZ（スクレイピングによる justice.cz sbírka listin）、RO（listafirme.ro）

API キーの登録が必要

• NL：KVK_API_KEY — developers.kvk.nl で登録します（REGISTRATION/NL.md）
• PL GUS：GUS_API_KEY — [email protected] にメールで連絡します（テストキー abcde12345abcde12345 は存在しますが、実データはありません）
• SE：Bolagsverket — portal.api.bolagsverket.se で登録します（REGISTRATION/SE.md）
• HR：Sudski registar — sudreg-data.gov.hr で OAuth2 フローを通じて登録します（REGISTRATION/HR.md）

重要な注意点

• CZ ARES は、チェコ企業の情報を調べる際の最適な最初の窓口です。複数の情報源となる登記簿のデータを集約しています。
• EU GLEIF は、複数の国を横断して調べる際の最適な最初の窓口です。LEI を、各国での検索に使用できる登記番号に対応付けます。
• RO ANAF API は2026年3月以降オフラインで、検索するとエラーが返されます。代替として listafirme.ro（Apify）を使用してください。
• SK ORSR は HTML スクレイピングを使用しており、windows-1250 のエンコーディングと正規表現で解析します。壊れやすく、ページレイアウトの変更で動作しなくなる可能性があります。
• SK FinStat も HTML スクレイピングを使用しており、自動アクセスがブロックされる可能性があります。
• PL Biała Lista には厳しいレート制限があります。1日あたり100件（検索メソッド）または5,000件（確認メソッド）です。
• PL GUS は GUS_API_KEY が未設定の場合、偽のデータを黙って返します。テストサーバーは、有効な NIP に対してもっともらしいレコード（ul. Test-Krucza、Kraków-Podgórze）を返します。本番キーが必要です。取得するには [email protected] にメールで連絡してください。本番データかテストデータかを確認するため、必ず GUS の最初のレコードを確認してください。
• DE と UK のスクリプトは mcpc CLI（apify CLI ではありません）を使用し、認証済みの @apify セッションが必要です。
• UK Companies House には api.company-information.service.gov.uk の無料 APIがありますが、スクリプトは代わりに Apify のスクレイピングを使用します。
• CZ Justice.cz の一括データセットは XML/CSV 形式で13GB以上あります。CKAN API が返すのはデータセットの一覧であり、企業ごとのデータではありません。
• CZ ČNB OAM が関係するのは発行体（上場企業、銀行）のみです。Oracle BI XML エクスポートを使用します。
• ESG データは国レベルのもので、企業レベルではありません。参考ベンチマークとしてのみ役立ちます。
• ESAP（API を備えた、EU の集中型 ESG・財務データベース）は、2028年1月に CSRD データの提供を開始します。
• EBA Transparency の CSV ファイルはそれぞれ100MB以上あります。通常の一括処理には含めず、EU/fetch_all.py eba を別途実行してください。
• TED の有用性は低いです。ポートフォリオ企業の大半は非公開企業です。落札者名が記載されるのは eForms の公告（2024年以降）のみです。
• 一括モード（引数なしで fetch_all.py を実行）は、スクリプトのディレクトリにある lookup_targets.json を読み込みます。これは国ごとの ID→名前の対応表であり、data/companies.json のコピーではありません。単一企業を検索する場合は、識別子を直接渡してください。

参考資料

• data/registries.json — 機械可読形式：11か国、27の登記機関エントリー
• REGISTRATION/HR.md、REGISTRATION/NL.md、REGISTRATION/SE.md — 国ごとの API アクセスガイド
• reference/european-company-data-institutions.md — 詳細な解説付きカタログ（413行、CZ・PL・EU の機関）
• reference/scripts/{CZ,DE,ESG,EU,NL,PL,RO,SK,UK}/fetch_all.py — 国ごとの検索スクリプト