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
├── docs/
│   ├── INSTALL.md
│   ├── USAGE.md
│   └── CONFIG.md
├── src/
│   └── mexicosint/
│       ├── __init__.py
│       ├── __main__.py
│       ├── cli.py
│       ├── main.py
│       ├── data/
│       ├── modules/
│       │   ├── ift_sns.py
│       │   ├── local_parser.py
│       │   └── quienhabla.py
│       ├── services/
│       │   ├── ip_geo.py
│       │   └── scanner.py
│       └── utils/
│           └── validation.py
├── pyproject.toml
├── requirements.txt
├── .gitignore
├── LICENSE
└── README.md

---

Instalación

pip:

pip install mexicosint

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

Instala el paquete en modo editable:

pip install -e .

---

Uso

Ejecuta MeXiCOSINT usando el launcher:

mexicosint 5512345678
mexicosint -b 5512345678

Tambien puedes usar el launcher del repositorio sin instalar el comando global:

bash bin/mexicosint 5512345678

O ejecutar el modulo del paquete:

PYTHONPATH=src python3 -m mexicosint 5512345678

Use -b, --compact-banner, or the legacy --small-banner flag to force the compact ASCII banner.

---

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:

• 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.