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.
https://github.com/tejado/telegram-nearby-map
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: https://github.com/Alb-310/Geogramint/releases
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.
https://github.com/Alb-310/Geogramint/wiki/Installation-Guide
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.
https://github.com/Alb-310/Geogramint