007-TheBond 🕵️‍♂️

🔍 Características

�️ Instalación y Uso

🐳 Método 1: Docker (Recomendado)

¿Por qué Docker? Docker garantiza un rendimiento consistente en todas las plataformas y elimina problemas de dependencias.

# Descargar la imagen más reciente
docker pull deadshot0x7/007-thebond:latest

# Ejecutar la herramienta de forma interactiva
docker run -it deadshot0x7/007-thebond:latest

# Ejecutar montando un volumen para guardar resultados
docker run -it -v $(pwd)/results:/app/results deadshot0x7/007-thebond:latest

Docker Compose (Opcional):

version: '3.8'
services:
  osint-tool:
    image: deadshot0x7/007-thebond:latest
    stdin_open: true
    tty: true
    volumes:
      - ./results:/app/results
      - ./config:/app/config

🛠️ Método 2: Instalación Local

Scripts de configuración rápida:

Para Linux/macOS:

git clone https://github.com/Deadshot0x7/007-TheBond.git
cd 007-TheBond
bash run_007-TheBond.sh

Para Windows:

git clone https://github.com/Deadshot0x7/007-TheBond.git
cd 007-TheBond
run_007-TheBond.bat

🔧 Método 3: Instalación Manual

# 1. Clonar el repositorio
git clone https://github.com/Deadshot0x7/007-TheBond.git
cd 007-TheBond

# 2. Crear y activar el entorno virtual
# Linux/macOS:
python3 -m venv venv
source venv/bin/activate

# Windows:
python -m venv venv
venv\Scripts\activate

# 3. Instalar dependencias
pip install -r requirements.txt
# O usando uv (más rápido)
uv pip install -r requirements.txt

# 4. Ejecutar el script
cd scripts
python 007-TheBond.py

🖥️ Compatibilidad de Plataformas

✅ Completamente probado y funcional

⚠️ Soporte Limitado

🚫 Distribuciones/Plataformas no funcionales

❌ Estas plataformas tienen problemas críticos conocidos:

📋 Requisitos Previos

Para Instalación Nativa:

• Python: 3.10 o superior
• Git: Última versión
• Conexión a Internet: Necesaria para operaciones OSINT
• pip/uv: Gestor de paquetes

Para Instalación con Docker:

• Docker: 20.10+
• Docker Compose: 2.0+ (opcional)
• 4 GB de RAM: Mínimo recomendado
• Conexión a Internet: Necesaria

🛡️ Uso Ético y Aviso Legal

⚠️ CRÍTICO: Esta herramienta está diseñada únicamente para investigación de seguridad legítima y fines educativos.

✅ Usos Autorizados:

• Fines educativos y de aprendizaje
• Pruebas de penetración autorizadas
• Investigación de seguridad con los permisos adecuados
• Investigaciones OSINT dentro de los límites legales
• Capacitación en concienciación de ciberseguridad

❌ Usos Prohibidos:

• Acoso, acecho o intimidación
• Vigilancia no autorizada
• Violaciones de privacidad
• Recopilación ilegal de datos
• Espionaje corporativo
• Cualquier actividad que infrinja las leyes locales/internacionales

📋 Requisitos Legales:

• Obtenga siempre permiso explícito antes de investigar a personas
• Respete las leyes de privacidad en su jurisdicción (GDPR, CCPA, etc.)
• Úsela responsablemente y dentro del marco legal
• Documente su autorización para evaluaciones de seguridad

Descargo de responsabilidad: El desarrollador (@Deadshot0x7) no asume ninguna responsabilidad por el mal uso de esta herramienta. Los usuarios son los únicos responsables de garantizar el cumplimiento legal y ético.

🔧 Configuración

Variables de Entorno:

# Configuraciones opcionales
export OSINT_OUTPUT_DIR="/ruta/a/resultados"
export OSINT_CONFIG_FILE="/ruta/a/config.json"
export PYTHONPATH="${PYTHONPATH}:/ruta/a/007-TheBond"

Claves API (Opcional):

Algunas funciones pueden requerir claves API. Cree un archivo .env:

HAVEIBEENPWNED_API_KEY=su_clave_api_aqui
SHODAN_API_KEY=su_clave_shodan

🐳 Ventajas de Docker

Por qué recomendamos Docker:

📊 Estadísticas de Uso

# Ejecutar con Docker
docker run -it deadshot0x7/007-thebond:latest

# Ejemplo de sesión:
┌─────────────────────────────────────────┐
│         007-TheBond v3.0                │
│     OSINT Intelligence Toolkit         │
└─────────────────────────────────────────┘

[1] Instagram OSINT
[2] Phone Number OSINT  
[3] Username Search
[4] Web Search
[5] IP Lookup
[6] Email Lookup
[0] Exit

Select option: _

🤝 Contribuir

¡Damos la bienvenida a las contribuciones! Así es cómo:

🍴 Contribución Rápida:

# 1. Haga un fork del repositorio
# 2. Cree una rama de funcionalidad
git checkout -b feature/CaracteristicaIncreible

# 3. Realice cambios y haga commit
git commit -m 'Añadir alguna CaracteristicaIncreible'

# 4. Haga push y cree un PR
git push origin feature/CaracteristicaIncreible

📋 Directrices de Contribución:

• Siga los estándares PEP 8 de Python
• Añada docstrings para funciones nuevas
• Pruebe en múltiples plataformas
• Actualice el README para nuevas características
• Mantenga los estándares de uso ético

🔍 Solución de Problemas

Problemas Comunes:

Problema: "Módulo no encontrado"

# Solución: Use Docker
docker run -it deadshot0x7/007-thebond:latest

Problema: "Permiso denegado"

# Linux/macOS: Corrija permisos
chmod +x run_007-TheBond.sh
# O use Docker (recomendado)

Problema: "Versión de Python incompatible"

# Solución: Use Docker para tener Python 3.10 consistente
docker run -it deadshot0x7/007-thebond:latest

📞 Soporte y Comunidad

📜 Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulte el archivo LICENSE para más detalles.

🏆 Agradecimientos

• Comunidad de investigación de seguridad
• Contribuyentes de código abierto
• Hackers éticos de todo el mundo
• Todos los usuarios que proporcionan comentarios