Repolode
projectdiscovery

projectdiscovery/uncover

Uma CLI em Go que consulta vários buscadores da internet para encontrar hosts expostos, com saída pronta para ser encadeada a outras ferramentas.

Alternativa open source a:Shodan

Estrelas
3,086
Forks
280
Issues abertas
13
Último commit
há 6 dias

O que é?

uncover é um wrapper em Go para as APIs de vários buscadores da internet, incluindo Shodan, Censys, FOFA, Hunter, Quake, ZoomEye, Netlas, Criminal IP, Google e outros. Você informa uma consulta na sintaxe própria de cada buscador, e a ferramenta retorna pares de IP e porta, nomes de host ou linhas em um formato personalizado que correspondam à consulta.

A ferramenta foi feita para automação. A entrada pode vir de stdin, de um arquivo de consultas ou de um arquivo de configuração, e a saída pode ser texto simples, JSONL ou a resposta bruta da API. Os resultados podem ser encaminhados diretamente para ferramentas como naabu, httpx e nuclei. É possível configurar várias API keys por provedor; a cada execução, uma delas é escolhida aleatoriamente. Também é possível configurar limites de requisições e novas tentativas.

O projeto também pode ser importado como uma biblioteca Go. O Shodan InternetDB está disponível sem API key e, por padrão, é usado quando a entrada é um IP ou CIDR para listar as portas abertas.

Recursos principais

  • 01Consulta vários buscadores em uma única execução.
  • 02Oferece suporte a Shodan, Censys, FOFA, ZoomEye, Quake, Hunter, Netlas e cerca de dez outros buscadores.
  • 03Lê consultas de stdin, arquivos ou configurações e grava os resultados em stdout ou em um arquivo.
  • 04Alterna aleatoriamente entre várias API keys por provedor.
  • 05Gera saída em texto simples, JSONL ou respostas brutas da API, com seleção de campos (ip, port, host).
  • 06Pode ser usada como biblioteca Go.

Casos de uso

  • Mapear a superfície de ataque e fazer reconhecimento durante atividades de bug bounty ou testes de penetração.
  • Encontrar na internet instâncias expostas de um produto específico para pesquisas de segurança.
  • Encaminhar hosts encontrados para scanners de portas e ferramentas de sondagem web em um pipeline automatizado.

Início rápido

  1. 1

    Instale o uncover com Go (requer go1.21)

    go install -v github.com/projectdiscovery/uncover/cmd/uncover@latest
  2. 2

    Configure as chaves de API dos mecanismos de busca que pretende usar no arquivo de configuração do provedor

  3. 3

    Execute uma consulta de busca com o mecanismo Shodan padrão

    echo 'ssl:"Uber Technologies, Inc."' | uncover

Antes de usar

  • São necessárias chaves de API dos mecanismos de busca; a maioria exige cadastro.
  • Para instalar a partir do código-fonte, é necessário ter o Go 1.21 ou superior.

Tópicos

Perguntas frequentes

O que é uncover?
Uma CLI em Go que consulta vários buscadores da internet para encontrar hosts expostos, com saída pronta para ser encadeada a outras ferramentas. uncover é um wrapper em Go para as APIs de vários buscadores da internet, incluindo Shodan, Censys, FOFA, Hunter, Quake, ZoomEye, Netlas, Criminal IP, Google e outros. Você informa uma consulta na sintaxe própria de cada buscador, e a ferramenta retorna pares de IP e porta, nomes de host ou linhas em um formato personalizado que correspondam à consulta.
uncover é gratuito? Qual é a licença?
uncover é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
uncover ainda é mantido?
Manutenção ativa. O último commit de uncover foi em 13 de out. de 2026.
Para que posso usar uncover?
Mapear a superfície de ataque e fazer reconhecimento durante atividades de bug bounty ou testes de penetração. Encontrar na internet instâncias expostas de um produto específico para pesquisas de segurança. Encaminhar hosts encontrados para scanners de portas e ferramentas de sondagem web em um pipeline automatizado.
Como instalar uncover?
Instale o uncover com Go (requer go1.21): go install -v github.com/projectdiscovery/uncover/cmd/uncover@latest Configure as chaves de API dos mecanismos de busca que pretende usar no arquivo de configuração do provedor Execute uma consulta de busca com o mecanismo Shodan padrão: echo 'ssl:"Uber Technologies, Inc."' | uncover
Onde consigo uncover?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/projectdiscovery/uncover

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados