Skip to content

README_ES.md

Latest commit

 

History

History
167 lines (111 loc) · 3.77 KB

README_ES.md

File metadata and controls

167 lines (111 loc) · 3.77 KB

IPFinder 🌐

🇺🇸 English | 🇪🇸 Español

image-removebg-preview (41)

IPFinder es una herramienta CLI ligera y multiplataforma escrita en Python que permite obtener información detallada sobre cualquier dirección IPv4. Está diseñada para OSINT, redes, investigación en seguridad y reconocimiento general de IPs, con una salida limpia y una instalación sencilla.

✨ Características

  • 🌍 Datos de geolocalización (país, región, ciudad)
  • 🏢 Información de ISP y ASN
  • 🔁 DNS inverso (hostname)
  • 🔢 Conversión de IP a decimal
  • 🛰️ Latitud y longitud
  • 🎨 Salida con colores (opcional)
  • ⌛ Animación de carga
  • 💻 Funciona en Windows, Linux y macOS
  • 📦 Instalador simple que agrega el comando al PATH

📸 Ejemplo de salida

image

🚀 Instalación

Clona el repositorio:

git clone https://github.com/URDev4ever/IPFinder.git
cd IPFinder

Ejecuta el instalador:

python installer.py

El instalador hará lo siguiente:

  • Detectará tu sistema operativo
  • Instalará las dependencias necesarias
  • Creará un lanzador (ipfinder)
  • Lo agregará al PATH del sistema (si es posible)

Después de la instalación, podrás ejecutar IPFinder desde cualquier lugar.

🧪 Uso

Modo interactivo:

ipfinder

Analizar una IP específica:

ipfinder 8.8.8.8

Analizar tu propia IP pública:

ipfinder -i

Desactivar salida con colores:

ipfinder -n

Mostrar ayuda:

ipfinder -h

⚙️ Opciones de línea de comandos

Opción Descripción
IP Dirección IPv4 objetivo
-i Usar tu propia IP pública
-n Desactivar salida con colores
-h Mostrar menú de ayuda

🛠️ Cómo funciona

IPFinder obtiene información de IP utilizando servicios públicos de información IP y procesa los datos para mostrar:

  • Propiedad de red (ASN / ISP)
  • Hostname mediante DNS inverso
  • Ubicación geográfica
  • Representación decimal de la IP

No se realiza ningún escaneo intrusivo. Esta es una herramienta pasiva de recolección de información.

⚠️ Detección de VPN / Proxy

La detección confiable de VPNs o proxies no está garantizada sin el uso de APIs especializadas de pago.

Actualmente, IPFinder se enfoca en:

  • Transparencia
  • Precisión de los datos IP en bruto
  • Salida amigable para OSINT

Versiones futuras podrían incluir detección heurística o basada en reputación.

📦 Requisitos

  • Python 3.8 o superior
  • Conexión a Internet

Todas las dependencias necesarias de Python se instalan automáticamente mediante el instalador.

🧠 Casos de uso

  • Investigaciones OSINT
  • Diagnóstico de redes
  • Investigación en seguridad
  • Fines educativos
  • Consultas rápidas de IP desde la terminal

⭐ Contribuir

Las pull requests son bienvenidas si:

  • Mejoran la precisión de los datos de IP, la confiabilidad del procesamiento o la claridad del output sin agregar funciones intrusivas
  • Mejoran la compatibilidad multiplataforma, la estabilidad del instalador o la usabilidad de la CLI
  • Mantienen la filosofía pasiva y orientada a OSINT de la herramienta (sin escaneo, sin sondeo de puertos, sin enumeración activa)

⭐ Si este proyecto te resulta útil, ¡considera darle una estrella en GitHub!

Hecho con <3 por URDev.