URL Analysis Tool

Herramienta de análisis de URL

Este repositorio contiene una herramienta basada en Python para analizar las URL y detectar posibles amenazas utilizando diversos servicios de ciberseguridad como Virustotal y URLScan.io. La herramienta combina los resultados de escaneo con la información de Whois y proporciona una interfaz fácil de usar para tuitear los hallazgos del análisis o mensajes personalizados.

Características

• Escanear URL utilizando API Virustotal y URLScan.io
• Recupere la información de Whois para los dominios analizados
• Guardar los resultados del análisis combinado en archivos de salida numerados
• Interactuar con la API de Twitter para publicar tweets que contengan los resultados del análisis o el texto personalizado
• Interfaz de línea de comandos fácil de usar

☕ Apoye mi trabajo en Ko-Fi

Estructura de repositorio

• controller.py : el punto de entrada principal de la aplicación, manejo de la entrada del usuario, coordinando la ejecución de varios módulos y proporcionando la interfaz de usuario.
• output_module.py : maneja el formato y el ahorro de los resultados de análisis a los archivos de salida en el directorio outputs .
• twitter_module.py : permite a los usuarios interactuar con la API de Twitter para publicar tweets que contienen resultados de análisis o texto personalizado.
• urlscan_module.py : interactúa con la API de URLScan.io para enviar URL para escanear y recuperar los resultados del escaneo.
• virustotal_module.py : interactúa con la API virustotal para escanear URL y recuperar los resultados del análisis.
• whois_module.py : obtiene información para un dominio determinado.
• configs/ : Directorio que contiene archivos de configuración con claves API para Virustotal, URLScan.io y Twitter.
• outputs/ : directorio donde los resultados del análisis se guardan como archivos de texto numerados.

Únete a mi servidor de discordias

Uso

1. Clone el repositorio o descargue el código fuente.
2. Instale los paquetes de Python requeridos ejecutando pip install -r requirements.txt .
3. Obtenga claves API para Virustotal, URLScan.io y Twitter, y cree archivos de configuración en el directorio configs con las claves API respectivas.
4. Ejecute el script controller.py .
5. Siga las indicaciones para ingresar una URL para escanear, tuitear los resultados o escanear otra URL.

Archivos de configuración

La herramienta requiere claves API para Virustotal, URLScan.io y Twitter. Estas claves deben almacenarse en archivos JSON separados en el directorio configs con la siguiente estructura:

• 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 "
  }

Archivos de salida

Los resultados del análisis se guardan como archivos de texto numerados en el directorio outputs . Cada archivo contiene la siguiente información:

• URL escaneada
• Dominio
• Registrador
• Fechas de creación y vencimiento
• Tipos de amenazas
• Direcciones IP y países asociados con la URL
• Fecha de escanear
• URL de captura de pantalla
• URLS de Report Virustotal y URLScan.io

Dependencias

Este proyecto requiere las siguientes bibliotecas de Python:

• requests
• tweepy
• python-whois

Instale estas dependencias ejecutando pip install -r requirements.txt antes de ejecutar la aplicación.

Que contribuye

¡Las contribuciones a este proyecto son bienvenidas! Si encuentra algún problema o tiene sugerencias de mejoras, abra un problema o envíe una solicitud de extracción. Siga el flujo de trabajo estándar de GitHub para obtener contribuciones.

Licencia

Este proyecto tiene licencia bajo la licencia MIT. Consulte el archivo de licencia para obtener más detalles.