IBANforge

API для валидации IBAN и поиска BIC/SWIFT с данными о соответствии SEPA, классификацией эмитентов, индикаторами риска, микроплатежами x402 и интеграцией MCP для ИИ-агентов.

Возможности

• Валидация IBAN — полная проверка контрольной суммы mod-97, разбор структуры BBAN, 84 страны

• Поиск BIC/SWIFT — более 121 000 записей из GLEIF с обогащением LEI

• Соответствие SEPA — статус членства, платежные схемы (SCT/SDD/SCT_INST), требования VoP по странам

• Классификация эмитентов — определение традиционных банков, необанков, EMI (Wise, Revolut, N26...) и платежных учреждений для выявления vIBAN

• Индикаторы риска — составной сигнал риска: тип эмитента, страновой риск (на основе FATF), тестовый BIC, доступность SEPA, покрытие VoP

• Пакетная обработка — валидация до 100 IBAN за один запрос

• Микроплатежи x402 — оплата за запрос в USDC (от $0.002 за запрос)

• MCP-сервер — нативная интеграция ИИ-агентов через протокол Model Context Protocol

• Self-hosted — развертывание через 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 или вашего ИИ-агента:

{
  "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: API GLEIF

• Названия стран: Node.js API Intl.DisplayNames

Лицензия

MIT