mexicosint 2.2.5__tar.gz

mexicosint-2.2.5/LICENSE

@@ -0,0 +1 @@
+MIT License

mexicosint-2.2.5/PKG-INFO

@@ -0,0 +1,243 @@
+Metadata-Version: 2.4
+Name: mexicosint
+Version: 2.2.5
+Summary: OSINT para numeros telefonicos Mexicanos
+Author: KiMiGuEL
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: urllib3<2
+Requires-Dist: beautifulsoup4>=4.11.0
+Requires-Dist: python-dotenv>=0.19.0
+Requires-Dist: lxml>=4.9.0
+Requires-Dist: phonenumbers>=8.13.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: opencage>=3.0.0
+Requires-Dist: folium>=0.14.0
+Dynamic: license-file
+
+<p align="center">
+  <img src="mexsint.png" alt="MeXiCOSINT Banner" width="850">
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Python-3.8+-blue.svg" alt="Python">
+  <img src="https://img.shields.io/badge/Licencia-MIT-green.svg" alt="Licencia">
+  <img src="https://img.shields.io/badge/OSINT-México-red.svg" alt="OSINT México">
+  <img src="https://img.shields.io/badge/Estado-Beta-orange.svg" alt="Estado Beta">
+</p>
+
+<h1 align="center">MeXiCOSINT</h1>
+
+<p align="center">
+  Herramienta OSINT enfocada en análisis, validación, enriquecimiento y reportes de números telefónicos mexicanos.
+</p>
+
+---
+
+## 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
+
+```text
+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
+
+Clona el repositorio:
+
+```bash
+git clone https://github.com/KiMiGuel/MeXiCOSINT.git
+```
+
+Entra a la carpeta del proyecto:
+
+```bash
+cd MeXiCOSINT
+```
+
+Crea un entorno virtual:
+
+```bash
+python3 -m venv venv
+```
+
+Activa el entorno virtual:
+
+```bash
+source venv/bin/activate
+```
+
+Instala las dependencias:
+
+```bash
+pip install -r requirements.txt
+```
+
+Instala el paquete en modo editable:
+
+```bash
+pip install -e .
+```
+
+---
+
+## Uso
+
+Ejecuta MeXiCOSINT usando el launcher:
+
+```bash
+mexicosint 5512345678
+mexicosint -b 5512345678
+```
+
+Tambien puedes usar el launcher del repositorio sin instalar el comando global:
+
+```bash
+bash bin/mexicosint 5512345678
+```
+
+O ejecutar el modulo del paquete:
+
+```bash
+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](docs/INSTALL.md) | Instrucciones de instalación para Kali, Debian, Ubuntu y sistemas similares |
+| [Guía de uso](docs/USAGE.md) | Uso básico y notas de ejecución |
+| [Guía de configuración](docs/CONFIG.md) | 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:
+
+```text
+.env
+*.env
+config.json
+secrets.json
+keys.json
+.mx_osint_config.json
+```
+
+Ruta local recomendada para configuración:
+
+```text
+~/.mx_osint_config.json
+```
+
+Permisos recomendados:
+
+```bash
+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.

mexicosint-2.2.5/README.md

@@ -0,0 +1,223 @@
+<p align="center">
+  <img src="mexsint.png" alt="MeXiCOSINT Banner" width="850">
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Python-3.8+-blue.svg" alt="Python">
+  <img src="https://img.shields.io/badge/Licencia-MIT-green.svg" alt="Licencia">
+  <img src="https://img.shields.io/badge/OSINT-México-red.svg" alt="OSINT México">
+  <img src="https://img.shields.io/badge/Estado-Beta-orange.svg" alt="Estado Beta">
+</p>
+
+<h1 align="center">MeXiCOSINT</h1>
+
+<p align="center">
+  Herramienta OSINT enfocada en análisis, validación, enriquecimiento y reportes de números telefónicos mexicanos.
+</p>
+
+---
+
+## 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
+
+```text
+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
+
+Clona el repositorio:
+
+```bash
+git clone https://github.com/KiMiGuel/MeXiCOSINT.git
+```
+
+Entra a la carpeta del proyecto:
+
+```bash
+cd MeXiCOSINT
+```
+
+Crea un entorno virtual:
+
+```bash
+python3 -m venv venv
+```
+
+Activa el entorno virtual:
+
+```bash
+source venv/bin/activate
+```
+
+Instala las dependencias:
+
+```bash
+pip install -r requirements.txt
+```
+
+Instala el paquete en modo editable:
+
+```bash
+pip install -e .
+```
+
+---
+
+## Uso
+
+Ejecuta MeXiCOSINT usando el launcher:
+
+```bash
+mexicosint 5512345678
+mexicosint -b 5512345678
+```
+
+Tambien puedes usar el launcher del repositorio sin instalar el comando global:
+
+```bash
+bash bin/mexicosint 5512345678
+```
+
+O ejecutar el modulo del paquete:
+
+```bash
+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](docs/INSTALL.md) | Instrucciones de instalación para Kali, Debian, Ubuntu y sistemas similares |
+| [Guía de uso](docs/USAGE.md) | Uso básico y notas de ejecución |
+| [Guía de configuración](docs/CONFIG.md) | 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:
+
+```text
+.env
+*.env
+config.json
+secrets.json
+keys.json
+.mx_osint_config.json
+```
+
+Ruta local recomendada para configuración:
+
+```text
+~/.mx_osint_config.json
+```
+
+Permisos recomendados:
+
+```bash
+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.

mexicosint-2.2.5/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mexicosint"
+version = "2.2.5"
+description = "OSINT para numeros telefonicos Mexicanos"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "KiMiGuEL" }]
+dependencies = [
+    "requests>=2.28.0",
+    "urllib3<2",
+    "beautifulsoup4>=4.11.0",
+    "python-dotenv>=0.19.0",
+    "lxml>=4.9.0",
+    "phonenumbers>=8.13.0",
+    "rich>=13.0.0",
+    "opencage>=3.0.0",
+    "folium>=0.14.0",
+]
+
+[project.scripts]
+mexicosint = "mexicosint.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+mexicosint = ["data/*"]

mexicosint-2.2.5/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mexicosint-2.2.5/src/mexicosint/__init__.py

@@ -0,0 +1,5 @@
+"""MeXiCOSINT package."""
+
+__all__ = ["__version__"]
+
+__version__ = "2.2.5"

mexicosint-2.2.5/src/mexicosint/__main__.py

@@ -0,0 +1,7 @@
+"""Module entry point for `python -m mexicosint`."""
+
+from mexicosint.cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

mexicosint-2.2.5/src/mexicosint/cli.py

@@ -0,0 +1,72 @@
+"""Command-line interface for MeXiCOSINT."""
+
+from __future__ import annotations
+
+import argparse
+
+from mexicosint import __version__
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="mexicosint",
+        description="OSINT para numeros telefonicos Mexicanos.",
+    )
+    parser.add_argument(
+        "number",
+        nargs="?",
+        help="Numero telefonico mexicano a escanear.",
+    )
+    parser.add_argument(
+        "--ip",
+        dest="ip",
+        metavar="ADDRESS",
+        help="Geolocaliza directamente una direccion IP.",
+    )
+    parser.add_argument(
+        "--dummy-test",
+        action="store_true",
+        help="Usa datos de prueba y evita llamadas reales a APIs.",
+    )
+    parser.add_argument(
+        "-b",
+        "--compact-banner",
+        "--small-banner",
+        dest="small_banner",
+        action="store_true",
+        help="Fuerza el banner compacto; alias: --small-banner.",
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"%(prog)s {__version__}",
+    )
+    return parser
+
+
+def _to_legacy_argv(args: argparse.Namespace) -> list[str]:
+    """Translate argparse output to the existing scanner argument format."""
+    argv: list[str] = []
+    if args.dummy_test:
+        argv.append("--dummy-test")
+    if args.small_banner:
+        argv.append("--small-banner")
+    if args.ip:
+        argv.extend(["--ip", args.ip])
+    elif args.number:
+        argv.append(args.number)
+    return argv
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    if not args.ip and not args.number:
+        parser.print_help()
+        return 1
+
+    from mexicosint import main as app
+
+    app.main(_to_legacy_argv(args))
+    return 0