ItalyCheck

ItalyCheck（MVP）

AI エージェント向けの、呼び出しごとに課金されるサプライヤー検証サービスです。無料の公開情報源のみを使用します。x402（Base 上の USDC または EURC）で支払います。

エンドポイント

パス	価格	情報源
GET /v1/vat?vat=IT00743110157	$0.01	EU VIES REST（リアルタイムのパススルー、データは保存しません）
GET /v1/pa?cf=80016350821	$0.005 USDC または €0.005 EURC	IndicePA、「Enti」データセット（AgID、CC BY 4.0、出典の明記が必須）
GET /v1/vat/format?vat=...	無料	P.IVA のオフラインチェックサム検証
GET /	無料	エージェント向け説明付きカタログ

使用方法

npm install
npm test              # VIES + IndicePA、402 x402、MCP のライブテスト
npm run dev           # 支払いなし、ポート 8787
npm start             # x402 を使用（Base Sepolia テストネット、x402.org ファシリテーター）
ITALYCHECK_URL=https://... npm run mcp   # MCP stdio サーバー（プロキシ）。ITALYCHECK_LOCAL=1 = ローカル検索

本番環境への移行（未実施）

1. PAY_TO = Yeison の Base ウォレットアドレス。
2. X402_NETWORK=eip155:8453；CDP ファシリテーター（npm i @coinbase/x402、キー CDP_API_KEY_ID/SECRET；月 1,000 件のトランザクションまで無料、その後は $0.001）。
3. npx wrangler deploy で Cloudflare Workers Free にデプロイ（商用利用可、1 日 100k リクエスト、CPU 10 ms）。
4. CDP ファシリテーター経由で最初の支払いが決済されると、Bazaar によって検出されます。MCP を MCPize/Smithery に公開します。

法的制約

• VIES の免責事項では、域内取引に関する VAT 番号の検証目的に限り使用が認められています。規定に反する情報抽出は禁止されており、悪用は IP 単位でブロックされます（例：同じ VAT 番号への 1 日に複数回のアクセス）。そのため、共有キャッシュ、アーカイブ、大量スクレイピングは禁止です。
• IndicePA：CC BY 4.0 に基づき、情報源として「© AgID – IndicePA」を記載する必要があります。

デプロイ状況（16/10/2026）

• オンライン：https://italycheck.italycheck.workers.dev（Cloudflare Workers Free、Base Sepolia テストネット、x402.org ファシリテーター）
• 有料なのは /v1/pa のみです。/v1/vat（VIES）は無効化されています：ENABLE_VAT="0"。法的見解待ちです。
• デプロイ：CLOUDFLARE_ACCOUNT_ID=... npx -y -p node@22 node ./node_modules/wrangler/bin/wrangler.js deploy（wrangler 4 には Node 22 が必要です）。
• Worker はリクエストごとに新しいアプリを作成し、ファシリテーターからの「supported」応答のみをデータとしてキャッシュします。複数リクエスト間で処理中の promise を共有すると、Workers 上でリクエストがブロックされていました。

メインネット（16/10/2026、夜）

• Base メインネット eip155:8453、USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913、CDP ファシリテーター。シークレット CDP_API_KEY_ID と CDP_API_KEY_SECRET は Cloudflare に設定されています（wrangler secret）。
• Bazaar：スキーマとサンプルを含むディスカバリー拡張。CDP の /x402/validate による検証結果：valid true。
• リモート MCP：POST /mcp（ステートレスな Streamable HTTP）。lookup_italian_pa は MCP 経由の x402 で支払います（@x402/mcp）。
• CPU：src/bazaar-shim.js（wrangler のエイリアス）により、リクエストごとの ajv 再検証を省略します。CDP JWT と「supported」応答はデータとしてキャッシュされます。
• ディスカバリーについては SUBMISSIONS.md を参照してください。

EURC (24/10/2026)

• /v1/pa と MCP ツール lookup_italian_pa は、USDC に加えて Base 上の EURC も受け付けます。accepts では引き続き USDC が最初の選択肢（デフォルト）で、EURC は2番目の選択肢です。額面は同じ（0.005 EURC = 5000 単位、小数点以下6桁）で、payTo も同じです。
• EURC Base メインネット 0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42（Circle：https://developers.circle.com/stablecoins/eurc-contract-addresses）。Base Sepolia 0x808456652fdb597867f38412077A9182bf77359F。EIP-712 ドメインはオンチェーンで読み取られ、name は EURC、version は 2 です。
• CDP ファシリテーターは、EVM ネットワーク上で EIP-3009 に対応するすべての ERC-20（USDC、EURC）を受け付けます：https://docs.cdp.coinbase.com/x402/support/faq
• 購入者向けの注意：デフォルトの spendControls を使用する @x402 2.28 クライアントは、デフォルトのアセット（USDC）のみを受け付けます。EURC で支払うには、EURC を指定した spendControls.allowedAssets、または allowedAssets: true が必要です。
• EURC を無効にするには、変数 DISABLE_EURC="1" を設定します。