Osintgram 🔎📸

Osintgram es una herramienta OSINT en Instagram para recolectar, analizar y ejecutar reconocimiento.

Descargo de responsabilidad: SOLO CON FINES EDUCATIVOS. Los contribuyentes no asumen ninguna responsabilidad por el uso de esta herramienta.

$${\color{red}Aviso:}$$ Se recomienda no usar tu propia cuenta principal al utilizar esta herramienta.

$${\color{red}Aviso:}$$ Si haces un fork del proyecto y agregas tus credenciales de Instagram a tu repositorio local, no las subas a GitHub. Puedes deshabilitar la subida de un archivo específico agregándolo a la lista de ignorados.

Herramientas y Comandos 🧰

Osintgram ofrece un shell interactivo para realizar análisis en cuentas de Instagram de cualquier usuario por su nombre de usuario. Puedes obtener:

- addrs           Get all registered addressed by target photos
- captions        Get user's photos captions
- comments        Get total comments of target's posts
- followers       Get target followers
- followings      Get users followed by target
- fwersemail      Get email of target followers
- fwingsemail     Get email of users followed by target
- fwersnumber     Get phone number of target followers
- fwingsnumber    Get phone number of users followed by target
- hashtags        Get hashtags used by target
- info            Get target info
- likes           Get total likes of target's posts
- mediatype       Get user's posts type (photo or video)
- photodes        Get description of target's photos
- photos          Download user's photos in output folder
- propic          Download user's profile picture
- stories         Download user's stories  
- tagged          Get list of users tagged by target
- wcommented      Get a list of user who commented target's photos
- wtagged         Get a list of user who tagged target

Puedes encontrar el uso detallado de los comandos aquí.

Última versión | Comandos | CHANGELOG

FAQ

1. ¿Puedo acceder al contenido de un perfil privado? No, no puedes obtener información de perfiles privados. Solo puedes obtener información de un perfil público o de un perfil que sigues. ¡Las herramientas que afirman tener éxito son estafas!
2. ¿Qué es y cómo puedo evitar el error challenge_required? El error challenge_required significa que Instagram ha detectado un comportamiento sospechoso en tu perfil, por lo que necesita verificar si eres una persona real o un bot. Para evitarlo, debes seguir el enlace sugerido y completar la operación requerida (insertar un código, confirmar correo electrónico, etc.)

Instalación ⚙️

1. Fork/Clona/Descarga este repositorio

   git clone https://github.com/Datalux/Osintgram.git

2. Navega al directorio

   cd Osintgram

3. Crea un entorno virtual para este proyecto

   python3 -m venv venv

4. Carga el entorno virtual

   • En Windows Powershell: .\venv\Scripts\activate.ps1
   • En Linux y Git Bash: source venv/bin/activate

5. Ejecuta pip install -r requirements.txt

6. Abre el archivo credentials.ini en la carpeta config y escribe tu nombre de usuario y contraseña de Instagram en los campos correspondientes. O usa hikerapi_token de https://hikerapi.com/tokens (las primeras 100 solicitudes son gratuitas después del registro y confirmación de tu tg)

   Alternativamente, puedes ejecutar el comando make setup para rellenar este archivo automáticamente.

Usar Osintgram v2 (beta)

Puedes usar la versión beta de Osintgram2 cambiando a la rama v2. v2 tiene algunas mejoras y es más rápido con una nueva interfaz de ejecución de comandos. Pruébalo ejecutando git checkout v2.

Inicio rápido con Docker 🐳

Esta sección explicará cómo puedes usar rápidamente esta imagen con Docker o Docker-compose.

Requisitos previos

Antes de usar Docker o Docker-compose, asegúrate de tener los siguientes requisitos previos.

1. Docker instalado - enlace
2. Docker-compose instalado (si usas Docker-compose) - enlace
3. Credenciales configuradas - Esto se puede hacer manualmente o ejecutando el comando make setup desde la raíz de este repositorio

Importante: Tu contenedor fallará si no realizas el paso #3 y configuras tus credenciales

Docker

Si tienes Docker instalado, puedes construir una imagen y ejecutarla como un contenedor.

Construir:

docker build -t osintgram .

Ejecutar:

docker run --rm -it -v "$PWD/output:/home/osintgram/output" osintgram <target>

• El <target> es la cuenta de Instagram que deseas usar como objetivo para el reconocimiento.
• La bandera requerida -i habilita una terminal interactiva para usar comandos dentro del contenedor. documentación
• La bandera requerida -v monta un volumen entre tu sistema de archivos local y el contenedor para guardar en la carpeta ./output/. documentación
• La bandera opcional --rm elimina el sistema de archivos del contenedor al finalizar para evitar la acumulación de residuos. documentación
• La bandera opcional -t asigna un pseudo-TTY que permite salida con colores. documentación

Usando docker-compose

Puedes usar el archivo docker-compose.yml con este único comando:

docker-compose run osintgram <target>

Donde target es el objetivo de Instagram para el reconocimiento.

Alternativamente, puedes ejecutar docker-compose con el Makefile:

make run - Construye y ejecuta con compose. Solicita un target antes de ejecutar.

Makefile (modo fácil)

Para facilitar el uso con Docker-compose, se ha proporcionado un Makefile.

Aquí hay un flujo de trabajo de ejemplo para iniciar un contenedor y ejecutar osintgram con solo dos comandos:

1. make setup - Configura tus credenciales de Instagram
2. make run - Construye y ejecuta un contenedor de osintgram y solicita un objetivo

Flujo de trabajo de ejemplo para desarrollo:

1. make setup - Configura tus credenciales de Instagram
2. make build-run-testing - Construye y ejecuta un contenedor sin invocar el script main.py. Útil para una sesión interactiva de Docker para desarrollo
3. make cleanup-testing - Limpia el contenedor de prueba creado a partir de build-run-testing

Versión de desarrollo 💻

Para usar la versión de desarrollo con las últimas características y correcciones, simplemente cambia a la rama development usando Git:

git checkout development

y actualiza a la última versión usando:

git pull origin development

Actualización ⬇️

Para actualizar Osintgram con la versión estable, simplemente trae el último commit usando Git.

1. Asegúrate de estar en la rama master ejecutando: git checkout master
2. Descarga la última versión: git pull origin master

Contribuciones 💡

Puedes proponer una solicitud de función abriendo un issue o un pull request.

Aquí hay una lista de contribuyentes de Osintgram:

Librería externa 🔗

Instagram API