StatementKit

Normalize extratos bancários (CSV, camt, MT940, OFX, QIF) para JSON, analise e exporte-os (MCP remoto).

Ver em workers.dev

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

StatementKit

Normalizador determinístico de extratos bancários para agentes de IA e ferramentas de escrituração contábil: CSV de qualquer banco, camt.052/053/054, MT940, OFX/QFX e QIF na entrada; JSON normalizado, análise e exportação em CSV/hledger/SIE4 na saída.

URL base

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

Endpoints gratuitos

  • GET /v1/formats - formatos suportados, limites, preços
  • POST /v1/free/parse - demonstração: corpo de até 24 KB, primeiras 100 transações mais analysis_preview, 20 requisições por hora por cliente. Aceita JSON {content, ...} ou corpo bruto text/csv, text/plain ou application/xml.

Endpoints pagos (x402 v2, esquema exato, eip155:8453, USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, pagar para 0x9f950fbeE661D8867750750F600Ff03fb7BAbe8D)

  • POST /v1/parse - $0.005 - Analisa um extrato bancário (CSV de qualquer banco, camt.052/053/054, MT940, OFX/QFX, QIF) em JSON normalizado: contas, saldos e transações assinadas com datas ISO, contraparte, referência e número OCR. Determinístico, sem IA, nada é armazenado. Corpo JSON de até 1000 KB. Chamadas com falha (4xx/5xx) não são cobradas.
  • POST /v1/analyze - $0.01 - Analisa um extrato e adiciona análise: totais mensais, principais contrapartes, pagamentos recorrentes, duplicatas suspeitas, maiores transações e reconciliação de saldo. Defina include_transactions=false para receber apenas a análise. Corpo JSON de até 1000 KB. Chamadas com falha (4xx/5xx) não são cobradas.
  • POST /v1/convert - $0.005 - Analisa um extrato e o exporta como CSV normalizado, diário hledger, arquivo SIE4 (experimental) ou JSON. O arquivo convertido é retornado como string no campo content. Corpo JSON de até 1000 KB. Chamadas com falha (4xx/5xx) não são cobradas.

Corpo da requisição: JSON {content: string, format?, delimiter?, decimal?, dateFormat?, currency?, columns?, includeRaw?}. analyze adiciona today? e include_transactions?; convert adiciona to (csv|hledger|sie4|json) e bankAccount?, expenseAccount?, incomeAccount?, assetAccount?, company?. Uma requisição não paga retorna HTTP 402 com um cabeçalho PAYMENT-REQUIRED (JSON em base64). Repita com um cabeçalho PAYMENT-SIGNATURE; @x402/fetch faz isso automaticamente. Você é cobrado apenas quando o status da resposta é inferior a 400; erros de validação são gratuitos.

Formatos suportados

  • CSV: Qualquer banco; cabeçalhos EN/SV/DE/FR/NL/ES; delimitador, decimal e formato de data detectados automaticamente
  • camt.052 / camt.053 / camt.054: XML ISO 20022, namespaces v02 a v08
  • MT940 / MT942: extratos SWIFT incluindo subcampos :86:
  • OFX / QFX: SGML 1.x e XML 2.x, banco e cartão de crédito
  • QIF: arquivos estilo !Type:Bank

MCP

https://statementkit.zenith-ops.workers.dev/mcp (HTTP streamable, JSON-RPC 2.0). Ferramentas: list_formats, parse_statement_demo (gratuita), parse_statement, analyze_statement, convert_statement (pagas: responda com requisitos de pagamento x402 até que um cabeçalho de pagamento seja enviado).

Limites e notas de honestidade

  • Corpo de requisição paga: JSON de até 1000 KB
  • Demonstração gratuita: POST /v1/free/parse: corpo de até 24 KB, primeiras 100 transações, 20 requisições por hora por cliente (melhor esforço, em memória por isolate)
  • Entrada: Somente texto. PDF e extratos escaneados ou fotografados NÃO são suportados (sem OCR).
  • Valores: números JSON (floats) arredondados para centavos; não os some com aritmética de ponto flutuante sem arredondamento.
  • Erros: Todo 4xx/5xx é gratuito: o pagamento é liquidado apenas para respostas abaixo de 400.
  • A análise é heurística determinística, não certificada por banco. Sempre verifique o resultado, especialmente a detecção de colunas e datas em CSV (veja avisos).
  • Datas ambíguas (01/02/2026) e separadores decimais são adivinhados por arquivo; a escolha é relatada em meta e warnings.
  • A análise (pagamentos recorrentes, duplicatas, contrapartes) é heurística: duplicatas são suspeitas, nunca removidas.
  • A exportação SIE4 é experimental. Verifique os números de conta antes de importá-la em software de escrituração contábil.
  • O limite de taxa gratuito é de melhor esforço: vive na memória de um isolate Worker e pode ser redefinido.
  • Sem PDF, sem OCR, sem suporte a imagens.

Privacidade

Os documentos são processados em memória e nunca armazenados ou registrados em log. Os logs contêm apenas a operação, o formato detectado, tamanhos e códigos de erro. Não há banco de dados. Os pagamentos são verificados e liquidados pelo facilitador x402.

Outros