recon.py

"""
ReconPy - Herramienta de Reconocimiento OSINT Pasivo

Este script realiza reconocimiento pasivo sobre un dominio, recopilando
información pública disponible, como:

- Dirección IP
- Registros DNS
- Encabezados HTTP
- Archivo robots.txt
- Certificado SSL
- Información WHOIS
- Datos RDAP

Uso:
    python recon.py <dominio o URL>

Ejemplo:
    python recon.py example.com
    python recon.py https://example.com

Nota:
    Esta herramienta es solo para fines educativos y debe utilizarse
    únicamente sobre objetivos autorizados.
"""

import sys
import time
from pyfiglet import figlet_format
from colorama import Fore, Style, init
from urllib.parse import urlparse

# Importación de módulos personalizados
from modules.dns_info import get_ip, get_dns_records
from modules.http_info import get_http_headers, get_robots_txt
from modules.ssl_info import get_ssl_certificate_info
from modules.rdap_info import get_whois_info, get_rdap_info
from modules.utils import print_section, pretty_print

# Inicializa colorama para permitir colores en la terminal
init(autoreset=True)


def show_banner():
    """
    Muestra el banner de la herramienta en la consola.

    Incluye:
    - Nombre de la herramienta
    - Versión
    - Autor
    - Descripción

    Se utilizan pequeños delays para mejorar la experiencia visual.
    """
    banner = figlet_format("ReconPy", font="colossal")

    print(Fore.LIGHTWHITE_EX + "\n### ReconPy v1.0.0 ###\n")
    print(Fore.RED + banner)
    time.sleep(0.9)

    print(Fore.GREEN + "[+] Developed by Matias")
    time.sleep(0.9)

    print(Fore.YELLOW + "[+] Passive OSINT Recon Tool\n")
    time.sleep(0.9)

    print(Style.RESET_ALL)


def normalize_target(target: str) -> str:
    """
    Normaliza la entrada del usuario (dominio o URL) y extrae el hostname.

    Permite entradas como:
        - example.com
        - www.example.com
        - https://example.com
        - https://example.com/blog
        - http://example.com:8080/test

    Retorna:
        str: dominio limpio (hostname) o cadena vacía si no es válido.
    """
    target = target.strip()

    if not target:
        return ""

    # Si no incluye esquema (http/https), se agrega temporalmente
    # para que urlparse pueda procesarlo correctamente
    if not target.startswith(("http://", "https://")):
        target = "https://" + target

    parsed = urlparse(target)

    # hostname elimina automáticamente el puerto si existe
    hostname = parsed.hostname

    if not hostname:
        return ""

    return hostname


def main():
    """
    Función principal del programa.

    Responsabilidades:
    - Mostrar el banner
    - Validar los argumentos de entrada
    - Normalizar el dominio o URL ingresado
    - Ejecutar los módulos OSINT
    - Mostrar los resultados en consola de forma estructurada

    Argumentos esperados:
        sys.argv[1]: dominio o URL a analizar
    """
    show_banner()

    # Validación de argumentos
    if len(sys.argv) != 2:
        print("Uso: python recon.py <dominio o URL>")
        sys.exit(1)

    # Normaliza la entrada del usuario
    domain = normalize_target(sys.argv[1])

    if not domain:
        print("Error: no se pudo extraer un dominio válido.")
        sys.exit(1)

    # Mensaje informativo
    print("Herramienta OSINT educativa")
    print("Uso exclusivo sobre información pública y objetivos autorizados.\n")

    # Obtención de IP
    print_section("IP")
    print(get_ip(domain))

    # Obtención de registros DNS
    print_section("DNS")
    pretty_print(get_dns_records(domain))

    # Obtención de encabezados HTTP
    print_section("HTTP Headers")
    pretty_print(get_http_headers(domain))

    # Obtención de robots.txt
    print_section("robots.txt")
    print(get_robots_txt(domain))

    # Obtención de certificado SSL
    print_section("SSL")
    pretty_print(get_ssl_certificate_info(domain))

    # Información WHOIS
    print_section("WHOIS")
    pretty_print(get_whois_info(domain))

    # Información RDAP
    print_section("RDAP")
    pretty_print(get_rdap_info(domain))


if __name__ == "__main__":
    main()