MeXiCOSINT

Herramienta OSINT enfocada en análisis, validación, enriquecimiento y reportes de números telefónicos mexicanos.

---

Descripción

MeXiCOSINT es una herramienta de OSINT desarrollada en Python y enfocada en números telefónicos mexicanos.

La herramienta puede validar números, analizar formatos mexicanos, consultar fuentes opcionales mediante API, procesar metadatos disponibles y generar resultados útiles para investigación autorizada.

Este proyecto está en fase beta. Los resultados deben tratarse como indicadores OSINT, no como evidencia absoluta.

---

Características

• Validación de números telefónicos mexicanos
• Formato nacional e internacional
• Análisis local de números mexicanos
• Enriquecimiento opcional mediante APIs externas
• Procesamiento relacionado con IFT/SNS
• Soporte para módulo QuienHabla.mx
• Launcher para ejecutar la herramienta sin escribir el nombre completo del script
• Configuración local de API keys
• Soporte para reportes o salidas generadas según la versión

---

Estructura del repositorio

MeXiCOSINT/
├── bin/
│   └── mexicosint
├── data/
├── docs/
│   ├── INSTALL.md
│   ├── USAGE.md
│   └── CONFIG.md
├── modules/
│   ├── ift_sns.py
│   ├── local_parser.py
│   └── quienhabla.py
├── mexicosint_v2.2.5.py
├── requirements.txt
├── .gitignore
├── LICENSE
└── README.md

---

Instalación

Clona el repositorio:

git clone https://github.com/KiMiGuel/MeXiCOSINT.git

Entra a la carpeta del proyecto:

cd MeXiCOSINT

Crea un entorno virtual:

python3 -m venv venv

Activa el entorno virtual:

source venv/bin/activate

Instala las dependencias:

pip install -r requirements.txt

---

Uso

Ejecuta MeXiCOSINT usando el launcher:

bash bin/mexicosint

Esto evita tener que escribir manualmente el nombre completo del archivo principal de Python.

También puedes ejecutar el script principal directamente:

python3 mexicosint_v2.2.5.py

---

Documentación

Guía	Descripción
Guía de instalación	Instrucciones de instalación para Kali, Debian, Ubuntu y sistemas similares
Guía de uso	Uso básico y notas de ejecución
Guía de configuración	Configuración local y manejo de API keys

---

APIs opcionales

Algunas funciones pueden depender de API keys externas.

Servicio	Función
AbstractAPI	Validación y enriquecimiento de números telefónicos
NumVerify	Validación secundaria de números
Shodan	Enriquecimiento opcional relacionado con servicios expuestos
IPInfo	Enriquecimiento de metadatos IP
IP2Location	Enriquecimiento de metadatos IP
OpenCage	Geocodificación y soporte para mapas

Las API keys deben mantenerse en tu entorno local. No las subas a GitHub.

---

Seguridad

No subas archivos como:

.env
*.env
config.json
secrets.json
keys.json
.mx_osint_config.json

Ruta local recomendada para configuración:

~/.mx_osint_config.json

Permisos recomendados:

chmod 600 ~/.mx_osint_config.json

---

Advertencia

MeXiCOSINT está diseñado para investigación autorizada, autoauditoría y flujos educativos de OSINT.

No uses esta herramienta para acoso, doxxing, fraude, amenazas o actividades no autorizadas.

La herramienta no garantiza identidad, ubicación exacta, propiedad ni atribución definitiva de un número telefónico.

---

Estado del proyecto

Este proyecto está en desarrollo activo.

Funciones planeadas:

• Empaquetado instalable
• Comando global mexicosint
• Publicación de releases en GitHub
• Paquete .deb para instalación local con apt
• Mejoras en documentación
• Más pruebas y validaciones internas

---

Licencia

Este proyecto se publica bajo la licencia incluida en este repositorio.