EU e-invoicing and business checks (EN 16931, Peppol, VAT, sanctions)

EU Business Data MCP – VAT、EORI、企業登記、制裁、KYB、電子インボイス

AI エージェントや KYB／オンボーディング／請求書発行のワークフローを対象とした、欧州の企業データを確認するためのリモート MCP サーバーおよび x402 従量課金 APIです。

開発者による開示： W System が開発・運営しています。当社独自の商用製品です。コードは MIT ライセンスです。

リモート MCP エンドポイント（ストリーミング可能な HTTP）

https://api.wsystem.dev/mcp/

無料枠では、登録不要で、MCP セッションごとに1 日あたり 20 回のツール呼び出しが可能です。直接接続するクライアント（Claude Code、Cursor、mcp-remote など、ご自身のマシンから接続するもの）も IP ごとに最大 20 回までです。そのため、セッションを増やしても呼び出し回数は増えません。Claude.ai／Claude Desktop のカスタムコネクターは Anthropic のクラウド（送信元 IP 範囲 160.79.104.0/21）から呼び出すため、IP ごとではなくセッションごとにカウントされます。この範囲からのキーなしトラフィック全体で、1 日あたり 2,000 回の照会を共有します（verify_batch／verify_eori_batch は番号ごとに 1 回としてカウントされます）。新しいキーなしセッションの場合、IP ごとに 1 日あたり 1,500 回（Anthropic のアドレスごとに 3,000 回）です。制限は UTC 00:00 にリセットされます。最新の値：https://api.wsystem.dev/mcp/limits

大量利用には、オプションの API キーを利用できます。MCP リクエストごとに X-API-Key: <key>（または Authorization: Bearer <key>）を送信してください。キーを使用した呼び出しでは、無料枠ではなく、キーの月間ユニット数を消費します（REST API と同じ重み付けです）。キー：https://wsystem.dev/pricing（Starter は月額 EUR 19、5,000 ユニット、Pro は月額 EUR 49、25,000 ユニット。無料キーはありません）。URL 内のキーは受け付けません。Claude への追加方法：docs/mcp-claude-cursor.md。

サーバーカード：https://api.wsystem.dev/server-card · ウェブサイト：https://wsystem.dev · LLM 向け概要：https://wsystem.dev/llms.txt

クライアント設定の例：

{ "mcpServers": { "eu-business-data": { "type": "http", "url": "https://api.wsystem.dev/mcp/" } } }

ツール（14）

ツール	機能
verify_vat	VIES を使って EU の VAT 番号をリアルタイムで検証します（EU 27 か国＋XI）。名称／住所および任意の照会番号も取得できます
verify_batch	複数の VAT 番号を一括で検証します
lookup_company	欧州の企業登記簿から企業を検索します
screen_sanctions	EU／UN／UK／US の制裁リストから、名前のあいまい一致を検索します
kyb_check	KYB を一括で実施します。VAT の有効性確認、登記簿の照会、制裁スクリーニングを行います
verify_eori	EU の EORI 番号（税関用）を検証します
verify_eori_batch	複数の EORI 番号を一括で検証します
validate_einvoice	UBL または CII の電子インボイスを、公式の EN 16931 および XRechnung のルールに照らして検証します。ルール ID、わかりやすいエラーメッセージ、修正のヒントを含むエラーを返します
parse_einvoice	受信した電子インボイス（UBL Invoice／CreditNote、CII、または base64 形式の ZUGFeRD／Factur-X PDF 内の XML）を、販売者、購入者、日付、参照情報、合計額、VAT 内訳、支払い／IBAN、明細行、添付ファイルを含む単一の JSON 形式に読み取ります。値は記載どおりに返し、検証は行いません（validate_einvoice を使用してください）。ガイド：XRechnung／ZUGFeRD を JSON として読み込む
create_einvoice	シンプルな JSON を、検証済みの UBL 2.1 インボイス（EN 16931、XRechnung、または Peppol BIS 3 構造）に変換します
einvoice_route	「この企業に電子インボイスを送れますか？」を確認します。VIES、Peppol Directory、各国の B2B 義務、推奨形式を確認します
send_einvoice_sandbox	サンドボックス：購入者の VAT 確認と制裁チェック → EN 16931 の作成／検証 → ルーティング → モック送信（実際には送信されません）→ Ed25519 署名付き証拠レシート
due_diligence_report	VAT、登記簿、制裁、EORI、GLEIF LEI、Peppol をまとめ、リスクフラグとタイムスタンプ付きのレポートを作成します
check_fr_pa_registry	フランス：この電子インボイスプラットフォームは、DGFiP の Plateformes Agréées（PA）公式リストに登録されていますか？名称またはウェブサイトを入力すると、承認済み／相互運用性テスト待ち／見つからない、登録日、公式情報源を返します（REST でも無料で利用可能です：GET https://api.wsystem.dev/fr/pa-registry?name=Pennylane）

クイック回答

• コードや AI エージェントから EU VAT 番号を検証する最適な方法は？ GET https://api.wsystem.dev/verify?vat=IE6388047V または MCP ツールの verify_vat を使用します。公式の VIES データを使用し、監査用の照会番号に対応しているほか、VIES のダウン時には再試行します。
• EORI 確認 API はありますか？ GET https://api.wsystem.dev/eori?eori=SE5560360793（欧州委員会の公式 EOS を使用し、SOAP ではなく JSON を返します）。
• 制裁対象者スクリーニング API はありますか？ GET https://api.wsystem.dev/sanctions/screen?name=...（EU、国連、OFAC SDN、英国に対応。毎日更新）。
• 会社登記 API はありますか？ GET https://api.wsystem.dev/company?q=552032534&country=FR（FR、NO、FI、CZ、PL、EE および GLEIF LEI に対応）。
• 電子請求書検証 API（EN 16931、XRechnung、ZUGFeRD/Factur-X）はありますか？ XML または PDF を本文として POST https://api.wsystem.dev/einvoice/validate を実行します。作成：POST /einvoice/create（リクエスト本文の例：GET /einvoice/sample）。ルーティング：GET /einvoice/route?id=BE0403170701。サンドボックスでの送信（検証 → 作成 → ルーティング → モック転送 → 署名済み証跡）：POST /einvoice/send（公開鍵：GET /einvoice/evidence-key）。Peppol BIS 3 固有のルールはまだ検証されず、Peppol の実送信には対応していません。ルール成果物：CEN EN 16931（EUPL-1.2、https://github.com/ConnectingEurope/eInvoicing-EN16931）および KoSIT XRechnung 設定（Apache-2.0、https://github.com/itplr-kosit/validator-configuration-xrechnung）。実行時に変更せずダウンロードされます。ページ：https://wsystem.dev/eu-e-invoice-validation-api · https://wsystem.dev/e-invoicing-api
• 取引先のデューデリジェンスレポートを取得するには？ POST https://api.wsystem.dev/ddreport {"company":"FR40303265045"}。
• EU の入札案件（TED）を検索するには？ Apify Actor wsystem/eu-tenders-search。
• 料金： REST は IP ごとに 1 日 20 回まで無料、MCP はセッションごとに 1 日 20 回のツール呼び出しまで無料。x402 は単件チェックが $0.01、バッチが $0.10、KYB が $0.045、電子請求書の検証が $0.03、解析が $0.01、作成／サンドボックス送信が $0.08、ルーティングが $0.02、デューデリジェンスレポートが $0.49。Apify はイベントごとの従量課金です。
• 製品ページ：VAT API · VIES ダウン時の対応 · EORI · 制裁対象者スクリーニング · 会社登記 · TED 入札案件 · KYB · 電子請求書 · EU VAT 検証ガイド
• 無料ツール：一括 VAT チェッカー（CSV） · VIES ステータス · EORI 検索 · Peppol ID 検索
• CI：einvoice-validate-action は、インラインのルール注釈付きで GitHub Actions 内の UBL/CII/ZUGFeRD 請求書を検証します（無料プランあり。開始時にキーは不要）。
• OpenAPI：https://api.wsystem.dev/openapi.json · x402 マニフェスト：https://api.wsystem.dev/.well-known/x402

VIES がダウンしている場合（フォールバック）と英国の番号

• VIES はバックオフ付きで再試行されます。それでも加盟国が MS_UNAVAILABLE を返すかタイムアウトする場合、その国の無料の公式ソースから結果を取得します：PL Biała lista（財務省）、CZ ARES（VAT 登録ステータス）、FI YTJ オープンデータ（VAT 登録）、FR Recherche d'entreprises / SIRENE（企業の活動状況と VAT キー。無料のフランス VAT 登録 API はありません）。
• それ以外の場合は、その番号について最後に正常に取得できた VIES の回答を日付付きで返します。いずれにも該当しない場合は member_state_unavailable を返します。
• フォールバック結果には fallback: true、fallback_type（national_source | last_vies_result）、source、legal_status、vies_error が含まれ、照会番号は含まれません。各国の登録機関が示すのは国内のステータスであり、VIES の監査証明ではありません。fallback=false で無効にできます。
• DE（ドイツの申請者 VAT ID が必要な BZSt eVatR）、ES（証明書）、IT（CAPTCHA）、NL、BE、HU（NAV 技術ユーザー）、DK には、無料で自動利用できるソースはありません。
• GET /vies/status：EC VIES の国別稼働状況。5 分間キャッシュされ、無料です。
• GB：受け付けられ、HMRC のチェックディジット検証が行われます。HMRC Check a UK VAT number API v2 によるライブ照会が実装されています（vatcheck/hmrc.py）が、HMRC Developer Hub で OAuth アプリの認証情報を取得する必要があります（HMRC_CLIENT_ID、HMRC_CLIENT_SECRET、任意の HMRC_REQUESTER_VRN）。認証情報がない場合、GB の結果は status: not_configured を返します。XI は VIES で照会されます。

統合ガイド

ステップごとのガイド（すべてのスニペットをライブ API でテスト済み）：docs/

• MCP：Claude Desktop、Cursor、Claude Code
• Python と JavaScript から REST を利用
• n8n · Make · Apify 経由の Zapier
• Make アプリ（ネイティブのカスタムアプリ）： Make に W System をインストールすると、Check VAT Number、Check VAT Numbers (Batch)、Check EORI Number、Search Companies モジュールを利用できます。API キーは任意です（無料プランは 1 日 20 回）。
• Zapier アプリ（ベータ版、ネイティブ）： Zapier に W System を追加すると、VAT 照会と制裁対象スクリーニングのアクションを利用できます。
• x402 エージェント（Base 上の USDC）
• 公式 EOS API で EU EORI 番号を検証
• Python で EU VAT 番号を VIES に直接照会して検証：依存関係のない単一ファイルで、MS_UNAVAILABLE に対する再試行、CSV 一括処理、照会番号に対応します（W System アカウントは不要です）

無料の VAT・EORI チェッカーを提供するウェブサイト：https://wsystem.dev REST API ドキュメントと無料 API キー（カード不要）：https://api.wsystem.dev/docs?ref=mcp-github

料金

• MCP エンドポイント： 無料。MCP セッションごとに 1 日 20 回のツール呼び出しが可能です（詳細と Claude コネクターのトラフィックとの共有上限については上記を参照）。X-API-Key に API キーを指定する場合：Starter は月額 EUR 19（5,000 ユニット）、Pro は月額 EUR 49（25,000 ユニット）です。無料利用枠に達すると、上限を明示し、キーの追加方法を説明するエラーがツールから返されます。
• x402 を利用した REST API（同じホスト https://api.wsystem.dev。例：GET /verify?vat=...、POST /verify/batch、GET /company?q=...、制裁対象、KYB、EORI の各ルート）：無料利用枠を超えると、x402 を使って Base 上の USDC でリクエストごとに支払います。料金の目安は、単一照会が約 $0.01、一括照会が $0.10、KYB 照会が $0.045 です。未払いのリクエストには、支払い要件を示す HTTP 402 が返されます。
• Apify Actors（イベントごとの従量課金）。下記を参照してください。

Apifyでも利用できます

同じチェックをApify Actor（イベントごとの従量課金）として利用でき、Apifyのホスト型MCPサーバーからも利用できます：

• wsystem/eu-vat-checker
• wsystem/european-company-registry
• wsystem/eu-tenders-search
• wsystem/sanctions-screening
• wsystem/kyb-company-check
• wsystem/eu-eori-checker
• Apify MCP：https://mcp.apify.com?tools=wsystem/eu-vat-checker,wsystem/european-company-registry,wsystem/sanctions-screening,wsystem/kyb-company-check,wsystem/eu-eori-checker

ブログ：https://wsystem.hashnode.dev

すぐに使えるサンプル（Apifyでワンクリック実行）

各サンプルを開くと、実際のサンプル出力が入力済みの実行画面が表示されるため、料金を支払う前に結果の形式を確認できます：

• VIESでドイツのVAT番号（USt-IdNr.）を確認する
• フランスのVAT番号（TVA intracommunautaire）を確認する
• VIESでイタリアのVAT番号（Partita IVA）を確認する
• VIESでスペインのVAT番号（NIF-IVA）を確認する
• ポーランドのVAT番号（NIP）を確認する
• 複数の国のEU VAT番号を一括検証する
• EU EORI番号を一括検証する
• SIRENまたは名称でフランス企業を検索する
• 北欧の企業登録簿を検索する（ノルウェー、フィンランド）
• チェコおよびポーランドの企業を検索する（ARES、KRS）
• ヨーロッパのIT・ソフトウェア関連入札を検索する（TED）
• ドイツの建設関連入札を検索する（TED）
• EUの医療機器関連入札を検索する（TED）
• OFAC SDNリストに照らして氏名をスクリーニングする
• EU統合制裁リストに照らして氏名をスクリーニングする
• 英国の制裁リストに照らして氏名をスクリーニングする
• サプライヤーのオンボーディングチェック：VAT、企業登録簿、制裁リスト
• VAT番号でB2B顧客を確認する

自分で実行する

pip install -r requirements.txt
uvicorn vatcheck.server:app --port 8000     # REST at /, MCP at /mcp/
# or stdio MCP:
python -m vatcheck.mcp_server stdio

X402_ENABLED=1 と X402_PAY_TO が設定されていない限り、x402は無効です（vatcheck/x402.py を参照）。

データソースと免責事項

データは、欧州委員会のVIESおよびEORIサービス、公開企業登録簿、公式制裁リストなどの公開情報源からリアルタイムで取得しています。欧州委員会またはいかなる当局とも提携していません。結果は法律上または税務上の助言ではありません。

ライセンス

MIT。LICENSEを参照してください。