Osintgram 🔎📸

Osintgram é uma ferramenta OSINT no Instagram para coletar, analisar e realizar reconhecimento.

Aviso: APENAS PARA FINS EDUCACIONAIS! Os colaboradores não assumem qualquer responsabilidade pelo uso desta ferramenta.

$${\color{red}Aviso:}$$ É aconselhável não usar sua própria/conta principal ao usar esta ferramenta.

$${\color{red}Aviso:}$$ Se você bifurcar o projeto e adicionar suas credenciais do Instagram ao seu repositório pessoal, não as envie para o GitHub. Você pode desabilitar o upload de um arquivo específico adicionando-o à lista de ignorados.

Ferramentas e Comandos 🧰

Osintgram oferece um shell interativo para realizar análises na conta do Instagram de qualquer usuário pelo seu apelido. Você pode obter:

- 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

Você pode encontrar o uso detalhado dos comandos aqui.

Última versão | Comandos | CHANGELOG

FAQ

1. Posso acessar o conteúdo de um perfil privado? Não, você não pode obter informações de perfis privados. Você só pode obter informações de um perfil público ou de um perfil que você segue. As ferramentas que afirmam ter sucesso são fraudes!
2. O que é e como posso contornar o erro challenge_required? O erro challenge_required significa que o Instagram notou um comportamento suspeito no seu perfil, então precisa verificar se você é uma pessoa real ou um bot. Para evitar isso, você deve seguir o link sugerido e completar a operação necessária (inserir um código, confirmar email, etc.)

Instalação ⚙️

1. Faça um fork/clone/baixe este repositório

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

2. Navegue até o diretório

   cd Osintgram

3. Crie um ambiente virtual para este projeto

   python3 -m venv venv

4. Ative o ambiente virtual

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

5. Execute pip install -r requirements.txt

6. Abra o arquivo credentials.ini na pasta config e escreva seu nome de usuário e senha da conta do Instagram nos campos correspondentes. Ou use hikerapi_token de https://hikerapi.com/tokens (as primeiras 100 requisições são gratuitas após registro e confirmação do seu tg)

   Alternativamente, você pode executar o comando make setup para preencher este arquivo para você.

Use Osintgram v2 (beta)

Você pode usar o Osintgram2 beta apenas mudando para a branch v2. A v2 tem algumas melhorias e é mais rápida com uma nova interface de execução de comandos. Experimente apenas executando git checkout v2.

Início Rápido com Docker 🐳

Esta seção explicará como você pode usar rapidamente esta imagem com Docker ou Docker-compose.

Pré-requisitos

Antes de usar Docker ou Docker-compose, certifique-se de ter os seguintes pré-requisitos atendidos.

1. Docker instalado - link
2. Docker-composed instalado (se estiver usando Docker-compose) - link
3. Credenciais configuradas - Isso pode ser feito manualmente ou executando o comando make setup a partir da raiz deste repositório

Importante: Seu container falhará se você não fizer o passo #3 e configurar suas credenciais

Docker

Se o Docker estiver instalado, você pode construir uma imagem e executá-la como um container.

Construir:

docker build -t osintgram .

Executar:

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

• O <target> é a conta do Instagram que você deseja usar como alvo para reconhecimento.
• A flag -i necessária ativa um terminal interativo para usar comandos dentro do container. docs
• A flag -v necessária monta um volume entre seu sistema de arquivos local e o container para salvar na pasta ./output/. docs
• A flag opcional --rm remove o sistema de arquivos do container ao finalizar para evitar acúmulo de lixo. docs
• A flag opcional -t aloca um pseudo-TTY que permite saída colorida. docs

Usando docker-compose

Você pode usar o arquivo docker-compose.yml com este único comando:

docker-compose run osintgram <target>

Onde target é o alvo do Instagram para reconhecimento.

Alternativamente, você pode executar docker-compose com o Makefile:

make run - Constrói e executa com compose. Solicita um target antes de executar.

Makefile (modo fácil)

Para facilitar o uso com Docker-compose, um Makefile foi fornecido.

Aqui está um fluxo de trabalho de exemplo para iniciar um container e executar osintgram com apenas dois comandos!

1. make setup - Configura suas credenciais do Instagram
2. make run - Constrói e executa um container osintgram e solicita um alvo

Fluxo de trabalho de exemplo para desenvolvimento:

1. make setup - Configura suas credenciais do Instagram
2. make build-run-testing - Constrói e executa um container sem invocar o script main.py. Útil para uma sessão it do Docker para desenvolvimento
3. make cleanup-testing - Limpa o container de teste criado a partir de build-run-testing

Versão de desenvolvimento 💻

Para usar a versão de desenvolvimento com os recursos e correções mais recentes, basta mudar para a branch development usando Git:

git checkout development

e atualize para a última versão usando:

git pull origin development

Atualização ⬇️

Para atualizar o Osintgram com a versão estável, basta puxar o último commit usando Git.

1. Certifique-se de estar na branch master executando: git checkout master
2. Baixe a última versão: git pull origin master

Contribuição 💡

Você pode propor uma solicitação de recurso abrindo uma issue ou um pull request.

Aqui está uma lista de contribuidores do Osintgram:

Biblioteca externa 🔗

Instagram API