Brazil AI Fiscal APIs (x402)已上线
Suíte de 7 APIs fiscais e financeiras brasileiras na borda da Cloudflare, cobradas por requisição em USDC via HTTP 402 e MCP
Visão geral do produto
É uma suíte de 7 microsserviços serverless rodando em Cloudflare Workers, voltada a automações (n8n, Make, ERPs) e a agentes de IA como Claude e Cursor. A proposta central é tirar do modelo de linguagem aquilo que ele faz mal — matemática fiscal, validação de dígitos e regras tributárias — e entregar o resultado de forma determinística na borda, cobrando por chamada com o padrão HTTP 402 Payment Required (x402 v2), em USDC na rede Base, com um servidor MCP unificado de 8 ferramentas.
Objetivo e público
- Objetivo: vender microcapacidades fiscais e financeiras brasileiras por requisição, sem cadastro, sem plano mensal e sem chave de API obrigatória para quem paga por chamada.
- Público: desenvolvedores de automação fiscal e contábil, software houses, ERPs, BPOs e agentes autônomos que precisam de dados validados dentro do pipeline.
- Problema que ataca, segundo o autor: jogar um XML de NF-e inteiro no contexto de um LLM desperdiça tokens (um XML padrão da SEFAZ passa de 4.000 tokens, quando o agente precisa de cerca de 15 campos validados), induz alucinação matemática (módulo 11 de chave de 44 dígitos, fator de vencimento FEBRABAN pós-22/02/2025, faixas de INSS/IRRF) e cria atrito de cadastro para agentes que não conseguem abrir um checkout.
Estrutura do produto: as 7 APIs
- Auditor XML NF-e / NFC-e — comprime o XML SEFAZ 4.00 (cerca de 90% menos tokens, segundo o autor), confere a matemática (vProd/vNF), CFOP, NCM, cStat=100 e decodifica a chave de 44 dígitos.
- Leitor de Boletos & Guias BR — valida e decodifica boletos FEBRABAN (47/44 dígitos, regra pós-22/02/2025), guias DARF/FGTS/IPTU (48 dígitos) e chaves NF-e.
- Motor Tributário & Folha BR — calcula Simples Nacional (Anexos I–V, com otimização do Fator R de 28%), INSS/IRRF (Legal vs. Simplificado), FGTS e retenções B2B de NFS-e.
- Business Intel CNPJ & PIX — dossiê de CNPJ (QSA, Simples/MEI, score B2B), Geo-CEP do IBGE, validador de CPF/CNPJ e gerador/leitor de PIX EMVCo CRC16.
- Calculadoras Banco Central — correção monetária oficial (IPCA, IGP-M, INPC, Selic, CDI via API SGS do BCB), câmbio PTAX oficial e simulador Price/SAC.
- Limpeza Web para IA — converte páginas HTML pesadas em Markdown limpo, tabelas JSON e JSON-LD, com métrica de economia de tokens.
- Firewall Anti-Prompt Injection — detecta prompt injection (Llama Guard 3 + heurística + decode Base64) e mascara CPF, CNPJ e chaves antes de enviar ao modelo.
Como funciona o fluxo de pagamento (x402)
- O cliente ou agente faz a requisição normal ao endpoint (por exemplo, POST /audit ou POST /calc).
- Sem cabeçalho de pagamento, o Worker responde HTTP 402 com o cabeçalho PAYMENT-REQUIRED (JSON em Base64) informando valor exato, ativo (USDC), rede (eip155:8453 / Base) e endereço recebedor.
- Um cliente compatível (como @x402/fetch ou um conector MCP com carteira Base) assina a autorização de transferência (EIP-3009) e reenvia a requisição.
- O facilitador (PayAI) valida e liquida on-chain na Base, e o Worker devolve 200 OK com o JSON estruturado.
- Para inspecionar sem gastar nada, todas as APIs têm as rotas gratuitas GET /sample e GET /openapi.json.
Preços por chamada (declarados pelo autor, em USDC na Base)
- Auditor XML NF-e / NFC-e: $0,010
- Leitor de Boletos & Guias BR: $0,008
- Motor Tributário & Folha BR: $0,008
- Business Intel CNPJ & PIX: $0,010
- Calculadoras Banco Central: $0,005
- Limpeza Web para IA: $0,002
- Firewall Anti-Prompt Injection: $0,020
Detalhes de integração
- O pacote pode ser ligado de uma vez ao Claude Desktop, Cursor ou VS Code pelo servidor MCP único `brazil-ai-suite`, que reúne as 7 APIs mais uma ferramenta gratuita de descoberta (`brazil_ai_suite_status`); o servidor também foi publicado no Glama.ai e no Official MCP Registry, segundo o autor.
- Mesmo sem a chave privada x402 configurada, o servidor sobe, lista as ferramentas e devolve os detalhes do 402 sem quebrar o loop do agente.
- Cada Worker expõe ainda POST /mcp (streamable-http), GET /llms.txt e GET /.well-known/x402.
Visual e tecnologia
- Microsserviços serverless em Cloudflare Workers, pensados para latência baixa e zero dependência pesada.
- Código e vitrine abertos sob licença MIT no GitHub.
- Para empresas que não querem usar cripto, o autor documentou um modelo B2B alternativo de acesso por API key mensal via PIX, sobre a mesma infraestrutura de borda.
Fronteiras e próximos passos declarados
- O autor pergunta à comunidade quais validações determinísticas deveriam entrar na próxima leva — citando como exemplos NFS-e Padrão Nacional, validador de SPED e CNAB 240/400 — ou seja, esses itens ainda não fazem parte da suíte.
1VR 精选 · 来源:TabNews @brunopompeo1
机器翻译 ·