opastorello/cpf-validador
API developmentЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
MCP server + REST API para validacao de CPFs e consulta ao TRT3 com solver de CAPTCHA CRNN
Обзор
Valide CPFs, descubra a quem pertencem e encontre o CPF correto a partir de dígitos parciais ou ilegíveis — com resolução automática de CAPTCHA via rede neural treinada localmente. Expõe as mesmas operações como (para agentes AI) e (para integrações diretas), com interface web incluída. Para confirmar a titularidade de um CPF, o sistema consulta o — que emite certidões públicas associando CPF e nome. A resolução de CAPTCHA é feita por uma treinada especificamente para isso, atingindo sem depender de nenhum serviço externo. Documentação interativa: http://localhost:8000/docs (disponível apenas em ENV=development). O histórico é — fica no localStorage da interface web e nunca sai do cliente. O servidor não persiste CPFs consultados. - o toggle na aba Histórico ativa ou desativa o salvamento automático; a preferência também é salva no localStorage. - não gravam histórico — cada cliente registra o que quiser do seu lado.
README
Показан фрагмент оригинального README. Открыть оригинал.
🔍 CPF Validador
Valide CPFs, descubra a quem pertencem e encontre o CPF correto a partir de dígitos parciais ou ilegíveis — com resolução automática de CAPTCHA via rede neural treinada localmente.
Expõe as mesmas operações como MCP tools (para agentes AI) e REST API (para integrações diretas), com interface web incluída.
💡 O que este projeto faz
| ✅ | Valida se um CPF é matematicamente correto |
| 👤 | Confirma a quem um CPF pertence pelo nome |
| 🔎 | Descobre o CPF completo a partir de dígitos parciais ou ilegíveis |
| 👥 | Processa dezenas de CPFs em paralelo |
| 🤖 | Integra com qualquer agente AI via protocolo MCP |
Para confirmar a titularidade de um CPF, o sistema consulta o TRT3 — que emite certidões públicas associando CPF e nome. A resolução de CAPTCHA é feita por uma CRNN (Convolutional Recurrent Neural Network) treinada especificamente para isso, atingindo ~99% de acurácia sem depender de nenhum serviço externo.
🤖 MCP Tools
| Tool | Descrição |
|---|---|
validate_cpf |
Valida matematicamente um CPF pelo algoritmo módulo-11 |
generate_valid_variations |
Gera as variações válidas a um erro de digitação do CPF: verificadores recalculados, 1 dígito trocado ou par adjacente invertido |
check_cpf |
Confirma titularidade de um CPF consultando o TRT3 |
find_cpf_by_mask |
Descobre o CPF completo a partir de uma máscara com * nos dígitos desconhecidos |
find_cpf_by_variations |
Dado um CPF parcial ou errado, encontra o correto filtrando pelo nome |
check_multiple_cpfs |
Valida e confirma titularidade de uma lista de CPFs em paralelo |
🌐 REST API
| Método | Rota | Rate limit | Descrição |
|---|---|---|---|
GET |
/ |
— | Interface web |
POST |
/cpf/validate |
— | Valida um CPF matematicamente |
POST |
/cpf/variations |
— | Gera variações válidas de um CPF |
POST |
/consulta/cpf |
10/min por IP | Confirma a titularidade de um CPF na fonte ativa |
POST |
/consulta/cpfs |
5/min por IP | Confirma lista de CPFs em paralelo |
POST |
/consulta/buscar-por-mascara |
3/min por IP | Descobre CPF por máscara com curingas |
POST |
/consulta/buscar-por-variacoes |
3/min por IP | Descobre CPF correto a partir de variações |
GET |
/auth/check |
— | Valida o token — 401 se ausente/incorreto, 200 se válido |
GET |
/health |
— | Health check — retorna {"status": "ok"} |
Documentação interativa: http://localhost:8000/docs (disponível apenas em ENV=development).
📂 Histórico de consultas
O histórico é local ao navegador — fica no localStorage da interface web e nunca sai do cliente. O servidor não persiste CPFs consultados.
- Interface web: o toggle na aba Histórico ativa ou desativa o salvamento automático; a preferência também é salva no
localStorage. - REST API / MCP: não gravam histórico — cada cliente registra o que quiser do seu lado.
Установка
npx mcp-remote http://localhost:8000/mcp --allow-httpКонфигурация
{
"mcpServers": {
"cpf-validador": {
"command": "npx",
"args": ["mcp-remote", "http://localhost:8000/mcp", "--allow-http"],
"env": {
"MCP_REMOTE_HEADER_AUTHORIZATION": "Bearer meu-token-secreto"
}
}
}
}