Israel Business Intelligence MCP

イスラエルの請求書支払いゲートと取引先インテリジェンス

支払い前にイスラエルの仕入先の請求書を確認する、エージェントネイティブな単一ゲートです。公開登記情報に基づく取引先の証拠も確認できます。

公開ソース：https://github.com/itzikhr18/israel-counterparty-intelligence

プロジェクトの状況（最初にお読みください）

現在の本番運用状況、進行中の案件、ブロッカー、次のアクションについては、docs/PROJECT_STATUS.md をご覧ください。パートナー向け情報：PARTNER_HANDOFF.md。

信頼できるウォレットをお持ち込みください： 無料の請求書結果から、既存の x402 クライアント向けに、仕入先との無料の照合と 0.25 USDC の提案上限額を含む、検証済みのプライベートリクエストを作成できます。販売者のウォレットパッケージは不要です。ダウンロードしても支払いが承認されるわけではありません。購入者のウォレットが有効な条件を適用する必要があります。独立系ウォレットガイド。

まず無料の請求書チェックを行い、検証済みの invoice-request.json をダウンロードして、同じ請求書の処理を続けます：

npx --yes https://israel-counterparty-intelligence.vercel.app/israel-company-verify-buyer-0.4.0.tgz --invoice-file invoice-request.json

エージェント向けの公開メタデータは、本番デプロイの /.well-known/x402、/llms.txt、/README.md で利用できます。Mainnet と Testnet の支払いリソースは同じビジネスロジックを使用しますが、別々の支払い経路を維持しているため、Test USDC で Mainnet リソースが有効になることはありません。

同じ検証エンジンは、ステートレスな Remote Streamable HTTP MCP サーバーとしても公開されています：

• POST /mcp - Base Mainnet。0.25 USDC のイスラエル請求書支払いゲートに加え、企業変更、検証、仕入先リスク関連のツールを利用できます。
• POST /mcp/testnet - Base Sepolia。verify_company の呼び出しが成功するごとに 0.05 Test USDC。
• POST /mcp/pilot - 有効期限付きベアラートークンを使用する、招待制のパートナー評価。
• 企業および支払いリスクのプレビュー、preview_agent_payment_trust、describe_service、get_schema は、どちらの MCP エンドポイントでも無料です。

External Paid Call #1 を最も安価に試す方法は、company-changes を $0.01 USDC で利用することです（省略された本文または {} の本文では、マーケットプレイスのカナリア向けに company_number が公開サンプル 514744887 に設定されます）。verify は $0.05、invoice-gate は $0.25 です。未払いの POST → HTTP 402 → 購入者が管理する x402 ウォレットで支払います。正確な curl コマンドと MCP ツール get_israeli_company_changes_paid については、public/STATUS.md をご覧ください。

このリポジトリは、External Paid Call #1 向けに意図的に小規模に作られた MVP です。イスラエルの登記企業を特定し、政府との契約および支援に関する公開情報を追加し、フィールド単位の証拠を構築して、透明性のあるヒューリスティックなリスク指標を返します。法務、信用、制裁、投資に関するサービスではありません。

現在の対象範囲

• POST /v1/verify - 公式な企業の特定と証拠。
• POST /v1/verify/mainnet - 同じ検証結果を、Base Mainnet 上の実際の USDC で支払います。
• POST /v1/pilot/verify - 招待制のパートナー評価です。一般公開の無料ルートではありません。
• POST /v1/government-footprint - 正確な企業番号に基づく公開契約と支援情報。
• POST /v1/counterparty-risk - 結果の統合と、理由コードに基づく決定論的なスコア。
• POST /v1/payment-risk/mainnet - PROCEED、REVIEW、BLOCK のいずれかを返す、Mainnet での支払い前のベンダートリアージ。
• POST /v1/invoice-gate/preview - 日付、金額、VAT 構成要素、購入者が申告した条件を使った、無料の請求書計算および割当適用可否のプレビューです。支払いの承認ではありません。
• POST /v1/invoice-gate/mainnet - PAY、HOLD、BLOCK のいずれかを返す、レジストリに基づく 0.25 USDC のイスラエル請求書ゲート。
• POST /v1/company-changes/mainnet - 正確な企業番号に基づく、公式な企業の最近の登記申請およびステータス変更イベントを、新しい順にソースの証拠とともに返します。
• POST /v1/agent-payment-trust - ALLOW、REVIEW、DENY のいずれかを返す、無料のドライラン x402 署名前ファイアウォールです。支払いの署名や送信は行いません。
• GET /health - ヘルスチェック。
• GET /openapi.json - 機械可読な契約。
• X402_ENABLED=true の場合、x402 v2 の固定価格保護と Bazaar メタデータを提供します。
• リモート Streamable HTTP MCP。有料の verify_company と、無料の preview_company、preview_agent_payment_trust、describe_service、get_schema を提供します。

割当適用可否は、金額がしきい値を厳密に上回るかどうかに基づき、VAT 構成要素、認定ディーラーである購入者、および購入者からのリクエストにも左右されます。購入者のコンテキストが不足している場合は、安全側に倒して HOLD となります。このサービスは税務当局に接続せず、税務当局を独自に認証することもありません。公式な割当検証には、購入者自身の認定ディーラーまたは代理人の接続が必要です。購入者が提供した検証結果には BUYER_ATTESTED とラベル付けされ、独自に認証されたものではありません。対象外：ダッシュボード、アカウント、サブスクリプション、PDF レポート、広範なスクレイピング、銀行口座の所有者確認、文書のフォレンジック分析、UBO／PEP／制裁認証、ネガティブメディアのスクリーニング、信用力評価、TASE による情報拡充、カスタム ML モデル。

検証済み受取人ファイアウォール MVP

preview_agent_payment_trust は、購入者のウォレットが署名する前に、正確な x402 条件を評価します。申告されたイスラエル企業を特定し、SSRF とリダイレクトに対する保護を適用したうえで、サービスのオリジンから /.well-known/agent-payee.json を取得します。マニフェストと EVM 署名を検証し、申告された支払い先を確認して、支払いリソースのオリジンと購入者の委任を検証し、支払い契約の安定した SHA-256 フィンガープリントを作成します。

ALLOW はフェイルクローズ方式です。企業が有効な状態で特定されていること、ドメインから取得したマニフェストが有効であること、支払い先が承認済みであること、リソースのオリジンが一致すること、購入者の委任が完全であることが必須です。REVIEW と DENY は自動的に署名してはなりません。保証レベル 1 とレベル 2では、受取人のウォレットの法的所有権は証明されません。マニフェスト仕様は /agent-payee-manifest-v0.1.md、その JSON Schema は /.well-known/agent-payee-schema.json で公開されています。

本番状況：MAINNET 稼働中 - 初の外部有料呼び出しを確認済み。公開されている購入者向け概要：public/STATUS.md（/STATUS.md で配信）。ローンチに内部の Mainnet 決済は不要です。Base Mainnet での初の実際の外部 USDC 決済は、本番環境での初のエンドツーエンド決済であり、External Paid Call #1 でもあります。

公開ソース

会社情報アダプターは、法務省の会社登記局が公開する CKAN 企業データセットと、data.gov.il の法人局日次変更データセットを使用します。変更データの対象期間は約 1 年までです。結果が空でも、それ以前に変更がなかったことを証明するものではありません。公式の申請種別は事実情報として返され、リスクに関する結論ではなく、決定論的な案内カテゴリにマッピングされます。政府との取引実績アダプターは、公開されている BudgetKey テーブル API を使用します。ソース URL、取得時刻、ソースレコード識別子、信頼度は evidence で返されます。

データが利用できない場合、サービスは null と missing_data を返します。政府との契約を信頼性の裏付けとして扱うことはなく、ソースが欠落しているという理由だけでリスクポイントを加算することもありません。

ローカル環境のセットアップ

必要なもの：Node.js 20 以降。

npm install
cp .env.example .env.local
npm run dev

すべてのチェックを実行します。

npm run check

例

curl -X POST http://localhost:3000/v1/verify \
  -H 'content-type: application/json' \
  -d '{"company_number":"514744887","language":"en"}'

名称による検索にも対応しています。

{
  "company_name": "MONDAY.COM",
  "city": "Tel Aviv",
  "language": "en"
}

複数の候補が妥当な場合、API は候補とともに 409 AMBIGUOUS_ENTITY を返します。候補のいずれかを暗黙に選択することはありません。無効な番号の場合は 400 を返します。信頼できる事業体が見つからない場合、2 つのエンリッチメントエンドポイントは 422 を返します。

x402 の設定

この実装では、公式の x402 v2 パッケージと Next.js の withX402 を使用するため、決済はレスポンスが成功した後にのみ確定されます。デフォルトのテスト設定では、公開 x402 テストファシリテーターを通じて Base Sepolia を使用します。

決済を有効にするために必要な設定：

X402_ENABLED=true
X402_PAY_TO=0xYourReceivingWallet
X402_NETWORK=eip155:84532
X402_ASSET=0x036CbD53842c5426634e7929541eC2318f3dCF7e
X402_FACILITATOR_URL=https://facilitator.payai.network
PUBLIC_BASE_URL=https://your-public-host.example

価格は環境変数に一元管理されています。

X402_VERIFY_PRICE=$0.10
X402_GOVERNMENT_PRICE=$0.35
X402_RISK_PRICE=$0.50

独立した Mainnet リソースでは、次を使用します。

X402_MAINNET_ENABLED=true
X402_MAINNET_PAY_TO=0xYourReceivingWallet
X402_MAINNET_NETWORK=eip155:8453
X402_MAINNET_ASSET=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
X402_MAINNET_FACILITATOR_URL=https://facilitator.payai.network
X402_MAINNET_FACILITATOR_PROVIDER=auto
CDP_API_KEY_ID=
CDP_API_KEY_SECRET=
X402_MAINNET_VERIFY_PRICE=$0.05
X402_MAINNET_PAYMENT_RISK_PRICE=$0.10
X402_MAINNET_INVOICE_GATE_PRICE=$0.25
X402_MAINNET_COMPANY_CHANGES_PRICE=$0.01
X402_MCP_TESTNET_VERIFY_PRICE=$0.05
X402_MCP_MAINNET_VERIFY_PRICE=$0.05
X402_MCP_TESTNET_PAYMENT_RISK_PRICE=$0.10
X402_MCP_MAINNET_PAYMENT_RISK_PRICE=$0.10
X402_MCP_TESTNET_INVOICE_GATE_PRICE=$0.25
X402_MCP_MAINNET_INVOICE_GATE_PRICE=$0.25
X402_MCP_TESTNET_COMPANY_CHANGES_PRICE=$0.01
X402_MCP_MAINNET_COMPANY_CHANGES_PRICE=$0.01
MAINNET_INTERNAL_TEST_PAYER=0xYourIsolatedMainnetTestWallet

決済署名がない場合、保護されたエンドポイントは PAYMENT-REQUIRED を付けて 402 を返します。チャレンジには Bazaar の入力／出力メタデータが含まれます。互換性のある有料クライアントは、決済ペイロードでこの拡張をエコーする必要があります。カタログへの掲載は、ファシリテーターが準拠した有料ペイロードを処理した後にのみ行われ、最終的にはそのファシリテーターによって制御されます。

X402_MAINNET_FACILITATOR_PROVIDER=auto の場合、両方の CDP 認証情報が設定されるまでは、設定済みの URL が維持されます。認証情報を追加すると、Mainnet の検証と決済処理は、認証済みの Coinbase CDP ファシリテーターに自動的に切り替わります。シークレットがチャレンジ、ログ、ヘルスレスポンスに表示されることはありません。npm run bazaar:check を実行すると、Coinbase Bazaar に対してすべての稼働中の有料エンドポイントを検証できます。同じ読み取り専用チェックが GitHub Actions で毎日実行されます。

Base Sepolia と Base Mainnet のネットワーク識別子および USDC アセットは、異なる設定値として検証されます。価格、アセット、ネットワーク、ファシリテーター、payTo はサーバー側で管理され、リクエスト入力で上書きすることはできません。

MCP クライアントのセットアップ

本番環境の MCP URL：

https://israel-counterparty-intelligence.vercel.app/mcp

このエンドポイントは Streamable HTTP と x402 v2 を実装しています。標準的な MCP クライアントは、サーバーを初期化し、ツールを一覧表示して、無料ツールを呼び出せます。preview_company は、識別情報／ステータスに加え、次の有料アクションで再利用できる正確な引数を返します。有料の verify_company 呼び出しは、クライアントが _meta["x402/payment"] を付けて再試行するまで、構造化された PaymentRequired 結果を返します。決済が成功すると、結果は _meta["x402/payment-response"] に返されます。署名と再試行を自動化するには、@x402/mcp などの x402 対応 MCP クライアントを使用してください。購入者アカウントや API キーは不要です。

本番環境の PaymentRequired.resource.description には、購入者向けの正式なガイドが含まれています： https://israel-counterparty-intelligence.vercel.app/x402-buyer-quickstart.md。このガイドには、Streamable HTTP クライアントの例、Base Mainnet／USDC の明示的な要件、ツールごとの支出制限、想定される支払い／決済メタデータが記載されています。x402 ウォレットブリッジのない通常の MCP クライアントは、無料ツールを検出して呼び出すことはできますが、verify_company を自動的に完了することはできません。

Claude や、リモート HTTP MCP サーバーを受け付けるその他のクライアント向けの最小限のクライアント設定：

{
  "mcpServers": {
    "israel-business-intelligence": {
      "type": "http",
      "url": "https://israel-counterparty-intelligence.vercel.app/mcp"
    }
  }
}

LangChain は同じ URL をトランスポート http で使用します。CrewAI と Google ADK はトランスポート streamable-http を使用します。標準の MCP アダプターで無料ツールを検出して呼び出せます。有料呼び出しには上記の x402 支払いメタデータの往復処理が必要で、フレームワーク固有の SDK は不要です。

購入者が管理する、分離されたサプライヤーオンボーディングの構成は、examples/aerchain-adapter で利用できます。厳格な Base Mainnet 支払いポリシー、レジストリからベンダーへのマッピング、決済レシートの処理、フィクスチャ、テストが含まれています。本番サービスには変更を加えず、公的レジストリの証拠を完全な KYB として示すこともありません。

パートナーパイロット

USDC で支払えないパートナーは、招待制のベアラキーで製品全体を利用できます。支払いは免除され、利用状況はパートナーごとに計測され、月ごとに ₪ または $ で請求されます。

製品	REST（POST）	/mcp/pilot 上の MCP ツール
請求書ゲート（PAY / HOLD / BLOCK）	/v1/pilot/invoice-gate	authorize_israeli_invoice_payment_paid
企業の検証	/v1/pilot/verify	verify_israeli_company_paid（エイリアス verify_company）
ベンダーの支払いリスク	/v1/pilot/payment-risk	assess_israeli_vendor_payment_risk_paid
企業の変更	/v1/pilot/company-changes	get_israeli_company_changes_paid

コントラクトは有料の Mainnet ルートと一致します。パイロットのレスポンスには pilot ブロックと x-pilot-* ヘッダーが追加されます。キーは PILOT_KEYS 環境変数に JSON 配列として保存され、パートナーごとに独自の SHA-256 ダイジェスト、有効期限、呼び出し許容量を持つエントリーが設定されます。生のキーがリポジトリに入ることはありません。成功した各呼び出しでは、パートナー識別子とツールを含み、生のトークンや生の IP アドレスを含まない pilot_call イベントが出力されます。UPSTASH_REDIS_REST_URL と UPSTASH_REDIS_REST_TOKEN が設定されている場合、利用状況はパートナーごとに永続的に集計（パイロット期間および暦月のハッシュ）され、許容量に対して制限されます。GET /v1/pilot/usage は、パートナー自身にはその利用状況を、オペレーターにはすべてのパートナーの利用状況を返します。Upstash がない場合、プロセス内カウンターは安全上限にすぎず、正式な合計は成功した pilot_call イベントの集計値です。キーの発行、有効化、検証、利用状況の計測、取り消しについては、パイロット運用手順書 を参照してください。

スモークテスト

保護されていない稼働中のサービスと、稼働中の公開ソースに対して実行します。

BASE_URL=http://localhost:3000 npm run smoke

x402 が有効な稼働中のサービスに対して、支払いを行わずに実行します。

BASE_URL=http://localhost:3000 EXPECT_X402=true npm run smoke

x402 スモークモードでは、HTTP 402、支払いヘッダー、プロトコルバージョン 2、設定済みの正確な価格、Bazaar メタデータを検証します。Base Sepolia では、完全な決済フローがすでに確認されています。Mainnet は運営者が資金を負担する自己支払いを行わずに稼働を続け、実際の外部支払者を待ちます。

MCP の検出と無料ツールのスモークテスト：

MCP_URL=https://israel-counterparty-intelligence.vercel.app/mcp/testnet npm run smoke:mcp

有料 MCP スモークスクリプトは /mcp/testnet に厳しく制限されており、リポジトリの外部に用意された、分離済みの Base Sepolia ウォレットファイルが必要です。

X402_TEST_WALLET_FILE=/secure/path/test-wallet.json npm run smoke:mcp:paid

リスクスコアリング v0.1.0

• 事業体が活動中ではない：+40。
• 登録簿に法令違反フラグがある：+25。
• 年次報告書が2年以上前のもの：+10。
• 0～19：LOW、20～49：MEDIUM、50～100：HIGH。
• 本人確認が曖昧な場合はスコアを付けません。
• 重要な本人確認データが欠けている場合はスコアリングを中断し、補足データが欠けている場合は信頼度を下げます。

すべてのリスクレスポンスには、reason_codes、explanation、confidence、scoring_version、推論の根拠レコードが含まれます。安全な解釈は、確認したソースに重大な公開警告フラグが見つからなかった、ということです。取引が安全だという意味では決してありません。

信頼性とプライバシー

• Zod によるレスポンス検証を備えた型付きアダプター。
• デフォルトで、中断タイムアウトと上限付きの1回の再試行。
• インメモリのソースキャッシュは6時間です。
• インスタンスごとのインメモリレート制限。
• リクエスト ID、所要時間、ソース呼び出し、支払いの有無、信頼度、エラーカテゴリー、短縮された一方向クライアントフィンガープリントを含む JSON ログ。
• 正確な Base Mainnet ルート、公式 Base USDC コントラクト、設定済みの金額、設定済みの payTo に対する決済が成功した場合に限り、external_paid_call を発行できます。Testnet と、設定済みの内部テスト支払者は対象外です。このイベントは決済後の SDK フックによって発行され、ネットワーク、資産、支払者、金額、トランザクションハッシュ、リソース、任意の検出元を含みます。
• ユーザーデータベースはなく、アプリケーションコードでは生の IP アドレスをログに記録しません。
• リポジトリにシークレットはありません。
• パイロット認証では SHA-256 トークンダイジェストを定時間で比較します。生の認証情報はリポジトリの外部に保管します。

インメモリキャッシュとレート制限は、最初の有料呼び出し実験には十分ですが、マルチリージョンの高トラフィックサービスには不十分です。実際の需要が現れてから、共有インフラを追加してください。

デプロイ

まずビルドします。

npm run check

次に、このディレクトリからリンクしてデプロイします。

vercel link
vercel deploy
vercel promote <validated-preview-url>

ランタイム環境変数はコミットせず、Vercel で設定してください。受け取り用ウォレットが正しいことを確認するまで、x402 は無効のままにしてください。x402 を有効にした後、再デプロイして、支払いを行わない 402 スモークテストを実行します。有効化や検出のために Mainnet の決済を作り出さないでください。

外部有料呼び出し #1

1. 公開 Mainnet エンドポイントと検出メタデータを稼働状態に保ちます。
2. 運営者が管理していない支払者を待ちます。
3. 実際の USDC による Base Mainnet 決済の成功と、HTTP 200 の API レスポンスを必須とします。
4. Testnet、内部ウォレット、スモークテスト、クローラー、ディレクトリのプローブは除外します。
5. ネットワーク、支払者、金額、トランザクションハッシュ、リソース、タイムスタンプを含む external_paid_call を発行します。
6. 同じイベントを、最初の Mainnet エンドツーエンドの証明であり、外部有料呼び出し #1 であるとみなします。

妥当な検出およびアウトリーチのテストを行った後も外部有料呼び出しが発生しない場合は、機能を追加しないでください。提供内容を変更するか、終了してください。

ポリシー

• 利用規約
• プライバシーに関する通知
• 訂正手続き
• ヘブライ語での実装分析
• 現在のブロッカー
• 有料決済テスト

パートナーへの引き継ぎ

PARTNER_HANDOFF.md から開始してください（ステータス、システムマップ、アウトリーチ CRM）。