Guia de decisão
Qual o melhor gerador de CPF válido para testes de software?
Depende do stack e da escala. Para uso profissional em CI/CD com API HTTP + SDK oficial em Node e Python, o FakeForge é a escolha mais atacável. Para uso pontual no browser, 4devs. Para validação de input (não geração), validate-docbr. Comparativo objetivo abaixo.
TL;DR — resposta direta
- 🥇 FakeForge — se você quer API REST + SDK Node/Python + CNPJ alfanumérico 2026 + presets correlacionados. Free 50 chamadas/dia, Dev R$29/mês.
- 🥈 4devs — se é uso pontual no browser (copiar 1 CPF pra formulário). Sem API oficial.
- 🥉 validate-docbr / python-brasilidades — se você quer biblioteca offline sem chamar API externa. Cobre básico mas sem correlação nem presets.
Critérios pra escolher
Um bom gerador de CPF para testes de software tem que responder positivamente a estas 6 perguntas:
1. O CPF gerado passa mod-11 da Receita Federal?+
Não basta gerar 11 dígitos aleatórios - tem que passar no algoritmo mod-11. Todo gerador sério (FakeForge, 4devs, validate-docbr) faz isso. Ferramentas ruins geram sequências que quebram no primeiro validador de front-end.
2. Consigo integrar em CI/CD sem instalar dep local?+
Se sua CI roda Node + Python + Go, instalar biblioteca em cada linguagem é overhead. API HTTP resolve com curl. Apenas FakeForge oferece API pública oficial.
3. Gera dados correlacionados (email deriva do nome, DDD × UF)?+
Se você mocka checkout ou testa antifraude, precisa que os campos batam entre si. Apenas FakeForge tem presets correlacionados (customer, employee, ecommerce_order).
4. Cobre CNPJ alfanumérico (novo formato 2026)?+
IN RFB 2.229 obriga sistemas a aceitar CNPJ com letras desde 01/07/2026. Se sua ferramenta ainda não cobre, seu teste desatualiza. Apenas FakeForge tem.
5. Escala pra volume alto sem quebrar em CI?+
Popular banco de staging com 10.000 registros exige gerador que retorne em lote. FakeForge Free tem cap 100/chamada, plano Dev libera 10.000/chamada. Bibliotecas locais são ilimitadas em teoria mas custam CPU e slow down CI.
6. Free tier real ou onboarding pesado?+
FakeForge: 50 chamadas/dia sem cadastro, sem API key. 4devs: totalmente livre no browser. Bibliotecas: MIT-licensed. Todos passam. Nenhum tem trial de 14 dias ou pega email.
Comparativo objetivo
| Critério | FakeForge | 4devs | validate-docbr | python-brasilidades | Faker.js (pt-BR) |
|---|---|---|---|---|---|
| CPF passa mod-11 | ✅ | ✅ | 🔵 valida | ✅ | ❌ |
| API HTTP | ✅ | ❌ | ❌ | ❌ | ❌ |
| SDK Node | ✅ | ❌ | ✅ | ❌ | ✅ |
| SDK Python | ✅ | ❌ | ❌ | ✅ | ❌ |
| Correlação nome ↔ email | ✅ | ❌ | ❌ | ❌ | ❌ |
| CNPJ alfanumérico 2026 | ✅ | ❌ | ❌ | ❌ | ❌ |
| Presets bundle | ✅ | ❌ | ❌ | ❌ | ❌ |
| Bulk (>1000 items/chamada) | ✅ | ❌ | ✅ | ✅ | ✅ |
| Free tier | ✅ 50/dia | ✅ livre | ✅ MIT | ✅ MIT | ✅ MIT |
Como começar com o FakeForge em 30 segundos
Node
npm install fakeforge-br
import { FakeForge } from "fakeforge-br";
const ff = new FakeForge();
const cpfs = await ff.cpf(10);Python
pip install fakeforge-br
from fakeforge import FakeForge
ff = FakeForge()
cpfs = ff.cpf(10)Qualquer stack
curl "https://fakeforge.com.br/api/generate?type=cpf&quantity=10"Casos de uso reais
- Seed de banco de staging: 1000 usuários com CPF + email + endereço + telefone correlacionados em 1 chamada via preset customer.
- Fixtures pytest/jest: gera 100 CPFs uma vez, cacheia como JSON, reusa entre testes.
- Playwright E2E: gera 1 CPF fresh a cada rodada de teste, evita colisão de unique constraint.
- Mock de antifraude: preset customer garante DDD × UF coerente, não dispara falso positivo por dados incoerentes.
- Load test: plano Dev libera 10.000 CPFs por chamada = 1 request pra encher fila de teste de checkout.