URL Analysis Tool

Ferramenta de análise de URL

Este repositório contém uma ferramenta baseada em Python para analisar URLs e detectar ameaças em potencial usando vários serviços de segurança cibernética, como Virustottal e Urlscan.io. A ferramenta combina os resultados da verificação com as informações do WHOIS e fornece uma interface amigável para twittar as descobertas de análise ou mensagens personalizadas.

Características

• Digitalize URLs usando Virustotal e Urlscan.io APIs
• Recuperar as informações do WHOIS para os domínios analisados
• Salvar os resultados da análise combinada em arquivos de saída numerados
• Interaja com a API do Twitter para publicar tweets contendo os resultados da análise ou texto personalizado
• Interface da linha de comando amigável

☕ Apoie meu trabalho em Ko-Fi

Estrutura do repositório

• controller.py : o principal ponto de entrada do aplicativo, manipulando a entrada do usuário, coordenando a execução de vários módulos e fornecendo a interface do usuário.
• output_module.py : lida com a formatação e economia dos resultados da análise nos arquivos de saída no diretório outputs .
• twitter_module.py : permite que os usuários interajam com a API do Twitter para publicar tweets contendo resultados de análise ou texto personalizado.
• urlscan_module.py : interage com a API URLScan.io para enviar URLs para digitalização e recuperar os resultados da varredura.
• virustotal_module.py : interage com a API Virustototal para digitalizar URLs e recuperar os resultados da análise.
• whois_module.py : busca informações de whois para um determinado domínio.
• configs/ : Diretório contendo arquivos de configuração com as chaves da API para Virustototal, UrlScan.io e Twitter.
• outputs/ : diretório em que os resultados da análise são salvos como arquivos de texto numerados.

Junte -se ao meu servidor Discord

Uso

1. Clone o repositório ou faça o download do código -fonte.
2. Instale os pacotes Python necessários executando pip install -r requirements.txt .
3. Obtenha chaves da API para Virustotal, Urlscan.io e Twitter e crie arquivos de configuração no diretório configs com as respectivas teclas de API.
4. Execute o script controller.py .
5. Siga os avisos para inserir um URL para digitalização, twittar os resultados ou escanear outro URL.

Arquivos de configuração

A ferramenta requer teclas de API para Virustotal, UrlScan.io e Twitter. Essas chaves devem ser armazenadas em arquivos JSON separados no diretório configs com a seguinte estrutura:

• virustotal_config.json :

  {
    "api_key" : " your_virustotal_api_key "
  }

• urlscan_config.json :

  {
    "api_key" : " your_urlscan_api_key "
  }

• twitter_config.json :

  {
    "consumer_key" : " your_twitter_consumer_key " ,
    "consumer_secret" : " your_twitter_consumer_secret " ,
    "access_token" : " your_twitter_access_token " ,
    "access_token_secret" : " your_twitter_access_token_secret "
  }

Arquivos de saída

Os resultados da análise são salvos como arquivos de texto numerados no diretório outputs . Cada arquivo contém as seguintes informações:

• URL digitalizado
• Domínio
• Registrador
• Datas de criação e validade
• Tipos de ameaças
• Endereços IP e países associados ao URL
• Data de varredura
• Screenshot URL
• URLs de relatórios de vírus e urlscan.io

Dependências

Este projeto requer as seguintes bibliotecas Python:

• requests
• tweepy
• python-whois

Instale essas dependências executando pip install -r requirements.txt antes de executar o aplicativo.

Contribuindo

As contribuições para este projeto são bem -vindas! Se você encontrar algum problema ou ter sugestões de melhorias, abra um problema ou envie uma solicitação de tração. Siga o fluxo de trabalho padrão do GitHub para contribuições.

Licença

Este projeto está licenciado sob a licença do MIT. Consulte o arquivo de licença para obter mais detalhes.