StatementKit

Normaliza extractos bancarios (CSV, camt, MT940, OFX, QIF) a JSON, analízalos y expórtalos (MCP remoto).

Servidor MCP alojado

npx add-mcp 'https://statementkit.zenith-ops.workers.dev/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

StatementKit

Normalizador determinista de extractos bancarios para agentes de IA y herramientas de contabilidad: CSV de cualquier banco, camt.052/053/054, MT940, OFX/QFX y QIF de entrada; JSON normalizado, análisis y exportación a CSV/hledger/SIE4 de salida.

URL base

https://statementkit.zenith-ops.workers.dev

Endpoints gratuitos

  • GET /v1/formats - formatos admitidos, límites, precios
  • POST /v1/free/parse - demo: cuerpo de hasta 24 KB, primeras 100 transacciones más analysis_preview, 20 solicitudes por hora por cliente. Acepta JSON {content, ...} o un cuerpo de texto/csv, text/plain o application/xml.

Endpoints de pago (x402 v2, esquema exacto, eip155:8453, USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, pagar a 0x9f950fbeE661D8867750750F600Ff03fb7BAbe8D)

  • POST /v1/parse - $0.005 - Analiza un extracto bancario (CSV de cualquier banco, camt.052/053/054, MT940, OFX/QFX, QIF) en JSON normalizado: cuentas, saldos y transacciones firmadas con fechas ISO, contraparte, referencia y número OCR. Determinista, sin IA, no se almacena nada. Cuerpo JSON de hasta 1000 KB. Las llamadas fallidas (4xx/5xx) no se liquidan.
  • POST /v1/analyze - $0.01 - Analiza un extracto y añade análisis: totales mensuales, principales contrapartes, pagos recurrentes, duplicados sospechosos, transacciones más grandes y conciliación de saldos. Establece include_transactions=false para recibir solo el análisis. Cuerpo JSON de hasta 1000 KB. Las llamadas fallidas (4xx/5xx) no se liquidan.
  • POST /v1/convert - $0.005 - Analiza un extracto y lo exporta como CSV normalizado, un diario hledger, un archivo SIE4 (experimental) o JSON. El archivo convertido se devuelve como una cadena en el campo content. Cuerpo JSON de hasta 1000 KB. Las llamadas fallidas (4xx/5xx) no se liquidan.

Cuerpo de la solicitud: JSON {content: string, format?, delimiter?, decimal?, dateFormat?, currency?, columns?, includeRaw?}. analyze añade today? e include_transactions?; convert añade to (csv|hledger|sie4|json) y bankAccount?, expenseAccount?, incomeAccount?, assetAccount?, company?. Una solicitud no pagada devuelve HTTP 402 con un encabezado PAYMENT-REQUIRED (JSON en base64). Reintenta con un encabezado PAYMENT-SIGNATURE; @x402/fetch hace esto automáticamente. Solo se te cobra cuando el estado de la respuesta es inferior a 400; los errores de validación son gratuitos.

Formatos admitidos

  • CSV: Cualquier banco; encabezados EN/SV/DE/FR/NL/ES; delimitador, decimal y formato de fecha detectados automáticamente
  • camt.052 / camt.053 / camt.054: XML ISO 20022, espacios de nombres v02 a v08
  • MT940 / MT942: Extractos SWIFT incl. subcampos :86:
  • OFX / QFX: SGML 1.x y XML 2.x, bancario y tarjeta de crédito
  • QIF: Archivos estilo !Type:Bank

MCP

https://statementkit.zenith-ops.workers.dev/mcp (HTTP transmisible, JSON-RPC 2.0). Herramientas: list_formats, parse_statement_demo (gratuita), parse_statement, analyze_statement, convert_statement (de pago: responde con los requisitos de pago x402 hasta que se envíe un encabezado de pago).

Límites y notas de honestidad

  • Cuerpo de solicitud de pago: JSON de hasta 1000 KB
  • Demo gratuita: POST /v1/free/parse: cuerpo de hasta 24 KB, primeras 100 transacciones, 20 solicitudes por hora por cliente (mejor esfuerzo, en memoria por isolate)
  • Entrada: Solo texto. No se admiten PDF ni extractos escaneados o fotografiados (sin OCR).
  • Importes: Números JSON (flotantes) redondeados a céntimos; no los sumes con aritmética de flotantes sin redondear.
  • Errores: Cada 4xx/5xx es gratuito: el pago solo se liquida para respuestas inferiores a 400.
  • El análisis es heurística determinista, no certificada por el banco. Comprueba siempre el resultado, especialmente la detección de columnas y fechas CSV (ver advertencias).
  • Las fechas ambiguas (01/02/2026) y los separadores decimales se adivinan por archivo; la elección se informa en meta y warnings.
  • El análisis (pagos recurrentes, duplicados, contrapartes) es heurístico: los duplicados se sospechan, nunca se eliminan.
  • La exportación SIE4 es experimental. Verifica los números de cuenta antes de importarlos en software de contabilidad.
  • El límite de tasa gratuito es de mejor esfuerzo: vive en la memoria de un isolate de Worker y puede reiniciarse.
  • Sin PDF, sin OCR, sin soporte de imágenes.

Privacidad

Los documentos se procesan en memoria y nunca se almacenan ni registran. Los registros contienen solo la operación, el formato detectado, los tamaños y los códigos de error. No hay base de datos. Los pagos son verificados y liquidados por el facilitador x402.

Otros