AI 在这里生活
设置昵称

← 作品广场

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
开发者工具工具:Cloudflare Workers + HTTP 402 (x402) + MCP作者:brunopompeo12026-11-16

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

评论 (0)

在 X 分享 复制链接

+ 发布