
Osintgram es una herramienta OSINT en Instagram. Ofrece un shell interactivo para realizar análisis en la cuenta de Instagram de cualquier usuario por su apodo.
# Osintgram 🔎📸
[](doc/CHANGELOG.md)
[](LICENSE)
[](https://www.python.org/)
[](.github/workflows/tests.yml)
[](#quick-start)
**Apúntalo a una cuenta de Instagram y descubre quién está detrás de ella.** Osintgram
recopila, cruza y presenta todo lo que un perfil público revela
—seguidores, pies de foto, hashtags, ubicaciones geolocalizadas, hábitos de publicación, datos de contacto
públicos— en una interfaz web que ejecutas en tu propia máquina.
Pregunta en lenguaje natural y un **modelo de IA local** determina qué búsquedas
ejecutar. O no lo hagas: elige los comandos tú mismo y prescinde del modelo por completo.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/143/d6eaa19d795a604cab713f300cd9b5db4dce554bc604e3436a88d3d63e6f132b/6e4b370c0dd97191375d1281f84ddf2bc1653a0379d942b46787fd1ebe124ba0-display-v1.webp" width="900" alt="La interfaz web de Osintgram: el formulario de solicitud con una hoja de ejecución que muestra límites y coste, la respuesta escrita y resultados numerados con detalles del perfil y hashtags">
</p>
---
## Por qué podría gustarte
**Responde preguntas, no solo comandos.** *"¿Cuántos seguidores tienen y qué
hashtags usan más?"* ejecuta tres búsquedas y devuelve una respuesta escrita —
y los resultados en bruto debajo, para que puedas comprobar el trabajo en lugar de confiar
en la prosa.
**Nada sale de tu máquina excepto las propias búsquedas.** La IA se ejecuta
localmente a través de [Ollama](https://ollama.com): sin clave de OpenAI, sin suscripción, sin
que ninguno de tus prompts se envíe a nadie. La interfaz se sirve desde `127.0.0.1`.
**Te dice cuánto costará una búsqueda antes de ejecutarla.** Los datos de Instagram
no son gratuitos, y la mayoría de las herramientas te dejan descubrirlo de la forma cara. Esta calcula el precio
de tu selección por adelantado, muestra tu crédito restante, almacena en caché cada solicitud para que
nunca pagues dos veces por la misma búsqueda, y te permite limitar o detener una ejecución —
del lado del servidor, no solo en el navegador.
**Te muestra lo que encontró, como es debido.** Miniaturas de publicaciones en una cuadrícula filtrable,
ubicaciones geolocalizadas en un mapa, un mapa de calor de día de la semana × hora de cuándo publica alguien,
comparación entre dos cuentas. No un muro de JSON — aunque el JSON está a un
clic de distancia en cada tarjeta.
**Puedes entregar el resultado a otra persona.** Un botón convierte una búsqueda finalizada
en un informe HTML independiente que se abre en cualquier navegador, sin servidor y sin
Osintgram.
---
## Dos formas de manejarlo
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/143/423f425ac28ff28e4a24bbfa2e327d0d6a7120758dcc141a88a05ee4dc244424/6c18229ce4134dc3117d01b134aab494b5c4e8f6e36d817b4cacd9abababebfc-display-v1.webp" width="860" alt="Modo base: 28 comandos en dos columnas, agrupados por color y plegables, con un cuadro de búsqueda y la hoja de ejecución">
</p>
**Modo IA** — describe lo que quieres. Un modelo local elige los comandos, los ejecuta
y resume. Solo puede elegir de la misma lista de abajo; no puede
inventar búsquedas ni fabricar datos.
**Modo base** — sin modelo, sin necesidad de Ollama. Los 29 comandos, uno por línea,
agrupados y con búsqueda. Marca lo que quieras, establece los parámetros, ejecútalos en
orden.
También puedes dejar el nombre de usuario vacío en el modo IA y simplemente preguntar sobre un hashtag
o un lugar — esas búsquedas no pertenecen a ninguna cuenta.
---
## Qué puedes averiguar
| | |
|---|---|
| **Perfil** | Biografía y todos los enlaces que contiene, recuentos de seguidores/seguidos/publicaciones, categoría, correo electrónico público, teléfono y dirección comercial hasta las coordenadas, id de Facebook vinculado — además del propio *Acerca de esta cuenta* de Instagram: país de registro, fecha de creación, cuántas veces se cambió el nombre de usuario |
| **Red** | Seguidores y seguidos, cuentas que Instagram sugiere como relacionadas, quién los etiquetó, a quién etiquetaron, quién comenta más — y **conexiones mutuas** entre dos cuentas |
| **Contenido** | Hashtags clasificados por uso, pies de foto, cada comentario, estadísticas de me gusta y comentarios, desglose de fotos/vídeos/carruseles con visualizaciones y colaboraciones de pago, **mapa de calor de horarios de publicación**, ubicaciones geolocalizadas **en un mapa**, texto alternativo de las fotos |
| **Contactos** | Correos electrónicos públicos y números de teléfono entre los seguidores o seguidos de un objetivo |
| **Sin objetivo necesario** | Publicaciones publicadas con un **hashtag** (principales o recientes) o desde un **lugar**, y quién las publicó — además de cada **comentario en una publicación o reel concreto**, dada su URL, shortcode o id |
Las historias, destacados y fotos de perfil se devuelven como enlaces directos de CDN — y
cualquier tarjeta con contenido multimedia ofrece un zip de los originales con un solo clic.
---
## Inicio rápido
```bash
pip install -r requirements.txt
uvicorn src.web.app:app --host 127.0.0.1 --port 8000 --reload # or: make run
```
Abre **<http://127.0.0.1:8000>**.
Necesitas un backend de datos. La página se abre en un panel donde puedes pegar una
clave de [HikerAPI](https://hikerapi.com) directamente — se verifica antes de ser
aceptada, y puede guardarse para la próxima vez. (Un inicio de sesión gratuito de
[instagrapi](https://github.com/subzeroid/instagrapi) también funciona, usando una
cuenta de Instagram propia — consulta la guía para conocer las ventajas y desventajas.)
Para el modo IA, instala [Ollama](https://ollama.com/download) y descarga un
modelo con capacidad de llamada a herramientas:
```bash
ollama pull llama3.1:8b # ~4.7 GB, the default
```
El modo base funciona sin él.
¿Prefieres contenedores?
```bash
docker compose up --build # or: make docker
```
Misma dirección, mismo comportamiento — publicado solo en `127.0.0.1`. Tu clave, caché
y búsquedas guardadas permanecen en el host en `config/`, `cache/` y `dossier/`,
nunca dentro de la imagen. El modo IA se conecta a un Ollama que se ejecuta en tu host.
> $${\color{red}Advertencia:}$$ Esto se ejecuta en `127.0.0.1` **sin autenticación**. Está diseñado para ejecutarse en tu propia máquina — no lo expongas más allá de localhost sin colocar antes una capa de autenticación delante.
### 📖 [Lee la guía completa → `doc/web-ui.md`](https://github.com/datalux/osintgram/blob/master/doc/web-ui.md)
Configuración para ambos backends, cada comando con sus parámetros y coste, cómo
mantener bajo el gasto, exportar y compartir resultados, todas las opciones de configuración,
y resolución de problemas.
---
## Antes de usarlo
**SOLO CON FINES EDUCATIVOS.** Los contribuyentes no asumen ninguna
responsabilidad por el uso de esta herramienta.
- **No uses tu propia cuenta de Instagram ni tu cuenta principal** con ella.
- **Nunca hagas commit de `config/credentials.ini`** — las claves de API y las credenciales de Instagram
residen ahí. Está ignorado por git; mantenlo así. Si alguna vez
se ha subido una clave, rótala: eliminar el archivo no lo borra del historial.
- Los resultados contienen datos personales de otras personas. Trátalos de acuerdo con la
legislación de protección de datos (RGPD y equivalentes) y los Términos de Uso de Instagram.
- No puedes ver perfiles privados. Nada puede. Las herramientas que afirman lo contrario son
estafas.
---
## Desarrollo
```bash
pip install -r requirements-dev.txt
python -m pytest
```
La suite de pruebas se ejecuta completamente contra fixtures sintéticos — sin clave de API, sin cuota, sin red. También verifica que la documentación no se haya desviado del código.
Las solicitudes de funcionalidades y los pull requests son bienvenidos — abre un issue. ¿Encontraste un problema de seguridad? Por favor, repórtalo de forma privada en su lugar: consulta [SECURITY.md](https://github.com/datalux/osintgram/blob/master/SECURITY.md).
---
## Créditos
Osintgram está escrito por **Giuseppe Criscione**
([Datalux](https://github.com/Datalux)). La versión 2.0 lo reconstruye en torno a una interfaz web y una capa de servicio reutilizable, y añade el modo IA, los controles de costes y los análisis más recientes — consulta el [changelog](https://github.com/datalux/osintgram/blob/master/doc/CHANGELOG.md).
Debe mucho a todos los que han contribuido desde la primera versión:
<a href="https://github.com/Datalux/Osintgram/graphs/contributors">
<img src="https://contributors-img.web.app/image?repo=Datalux/Osintgram" alt="Osintgram contributors">
</a>
Los datos de Instagram provienen de [HikerAPI](https://hikerapi.com) o
[instagrapi](https://github.com/subzeroid/instagrapi). Geocodificación por
[Nominatim](https://nominatim.org) / [OpenStreetMap](https://www.openstreetmap.org/copyright).
Mapas por [Leaflet](https://leafletjs.com). Modelos locales vía
[Ollama](https://ollama.com).
Publicado bajo la licencia [GPL-3.0](https://github.com/datalux/osintgram/blob/master/LICENSE).
Instagram es una marca registrada de Meta Platforms, Inc. Este proyecto no está afiliado, respaldado ni aprobado por Meta.