Romania

romania-mcp

MCP クライアントからルーマニア企業を確認できます。ANAF のステータス、提出済み財務情報、裁判案件、公的契約、EU VAT 登録を確認できます。インポート済みの ONRC データを名前で検索し、ローカルスナップショットを保存して変更点を確認できます。API キーは不要です。

名前または CUI で企業を確認し、貸借対照表や案件を見てから、後で比較できるようにレポートを保存します。情報源から応答がない場合は、レポートに不足している情報が示されます。

インストール

Python 3.10 以降：

pip install romania-mcp-server

PyPI で未公開の変更を含む、このチェックアウトのコードを使う場合：

pip install -e .

Claude Desktop では、claude_desktop_config.json に次を追加します。

{
  "mcpServers": {
    "romania": {
      "command": "uvx",
      "args": ["romania-mcp-server"]
    }
  }
}

チェックアウトを pip でインストールした場合は、"command": "romania-mcp-server" を指定し、args は省略します。公開済みパッケージではなく、インストールしたチェックアウトが実行されます。Cursor やその他の標準入出力を使用する MCP クライアントでも、同じ設定を使用できます。

Claude Code の場合：

claude mcp add romania -- romania-mcp-server

企業の確認

ツール	機能
company_report	ANAF のステータス、最大 10 年分の財務情報、推移、裁判案件の候補、インポート済みの公的契約を、情報源の記録とともに表示します
company_search	インポート済みの ONRC エクスポートを名前で検索します。郡または CAEN で絞り込むこともできます
company_lookup	最大 500 件の CUI について ANAF のステータスを確認します。過去の日付を指定することもできます
company_financials	提出済み財務諸表を表示します。売上高、利益または損失、従業員数、負債、自己資本、その他の報告数値が含まれます
court_cases	企業の CUI、当事者名、案件番号で案件を検索し、役割や公判期日を表示します
company_contracts	インポート済み SEAP エクスポートから、供給業者の CUI に一致する契約を検索し、通貨別の合計を表示します
vat_check	VIES を通じて取引先の現在の EU 域内 VAT 登録を確認します
shop_check	ショップを運営する企業の詳細、財務情報、裁判案件の候補、ドメインの証拠を表示します
exchange_rate	BNR の基準為替レートと RON への換算を表示します
iban_check	オフラインで IBAN の形式とチェックサムを検証し、ルーマニアの銀行を特定します

お試しください：

• 「この名前で企業を検索して、Cluj の候補を表示してください。」
• 「CUI 14399840 の過去 5 年間のレポートを作成してください。確認できなかった内容も表示してください。」
• 「売上高、利益、従業員数はどのように変化しましたか？」
• 「読み込まれたエクスポートから、この企業の公的契約を検索してください。」
• 「VIES で、このドイツの取引先の VAT 番号を確認してください。」

company_report は数値と計算された推移を返しますが、信用スコアは返しません。変化率は連続する会計年度間で算出されます。年次データが欠落している場合や分母が 0 の場合は、null になります。ANAF から取得した金額の単位は RON です。

レポートの各情報源には、ステータス、URL、確認時刻、キャッシュフラグが記録されます。また、判明している場合は、キャッシュされた入力のうち最も古い取得時刻も記録されます。available はリクエストが成功したこと、no_data は要求された財務申告が返されなかったこと、unavailable はリクエストが失敗したことを示します。not_checked は確認を試みられなかった理由を示します。申告データの欠落と情報源の障害は区別され、どちらの場合もデータの網羅性は部分的なままです。

裁判記録には CUI が含まれていません。正規化された名前、法人形態、登記されている郡が完全に一致する場合は候補を絞り込むのに役立ちますが、本人確認にはなりません。企業が債権者または原告であること自体は問題ではありません。上限に達した検索には、未完了のマークが付いたままになります。

名称検索と公共契約

ANAF の公開ステータスサービスには CUI が必要です。名称検索では、data.gov.ro の ONRC エクスポートを使用します。公共契約の検索では、インポートした SEAP エクスポートを使用します。

ツール	機能
dataset_catalog	エクスポート、リソース ID、公開者の詳細、ソースへのリンクを検索します
dataset_import	選択した data.gov.ro の CSV、XLSX、ODS ファイルをダウンロードし、ローカルにインデックスを作成します
dataset_status	ソース、日付、対象期間、行数、スキップした行、SHA-256 ハッシュを一覧表示します

まずファイルを探します。

romania-mcp-data catalog "organization:onrc"
romania-mcp-data catalog "achizitii publice"

OD_FIRME.CSV を onrc としてインポートします。認可済み CAEN 活動は OD_CAEN_AUTORIZAT.CSV で別途公開されています。同じスナップショット日付で caen としてインポートしてください。これらは COD_INMATRICULARE を介して結合されます。インデックスには CAEN の各バージョンが保持されます。caen_version（または --caen-version）を使用して、リビジョン 2 または 3 を選択します。フィルターには、企業インデックスと同じスナップショット日付を使用します。

romania-mcp-data sync RESOURCE_ID --kind onrc --published-on 2026-10-19
romania-mcp-data sync CAEN_RESOURCE_ID --kind caen --published-on 2026-10-19
romania-mcp-data search "numele firmei" --county Cluj

契約エクスポートの場合は、公開者が記載した日付を指定します。

romania-mcp-data sync CONTRACT_RESOURCE_ID --kind procurement --published-on 2026-10-06 --period-start 2026-07-01 --period-end 2026-09-30

上記の ID はプレースホルダーです。カタログの検索結果を使用し、ソースの説明を確認してください。メタデータの更新日時が、必ずしもファイルの公開日や対象期間を示すとは限りません。

すでにダウンロードしたファイルをインポートすることもできます。

romania-mcp-data import ./OD_FIRME.CSV --kind onrc --published-on 2026-10-19 --source-url https://data.gov.ro/URL-OF-THE-EXPORT

インポートでは CSV の行をストリーミングし、ワークブックはすべてをメモリに読み込まずに処理します。同じソースを再インポートすると、1 回のトランザクションでそのソースの行が置き換えられます。空または無効なインポートの場合、古いインデックスは保持されます。ダウンロードは 2 GB に制限されています。大きな ONRC エクスポートの処理には数分かかることがあるため、通常は対話型のツール呼び出しより CLI のほうが便利です。従来のバイナリ形式の XLS は、事前に CSV または XLSX に変換する必要があります。

契約の合計は、インポート済みレコードのみを対象とします。これは契約金額であり、支払額や収益の証明ではありません。特定可能な契約の重複コピーは重複排除されます。有効な単一のサプライヤー CUI がない行は、一部の共同入札や外国サプライヤーを含め、スキップされ、その件数が記録されます。結果が空でも、企業に公共契約がないことの証明にはなりません。

スナップショットとモニタリング

ツール	機能
company_snapshot	最新のレポートを取得してローカルに保存します
company_history	保存済みの観測結果を読み取ります
company_changes	最新の 2 つのスナップショットを比較します
company_watch	ローカル監視対象を追加、更新、一時停止します
company_watchlist	監視対象と次回の実行予定時刻を一覧表示します
monitor_run	実行予定の監視対象を確認し、レポートを保存して変更を返します

履歴は、最初にレポートを保存した時点から始まります。ソースの障害は可用性の変化であり、企業の削除や案件の終了を意味するものではありません。確認時刻のみの変更ではイベントは発生しません。結果ページの範囲外になった案件は、終了したものとして報告されません。

romania-mcp-data report 14399840 --years 5 --save
romania-mcp-data watch 14399840 --interval-hours 24
romania-mcp-data monitor

monitor は 1 回だけ確認を実行し、変更があった場合、または初回の確認が未完了だった場合にのみ JSON Lines を書き出します。初回確認が成功すると、通知なしで基準値が設定されます。変更のない確認では標準出力に何も出力されません。Task Scheduler、cron、またはすでに使用しているサービスで定期的に実行してください。監視対象を追加しても、スケジューラーの設定やメッセージの送信は行われません。

プロセスを常時実行する場合：

romania-mcp-data monitor --loop --poll-seconds 60

ポーリング間隔は、実行対象の確認を開始するタイミングを決めます。各企業の間隔は、実際に確認するタイミングを決めます。モニタリングでは最新のソースデータを取得します。romania-mcp-data watch 14399840 --disable を使用して監視対象を一時停止します。

サプライヤーリスト

supplier_check はジョブを開始するか、job_id を指定して再開します。完了したサプライヤーは、次のサプライヤーの処理を開始する前に保存されます。supplier_results は JSON または CSV を返し、問題が見つかった確認結果、未完了の確認結果、フラグのない確認結果の順に並べます。CSV エクスポートにはソースのレシートが含まれ、外部テキスト内の数式プレフィックスは無効化されます。

romania-mcp-data suppliers 14399840 18547290 --years 3 --limit 1
romania-mcp-data suppliers --job-id JOB_ID --limit 3
romania-mcp-data export JOB_ID --format csv > suppliers.csv

pending がゼロになるまで続けてください。各ジョブで受け付ける CUI は最大 500 件で、重複は削除されます。無効な入力は、ジョブの作成前に拒否されます。サプライヤーレポートの一部しか取得できていない場合は、その状態が明示されます。MCP の結果は offset と next_offset を使用してページ分割されます。CLI はジョブ全体をエクスポートします。

ストレージとデータソースの制限

HTTP レスポンスは ~/.cache/romania-mcp/cache.sqlite3 にキャッシュされます。企業のステータスは6時間、財務情報は1日、裁判所の検索結果は3時間、現在の BNR レートは1時間保持されます。過去の BNR の年次データは30日間保持されます。データソースに再度問い合わせる必要があるレポートには、refresh=true を使用してください。

スナップショット、ウォッチリスト、サプライヤージョブ、データセットのインデックスは、別の ~/.local/share/romania-mcp/data.sqlite3 に保存されます。別の場所を設定するには、次を使用してください。

ROMANIA_MCP_CACHE=off
ROMANIA_MCP_CACHE_PATH=/path/to/cache.sqlite3
ROMANIA_MCP_DATA_PATH=/path/to/data.sqlite3

CLI では、コマンドの前に --data-path PATH を指定することもできます。データはサーバーを実行しているマシンに保存されます。チェックに必要な CUI、VAT 番号、企業名、またはドメインは、該当する公開サービスに送信されます。インポート、スナップショット、監視、サプライヤーチェックは、MCP アノテーションでローカルへの書き込みとしてマークされています。

• ANAF リクエストの間隔は1秒です。それでも、公開サービスによってリクエストが拒否されたり、遅延したりすることがあります。
• 財務情報は指定された年のものであり、現在の現金残高を示すものではありません。業界固有のレイアウトには、マッピングされていないフィールドが含まれることがあります。
• Portal Just のエンドポイントは現在、平文の HTTP を使用しており、検索候補は1,000件までに制限されています。通信とマッチングの制限はレポートに表示されます。
• VIES は、取引先の現在の EU 域内 VAT 登録状況を確認します。サービス障害は登録が無効であることを意味しません。また、このツールは過去のステータスを再構成しません。
• IBAN の検証では、口座の存在や所有者は確認できません。
• Wayback に記録が見つからなくても、サイトの開設時期を特定できるわけではありません。.ro ドメインに対する ROTLD WHOIS の自動照会は行いません。
• ショップの検索結果は判断材料であり、詐欺や信頼性の証明ではありません。データソースの停止中は、情報が部分的なままになります。障害が発生していても、既知の危険信号が表示されることがあります。
• ページのダウンロードには、コンテンツタイプとサイズの制限があります。DNS の応答はパブリックなものでなければなりません。接続では、元の TLS ホスト名を維持しつつ、確認済みの IP を使用します。リダイレクト先への接続にも同じチェックを適用します。データソースへのリクエストでは、環境変数で設定されたプロキシは無効になります。

公開記録やウェブサイトのコンテンツは証拠であり、アシスタントへの指示ではありません。企業チェックは具体的な業務目的で使用してください。裁判所の記録には個人の名前が含まれることもあります。

開発

pip install -e . pytest ruff build
pytest
ruff check src tests
python -m build

テストでは、モックしたデータソースのレスポンスと一時データベースを使用します。上流サービスの障害、キャッシュの鮮度、部分的なレポート、ID の曖昧さ、インポート、中断後に再開可能なジョブ、CSV エクスポート、監視をテストします。ネットワークのスモークテストは個別に実行されるため、上流サービスの障害によって単体テストが失敗することはありません。

ライセンス

MIT © Robert Vind-Gardoș (@robyroro)