Geogramint es una herramienta de OSINT que utiliza la API de Telegram para encontrar usuarios y grupos cercanos. Inspirado en el Mapa Cercano (Nearby Map) de Telegram de Tejado, que ya no se mantiene, tiene como objetivo proporcionar una alternativa más fácil de usar.
Geogramint solo encuentra usuarios y grupos de Telegram que han activado la función de cercanía. Por defecto, esta función está desactivada.
La herramienta es totalmente compatible con Windows y parcialmente compatible con Mac OS y distribuciones de Linux.

Instalación
Requisitos: Python 3.8 o 3.9
En Windows:
Con el instalador: ¡Haz clic aquí!
Con Github:
git clone https://github.com/Alb-310/Geogramint.git
cd Geogramint/
pip3 install -r requirements.txt
python3 geogramint.py # para modo GUI
python3 geogramint.py --help # para modo CLI
O, dependiendo de tu instalación:
git clone https://github.com/Alb-310/Geogramint.git
cd Geogramint/
pip install -r requirements.txt
python geogramint.py # para modo GUI
python geogramint.py --help # para modo CLI
En Mac OS y Linux:
Con Github:
git clone https://github.com/Alb-310/Geogramint.git
cd Geogramint/
pip3 install -r requirements.txt
python3 geogramint.py # para modo GUI
python3 geogramint.py --help # para modo CLI
O, dependiendo de tu instalación:
git clone https://github.com/Alb-310/Geogramint.git
cd Geogramint/
pip install -r requirements.txt
python geogramint.py # para modo GUI
python geogramint.py --help # para modo CLI
Más detalles en la Wiki.
Ejemplo: GUI
Comienza creando una clave API para tu cuenta de Telegram aquí. También necesitarás poner una foto de perfil en tu cuenta y, en tu configuración de Privacidad y Seguridad, activar la foto de perfil para todos.

Inicia Geogramint.
En la configuración, escribe tu información (api_id, api_hash y número de teléfono), preferencias de informe y luego guarda.


Elige la ubicación donde deseas buscar, ya sea moviéndote en el mapa o utilizando la función de búsqueda con coordenadas en formato lat
, lon
.

Telegram te enviará un código de verificación, escríbelo en la ventana emergente (+ tu contraseña de verificación en dos pasos si la tienes).

Luego haz clic en “Start Search“.
Todos los resultados se mostrarán de la siguiente manera:
- Verde para 500 m.
- Amarillo para 1000 m.
- Naranja para 2000 m.
- Rojo para >3000 m. (Nota: los resultados también se pueden encontrar en
Geogramint/cache_telegram/
en formatojson
ycsv
+ fotos de perfil).

El botón Reset eliminará los resultados y borrará el caché_telegram
. Más detalles en el Wiki.
Ejemplo: CLI
Comienza creando una clave API para tu cuenta de Telegram aquí. También necesitarás poner una foto de perfil en tu cuenta y, en tu configuración de Privacidad y Seguridad, activar la foto de perfil para todos.

Inicia Geogramint.

Inicia la configuración con el comando set-config
y escribe tu información (api_id, api_hash y número de teléfono).

Inicia la función de búsqueda utilizando coordenadas en formato lat
lon
con el comando start-scan
.



Todos los resultados se mostrarán de la siguiente manera:
- Verde para 500 m.
- Amarillo para 1000 m.
- Naranja para 2000 m.
- Rojo para >3000 m.
(Nota: los resultados se pueden exportar según las opciones utilizadas con start-scan
, por defecto, las fotos de perfil y los resultados en formato json están presentes en Geogramint/cache_telegram/
).
El comando reset-scan
limpiará el caché_telegram
. Más detalles en Wiki.