IG-Detective 🕵️‍♂️📸

Criado por @shredzwho | 💖 Patrocine este projeto

IG-Detective é uma ferramenta OSINT (Inteligência de Fontes Abertas) de alto desempenho baseada em Python para Instagram. Ela oferece um shell interativo premium para realizar análises profundas em contas do Instagram, extrair histórico de localização, mapear interações e gerar relatórios investigativos automatizados.

[!WARNING] Aviso: Esta ferramenta é apenas para fins educacionais e de pesquisa. Use-a com responsabilidade e de acordo com os Termos de Serviço do Instagram. O autor não se responsabiliza por qualquer uso indevido.

---

⚡ Funcionalidades

🛡️ Evasão e Furtividade (Avançado)

• Falsificação de Impressão Digital TLS: Utiliza um navegador headless Playwright chromium com playwright-stealth para imitar um ambiente real, contornando completamente o Cloudflare e a limitação de taxa da CDN.
• Evasão Profunda como Fallback: Alterna automaticamente para uma busca headless não autenticada se uma sessão autenticada estiver shadowbanned (ex.: bloqueios HTTP 401/429/400), omitindo cookies e forjando cabeçalhos para simular uma conexão limpa.
• Jitter de Poisson: Atrasos aleatórios semelhantes a humanos entre as requisições para imitar o comportamento natural do usuário.

⚡ Desempenho e Otimização

• Ajuste de Memória Headless: Configuração reduzida do navegador Playwright que descarta explicitamente assets visuais pesados (imagens, fontes, folhas de estilo) via interceptação de rota para alcançar velocidades de consulta ultra-rápidas.
• Exportação Assíncrona de Dados: Utiliza download paralelo com ThreadPool para o comando de arquivamento data, acelerando drasticamente a replicação completa da mídia do perfil.

🔍 Reconhecimento Principal

• Informações do Usuário: Detalhes abrangentes do perfil (ID, Bio, Seguidores, status de negócios).
• Seguidores/Seguindo: Listar e exportar a rede social do alvo.
• Análise de Postagens: Detalhamento de conteúdo recente, curtidas e comentários.

📍 OSINT Avançado

• Mapeamento Geoespacial Interativo: Extrai coordenadas GPS de postagens e gera um interactive_map.html do Folium com endereços legíveis e marcadores clicáveis.
• Análise de Rede Social (sna): Mapeia interações para identificar o "Círculo Íntimo"—os 10 usuários mais conectados ao alvo.
• Perfil Temporal de Atividade (temporal): Usa agrupamento DBSCAN para identificar a "janela de sono" do alvo e prever seu fuso horário principal.
• Extração de Stories (stories): Busca URLs de stories ativos.

🔬 Módulos Forenses de Pesquisa (Estado-da-Arte)

• Enumeração de Recuperação de Conta (recovery): Aciona o fluxo de redefinição de senha para revelar dicas de contato mascaradas para verificação administrativa de e-mail.
• Análise de Co-Visitação (intersect): Identifica pontos de encontro físicos ao cruzar interseções de GPS/Tempo entre dois alvos.
• Estilometria (stylometry): Gera uma "Assinatura Linguística" digital para vincular múltiplas contas com base na distribuição de bigramas e emojis.
• Auditoria de Engajamento (audit): Detecção estatística de atividade de bot inautêntica por meio de variação de jitter temporal.

📦 Gerenciamento de Investigação

• Exportação com Um Clique (data): Baixa automaticamente a lista de seguidores, lista de seguidos e mídia da timeline do alvo (com JSON de metadados), empacotados em um único arquivo ZIP.
• Relatórios Automatizados: Cada comando salva automaticamente os resultados em relatórios JSON e TXT em data/<target>/.
• Modo Batch Autônomo: Processa múltiplos alvos sequencialmente a partir de um arquivo de texto.
• Cache Inteligente: Consultas repetidas ultra-rápidas via cache baseado em TTL.

---

🚀 Instalação

1. Clone o repositório

   root@kitploit:~

   git clone https://github.com/shredzwho/IG-Detective.git
   cd IG-Detective
   

2. Configure o Ambiente Virtual

   root@kitploit:~

   python3 -m venv venv
   source venv/bin/activate  # No Windows: venv\Scripts\activate
   

3. Instale as Dependências

   root@kitploit:~

   pip install -r requirements.txt
   

🐳 Execute com Docker (Recomendado)

Você pode executar o IG-Detective inteiramente dentro do Docker para evitar problemas de dependência. O contêiner requer um TTY interativo (-it) e um volume montado para salvar seus relatórios forenses.

1. Usando Docker Compose (Mais Fácil)

   root@kitploit:~

   docker-compose run --rm detective
   

2. Usando Docker padrão

   root@kitploit:~

   docker build -t ig-detective .
   docker run -it -v $(pwd)/data:/app/data ig-detective
   

---

🛠 Uso

1. Inicie o Shell

   root@kitploit:~

   python3 main.py
   # ou use o wrapper fornecido:
   ./run.sh
   

2. Comandos Principais Dentro do shell, você deve primeiro definir um alvo antes de executar os módulos de análise:

---

📑 Documentação Detalhada

Para um mergulho profundo na arquitetura do sistema, metodologias forenses e lógica de evasão, veja: 👉 DOCUMENTATION.md

---

📂 Estrutura do Projeto

• main.py: Ponto de entrada principal para o shell.
• run.sh: Script de inicialização wrapper.
• src/api/: Camada de rede contendo o cliente stealth Playwright e gerenciador de autenticação.
• src/core/: Camada de base com modelos de dados e configuração.
• src/modules/: Camada de lógica de negócios com scrapers e ferramentas de análise profunda.
• src/cli/: Camada de apresentação com o prompt interativo e formatadores Rich.
• data/: Relatórios investigativos automatizados (ignorados pelo git).

---

🤝 Contribuindo

Sinta-se à vontade para bifurcar este projeto e enviar pull requests. Para mudanças importantes, abra uma issue primeiro para discutir o que gostaria de alterar.

📜 Licença

[MIT]