IBANforge

IBAN検証およびBIC/SWIFT検索API。SEPAコンプライアンスデータ、発行者分類、リスク指標、x402マイクロペイメント、およびAIエージェント向けのMCP統合を提供します。

特徴

• IBAN検証 — 完全なmod-97チェックサム検証、BBAN構造解析、84カ国対応

• BIC/SWIFT検索 — GLEIFによる121,000件以上のエントリとLEIエンリッチメント

• SEPAコンプライアンス — 会員ステータス、決済スキーム（SCT/SDD/SCT_INST）、国ごとのVoP要件

• 発行者分類 — 従来の銀行、ネオバンク、EMI（Wise、Revolut、N26など）、およびvIBAN検出のための決済機関を識別

• リスク指標 — 複合リスクシグナル：発行者タイプ、国リスク（FATFベース）、テスト用BIC、SEPA到達可能性、VoPカバレッジ

• バッチ処理 — 1回の呼び出しで最大100件のIBANを検証

• x402マイクロペイメント — USDCによる従量課金（1リクエストあたり$0.002から）

• MCPサーバー — Model Context Protocolを介したネイティブなAIエージェント統合

• セルフホスト — Dockerデプロイ、SQLiteデータベース、外部依存関係なし

クイックスタート

git clone https://github.com/cammac-creator/ibanforge.git
cd ibanforge
npm install
cp .env.example .env
npm run dev

APIエンドポイント

例

IBANの検証

curl -X POST https://api.ibanforge.com/v1/iban/validate \
  -H "Content-Type: application/json" \
  -d '{"iban": "CH93 0076 2011 6238 5295 7"}'

BICの検索

curl https://api.ibanforge.com/v1/bic/UBSWCHZH80A

MCP統合

Claude DesktopまたはAIエージェントの設定に追加してください：

{
  "mcpServers": {
    "ibanforge": {
      "command": "npx",
      "args": ["tsx", "src/mcp/server.ts"],
      "cwd": "/path/to/ibanforge"
    }
  }
}

利用可能なツール：validate_iban, batch_validate_iban, lookup_bic

開発

npm run dev          # Dev server (hot reload)
npm run test         # Run tests
npm run check        # Typecheck + lint + test
npm run db:seed      # Rebuild BIC database from GLEIF

デプロイ

Docker

docker build -t ibanforge .
docker run -p 3000:3000 --env-file .env ibanforge

Railway

mainブランチにプッシュすると、RailwayがDockerfileを介して自動的にデプロイします。

環境変数

データソース

• BIC/SWIFTエントリ: GLEIF BIC-LEIマッピング

• LEIエンリッチメント: GLEIF API

• 国名: Node.js Intl.DisplayNames API

ライセンス

MIT