BuscaCpf

Uma ferramenta CLI para buscar informações públicas de CPF no Portal da Transparência do Governo Federal do Brasil.

Descrição

BuscaCpf consulta o Portal da Transparência e extrai informações associadas a um número de CPF, incluindo:

• Nome da pessoa
• Benefícios públicos
• Datas de registros
• Valores monetários associados
• Metadados da página de resultado

Requisitos

• Node.js >= 14
• npm

Instalação

git clone https://github.com/ojaneri/BuscaCpf.git
cd BuscaCpf
npm install

Uso

Busca básica (apenas nome)

node buscar_cpf.js 11144477735

Saída:

{
  "cpf": "11144477735",
  "found": true,
  "nome": "NOME DA PESSOA"
}

Busca completa (dados detalhados)

node buscar_cpf.js 11144477735 --full

Saída:

{
  "cpf": "11144477735",
  "nome": "NOME DA PESSOA",
  "url": "https://portaldatransparencia.gov.br/...",
  "found": true,
  "full": true,
  "beneficios": [...],
  "datas": {...},
  "valores": {...},
  "metadata": {...}
}

Opções

Opção	Descrição
--full	Retorna dados completos (nome, URL, benefícios, datas, valores)

Formato de Saída

Todos os resultados são retornados em formato JSON:

{
  "cpf": "string",
  "found": boolean,
  "nome": "string (se encontrado)",
  "full": boolean,
  "beneficios": [{
    "tipo": "string",
    "ocorrencias": number
  }],
  "datas": {
    "primeira": "DD/MM/YYYY",
    "ultima": "DD/MM/YYYY",
    "unicas": ["DD/MM/YYYY"],
    "quantidade": number
  },
  "valores": {
    "total": "R$ X,XX",
    "todos": ["R$ X,XX"],
    "quantidade": number
  },
  "metadata": {
    "secoes": ["string"],
    "tabelas": number,
    "celulas": number
  }
}

Como Funciona

1. Inicia uma instância do Chromium via Puppeteer em modo headless
2. Acessa o Portal da Transparência
3. Realiza busca pelo CPF fornecido
4. Extrai dados da página HTML usando expressões regulares
5. Retorna os dados em formato JSON
6. Implementa retry automático em caso de timeout

Tratamento de Erros

A ferramenta retorna mensagens de erro em JSON:

{
  "cpf": "string",
  "found": false,
  "error": "mensagem de erro"
}

Limitações

• Depende da disponibilidade e estrutura HTML do Portal da Transparência
• Uso intensivo pode resultar em rate limiting
• Dados extraídos dependem da estrutura atual do portal

Licença

MIT

Autor

Osvaldo J. Filho

• GitHub: @ojaneri
• LinkedIn: linkedin.com/in/ojaneri

Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues e pull requests.

---

Aviso Legal: Esta ferramenta acessa dados públicos disponibilizados pelo Governo Federal. Certifique-se de cumprir com a legislação aplicável ao usar esta ferramenta.