QUICK_START.md

Guía de Inicio Rápido ⚡

En 5 Minutos

Paso 1: Instalar Dependencias

pip install -r requirements.txt

Paso 2: Preparar IPs

Edita data/input/ips.txt y agrega tus IPs:

8.8.8.8
1.1.1.1
208.67.222.222

Paso 3: Ejecutar

python src/main.py

Paso 4: Ver Resultados

• Datos brutos: output/raw/ip_data.csv
• Estadísticas: output/reports/statistics.json

---

Scripts de Un Clic

Windows

run.bat

Linux/Mac

chmod +x run.sh
./run.sh

---

Comandos Útiles

Acción	Comando
Ejecutar	python src/main.py
Reiniciar	python src/main.py --reset
Solo reportes	python src/main.py --report-only
Config custom	python src/main.py --config mi_config.yaml

---

Configuración Rápida

Edita config/config.yaml:

processing:
  max_workers: 5    # Más = más rápido, menos = más estable

rate_limiting:
  delay_between_requests: 1.5  # Más = más lento pero seguro

---

Estructura de Archivos

📁 ip_whois_crawler/
├── 📁 data/input/          ← TUS IPs AQUÍ
├── 📁 output/
│   ├── raw/                ← Datos CSV
│   └── reports/            ← Estadísticas JSON
├── 📁 config/              ← Configuración
└── 📁 src/                 ← Código fuente

---

Solución Rápida de Problemas

Error: "ipwhois no encontrado"

pip install ipwhois

Resultados vacíos

Revisa que data/input/ips.txt tenga IPs válidas.

Bloqueos frecuentes

En config/config.yaml:

• Reduce max_workers a 3
• Aumenta delay_between_requests a 2.5

---

Siguiente Paso

Lee USAGE_EXAMPLES.md para casos de uso avanzados.

---

¡Listo para analizar miles de IPs! 🚀