feat: async concurrent API calls, connection pooling and caching, bump to v2.5.3

- Phone APIs (Abstract/NumVerify/IPQualityScore) and geocoders (OpenCage/Geoapify)
  now run concurrently via asyncio + aiohttp; Nominatim stays final fallback
- Connection pooling: aiohttp.ClientSession (async) + shared requests.Session (sync)
- lru_cache on city normalization and locality filters; Nominatim geocode cache
- Lazy output-dir creation; shallow copies in dummy mode; precompiled regexes
- New dependency: aiohttp>=3.9.0

Author: KiMiGuel

README.md

@@ -43,6 +43,7 @@ La herramienta puede validar números, analizar formatos mexicanos, consultar fu
 - Series no geográficas 200/300/500/800/900 con alerta de números premium (900)
 - Gestión de API keys desde la CLI (`--set-key`, `--list-keys`, `--config-path`)
 - Configuración local de API keys
+- **Rendimiento concurrente (v2.5.3)**: llamadas a APIs en paralelo (asyncio + aiohttp), pooling de conexiones HTTPS y memoización de normalización y geocodificación
 - Soporte para reportes o salidas generadas según la versión
 - Modo telefónico únicamente: sin proveedores IP ni escaneo IP
 
@@ -57,23 +58,32 @@ MeXiCOSINT/
 ├── docs/
 │   ├── INSTALL.md
 │   ├── USAGE.md
-│   └── CONFIG.md
+│   ├── CONFIG.md
+│   ├── ENGLISH.md
+│   └── index.html
 ├── src/
 │   └── mexicosint/
 │       ├── __init__.py
 │       ├── __main__.py
 │       ├── cli.py
+│       ├── config.py
+│       ├── evidence.py
 │       ├── main.py
+│       ├── numbering.py
 │       ├── data/
 │       ├── modules/
 │       │   ├── ift_blocks.py
 │       │   ├── ift_sns.py
 │       │   ├── local_parser.py
 │       │   └── quienhabla.py
+│       ├── providers/
+│       │   ├── geoapify.py
+│       │   ├── ipqualityscore.py
+│       │   ├── models.py
+│       │   └── opencage.py
 │       ├── services/
 │       │   └── scanner.py
 │       └── utils/
-│           └── validation.py
 ├── tools/
 │   └── update_ift_blocks.py
 ├── pyproject.toml

docs/USAGE.md

@@ -217,7 +217,20 @@ La localidad mexicana se resuelve en este orden:
 
 AbstractAPI, NumVerify e IPQualityScore pueden aportar evidencia o conflicto, pero no reemplazan una localidad concreta de IFT/LADA. Valores vagos como `Mexico`, `NorthWest`, regiones genéricas, tipo de línea o país sin ciudad no se envían a geocodificadores.
 
-OpenCage se usa como geocodificador primario si tiene key. Geoapify se usa como fallback con key. Nominatim queda como fallback final sin key.
+OpenCage y Geoapify se consultan **en paralelo** (con key); OpenCage sigue siendo el resultado primario. Nominatim queda como fallback final sin key.
+
+---
+
+## Rendimiento (v2.5.3)
+
+Desde la versión 2.5.3 las llamadas de red son concurrentes:
+
+* Las APIs telefónicas (AbstractAPI, NumVerify, IPQualityScore) se consultan **en paralelo** con asyncio + aiohttp.
+* OpenCage y Geoapify geocodifican en paralelo; Nominatim sigue como respaldo final.
+* Las conexiones HTTPS se reutilizan (pooling de sesiones).
+* La normalización de localidades y la geocodificación Nominatim usan caché (menos trabajo repetido entre escaneos).
+
+No requiere configuración adicional: instala o actualiza normalmente (`pipx upgrade mexicosint`).
 
 ---
 

docs/index.html

@@ -133,7 +133,7 @@
 
 <nav>
   <div class="wrap">
-    <div class="logo">MeXi<span>COSINT</span><span class="badge-ver">v2.5.2</span></div>
+    <div class="logo">MeXi<span>COSINT</span><span class="badge-ver">v2.5.3</span></div>
     <div class="links">
       <a href="#que-hace">Qué hace</a>
       <a href="#ift">Base IFT</a>
@@ -213,6 +213,11 @@ <h3>Enlaces de investigación</h3>
         <h3>Reportes exportables</h3>
         <p>Reporte JSON con hash SHA-256 y mapa HTML de la localidad canónica IFT/LADA. Listo para documentar investigaciones.</p>
       </div>
+      <div class="card">
+        <div class="ico">⚡</div>
+        <h3>Rápida y concurrente</h3>
+        <p>Desde v2.5.3: llamadas a APIs en paralelo con asyncio + aiohttp, reutilización de conexiones HTTPS y caché de geocodificación. Escaneos mucho más rápidos con varias llaves activas.</p>
+      </div>
     </div>
   </div>
 </section>

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mexicosint"
-version = "2.5.2"
+version = "2.5.3"
 description = "OSINT CLI for Mexican phone-number validation, IFT/PNN lookup, enrichment, and reports."
 readme = "README.md"
 requires-python = ">=3.8"
@@ -41,6 +41,7 @@ classifiers = [
 ]
 dependencies = [
     "requests>=2.28.0",
+    "aiohttp>=3.9.0",
     "urllib3<2",
     "beautifulsoup4>=4.11.0",
     "python-dotenv>=0.19.0",

requirements.txt

@@ -1,4 +1,5 @@
 requests>=2.28.0
+aiohttp>=3.9.0
 urllib3<2
 beautifulsoup4>=4.11.0
 python-dotenv>=0.19.0

src/mexicosint/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "2.5.2"
+__version__ = "2.5.3"

src/mexicosint/evidence.py

@@ -5,6 +5,7 @@
 import re
 import unicodedata
 from dataclasses import dataclass, field
+from functools import lru_cache
 
 
 @dataclass
@@ -48,6 +49,7 @@ class EvidenceDecision:
 }
 
 
+@lru_cache(maxsize=1024)
 def normalize_city(city: str) -> str:
     if not city:
         return ""