Repository avatar
AI Tools
v2.4.0
active

br-danfse-rtc-x402

io.github.brunopompeo1/br-danfse-rtc-x402

Brazil DANFSe Nacional HTML & Tax Reform CBS/IBS/ISS (LC 214/2025) engine via x402 Base USDC.

Documentation

Suíte Brasil IA — APIs Fiscais, Contábeis, Financeiras, E-mail & Segurança (x402 + MCP)

English Documentation (README.en.md) | Guia B2B para Empresas (PIX / API Key) | Catálogo JSON | llms.txt

Conjunto de 9 APIs serverless em produção na Cloudflare Edge projetadas para escritórios de contabilidade, BPOs financeiros, ERPs, fintechs, automações (n8n / Make) e agentes autônomos de IA.

  • Liquidação nativa x402 v2 na rede Base: Compatíveis com Coinbase CDP Facilitator (e fallback automático PayAI), listadas no Agentic Market, x402scan.com (GET /openapi.json OpenAPI 3.1.0), Glama Connectors e Official MCP Registry.
  • Conector MCP Unificado em 1 comando: Conecte todas as 9 ferramentas de uma vez no Claude Desktop, Cursor, VS Code ou Windsurf via npx -y github:brunopompeo1/brazil-ai-fiscal-apis-x402.
  • Amostra gratuita em cada API: Chame GET /sample em qualquer serviço para inspecionar o payload real sem custo antes de pagar.

Catálogo de APIs em Produção (9 Serviços)

ServiçoO que resolve na práticaEndpoint Pago (x402)Preço (Base USDC)Amostra Grátis
1. Auditor XML NF-e / NFC-eComprime XML SEFAZ 4.00 (~90% menos tokens), confere matemática (vProd/vNF), CFOP, NCM, cStat=100 e decodifica chave de 44 dígitosPOST https://br-nfe-xml-auditor-x402.architect-x402.workers.dev/audit$0.010/sample
2. DANFSe Nacional & Reforma Tributária (RTC)Gera DANFSe oficial da NFS-e Nacional e calcula tributos da Reforma Tributária (CBS, IBS e ISS — LC 214/2025)POST https://br-danfse-rtc-x402.architect-x402.workers.dev/generate$0.005/sample
3. Leitor de Boletos & Guias BRValida e decodifica Boletos FEBRABAN (47/44 dígitos, regra pós-22/02/2025), guias DARF/FGTS/IPTU (48 dígitos) e chaves NF-ePOST https://br-docs-parser-x402.architect-x402.workers.dev/parse$0.008/sample
4. Motor Tributário & Folha BRCalcula Simples Nacional (Anexos I–V + otimização Fator R 28%), INSS/IRRF (Legal vs Simplificado) + FGTS e retenções B2B de NFS-ePOST https://br-tax-payroll-calc-x402.architect-x402.workers.dev/calc$0.008/sample
5. Business Intel CNPJ & PIXDossiê completo de CNPJ (QSA, Simples/MEI, score de risco B2B), Geo-CEP IBGE, validador CPF/CNPJ e gerador/leitor de PIX EMVCo CRC16POST https://br-business-intel-x402.architect-x402.workers.dev/intel$0.010/sample
6. Calculadoras Banco CentralCorreção monetária oficial (IPCA, IGP-M, INPC, Selic, CDI via API SGS), câmbio PTAX oficial (BRL/USD/EUR/GBP) e simulador Price/SACPOST https://br-fin-calculators-x402.architect-x402.workers.dev/fin$0.005/sample
7. Limpeza Web para IAConverte qualquer página HTML pesada em Markdown limpo, tabelas JSON e JSON-LD com métrica de economia de tokensGET https://web-enrichment-x402.architect-x402.workers.dev/clean?url=https://example.com&format=json$0.002/sample
8. Disparo de E-mail para AgentesGateway transacional pay-per-call sem mensalidade SaaS: compila Markdown em HTML responsivo e envia alertas/notificações por e-mailPOST https://agent-email-x402.architect-x402.workers.dev/send$0.005/sample
9. Firewall Anti-Prompt InjectionDetecta injeção de prompt (Llama Guard 3 + heurística + Base64) e mascara dados sensíveis (CPF, CNPJ, chaves) antes de enviar ao modeloPOST https://agent-guard-x402.architect-x402.workers.dev/guard$0.008/sample

Como usar agora mesmo

Descobrir não executa uma ferramenta paga. Sem credenciais, o conector inicia em discovery_only: lista ferramentas, mas chamadas reais retornam cobrança. Configure localmente X402_PRIVATE_KEY com uma carteira com USDC na Base, ou BRAZIL_AI_API_KEY com uma chave B2B válida. Não compartilhe credenciais em mensagens.

Após instalar as dependências do repositório, teste a amostra gratuita com node examples/execute.mjs. Para executar uma chamada real de limpeza web, use node examples/execute.mjs --execute: custa 0,002 USDC com carteira, ou consome uma chamada da cota B2B. O exemplo usa o mesmo cliente de pagamento do conector e devolve erro se a execução falhar.

Os endereços remotos /mcp também exigem um cliente que trate a cobrança x402 ou envie X-API-Key; adicionar apenas a URL não configura pagamento automático. Os exemplos quickstart.ts e quickstart.py inspecionam a cobrança, sem liquidar pagamentos.

1. Servidor MCP Unificado (Claude Desktop, Cursor, VS Code, Windsurf)

Cole no seu claude_desktop_config.json ou .cursor/mcp.json (ver examples/ai-connectors.json):

{
  "mcpServers": {
    "brazil-ai-suite": {
      "command": "npx",
      "args": ["-y", "github:brunopompeo1/brazil-ai-fiscal-apis-x402"],
      "env": {
        "X402_PRIVATE_KEY": "",
        "X402_MAX_USDC_PER_CALL": "0.05"
      }
    }
  }
}
  • Com X402_PRIVATE_KEY configurada (carteira com USDC na Base), os micropagamentos x402 ocorrem automaticamente via @x402/fetch.
  • Sem carteira configurada, todas as ferramentas continuam visíveis e retornam os requisitos exatos HTTP 402 sem quebrar o agente (além da ferramenta gratuita brazil_ai_suite_status).

2. Em Sistemas, ERPs, Python ou TypeScript (Pay-per-use x402)

Todas as rotas pagas retornam HTTP 402 com o cabeçalho PAYMENT-REQUIRED detalhando o valor em USDC na rede Base:

Teste rápido via terminal (curl) para ver o contrato OpenAPI 3.1 ou a amostra gratuita:

curl -s https://br-danfse-rtc-x402.architect-x402.workers.dev/sample
curl -s https://br-nfe-xml-auditor-x402.architect-x402.workers.dev/openapi.json

3. Contratação B2B para Empresas e Escritórios (PIX / Mensalidade)

Quer integrar no seu ERP, sistema contábil ou fluxo n8n pagando mensalidade fixa em Reais via PIX com API Key dedicada (sem precisar usar carteira cripto)?

Confira os planos e peça um piloto em docs/GUIA_EMPRESAS_B2B.md.


Descoberta Automática para IAs

  • Catálogo completo: catalog.json
  • Índice llms.txt: llms.txt
  • Cada serviço expõe individualmente GET /health, GET /openapi.json, GET /sample, GET /llms.txt, GET /.well-known/x402 e POST /mcp.