SOCMIntelligence

Ferramenta web SOCMINT / OSINT multiplataforma.

---

O que é

O SOCMIntelligence coleta dados públicos de diversas plataformas, transforma cada resultado em gráficos, tabelas de achados e um grafo de relacionamentos, e mescla tudo em um único grafo de identidade multiplataforma. Como a mesma conta recebe o mesmo ID de nó em todos os lugares, um e-mail, domínio ou nome de usuário que apareça em duas varreduras diferentes é automaticamente vinculado — assim você pode ver quem é quem entre os serviços.

Módulos

Grupo	Módulos
Redes sociais	X (Twitter) · Instagram · Bluesky · LinkedIn · YouTube · TikTok · Twitch · Kick · Snapchat · Reddit · Mastodon · Telegram · Discord · Steam
Desenvolvedor	GitHub · GitLab · Stack Exchange · Hacker News
Identidade e arquivos	Keybase · Gravatar · Wayback Machine
Busca e mapa	Busca por palavra-chave (Bluesky · Reddit · Mastodon) · Mapa de hashtags

Cada módulo lê apenas dados públicos (ou uma API oficial quando uma chave é fornecida). Não há scraping de credenciais/sessões de contas privadas.

Recursos

• Grafo de relacionamentos — um grafo de força D3 que mescla todas as varreduras bem-sucedidas. Correspondências multiplataforma (e-mail, domínio, nome de usuário compartilhados), pivô (clique duplo em um nó para escaneá-lo no módulo correto), busca, filtros por tipo, exportação em PNG/JSON.
• Linha do tempo — posts, comentários, uploads e eventos de criação de conta de cada conta em um único eixo, além de um mapa de calor de sobreposição de horários e uma tabela de similaridade de horários.
• Correspondência de identidade — uma pontuação de 0 a 100 de “mesma pessoa?” por par de contas com justificativas (vínculo verificado/criptográfico, e-mail compartilhado, similaridade de nome de usuário e nome de exibição, domínio pessoal compartilhado, pHash do avatar, horários de atividade). Pares ≥ 40 são desenhados no grafo.
• Comparação — coloque 2 ou mais contas escaneadas do mesmo módulo lado a lado (tabela de KPIs + gráfico de barras, com o maior valor destacado).
• Marcações do analista — marque nós do grafo como Verificado / Suspeito / Descartado, adicione notas, adicione nós e links manuais. Tudo salvo no caso.
• Gestão de casos — crie um caso, ative-o, e varreduras/marcações/notas são salvas automaticamente. Importe/exporte um pacote .socmint.
• Rastreamento de mudanças (Monitoramento) — reescaneie alvos em um cronograma e registre o que mudou (campos, links adicionados/removidos).
• Integridade das evidências — os dados brutos de cada varredura recebem hash (SHA-256 sobre JSON canônico) no momento da coleta; um botão de verificação comprova se foram alterados.
• Exportações — relatório HTML / PDF, Excel (.xlsx), GraphML (Gephi/yEd), GEXF (Gephi), Maltego CSV, JSON.
• Interface em inglês — toda a interface, relatórios, planilhas e rótulos de gráficos estão em inglês.
• Página de configurações — chaves de API, proxy / Tor / rotação de lista de proxies e limites de taxa, tudo gerenciado pela interface em vez do .env.

Instalação

pipx (recomendado no Linux)

pipx install socmintelligence
socmintelligence

ou com pip dentro de um virtualenv:

pip install socmintelligence
socmintelligence

Em seguida, abra http://localhost:8000. Opções: socmintelligence --host 0.0.0.0 --port 8000 --data-dir ~/socmint-data --no-browser. Os dados (casos, configurações) são armazenados em ~/.local/share/socmintelligence, a menos que --data-dir ou SOCMINT_DATA_DIR esteja definido.

Diretamente do GitHub: pipx install git+https://github.com/emrekybs/SOCMIntelligence

Início rápido (a partir do código-fonte)

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn server:app --host 0.0.0.0 --port 8000

Em seguida, abra http://localhost:8000 — documentação da API em http://localhost:8000/docs.

As execuções seguintes precisam apenas de:

source .venv/bin/activate && uvicorn server:app --port 8000

Docker: docker compose up --build (serviço único).

Configuração

Toda a configuração fica na página Settings (guardada em data/settings.json; o .env ainda é lido, mas as Settings têm prioridade):

• Chaves de API — armazenadas no servidor, nunca devolvidas ao navegador (apenas "set" + os últimos 4 caracteres são mostrados).
  • YOUTUBE_API_KEY — necessária para o módulo do YouTube.
  • HIKERAPI_TOKEN — Instagram (HikerAPI). Sem ela, o módulo do Instagram mostra dados de exemplo claramente identificados.
  • X_BEARER_TOKEN — API v2 do X (Twitter). Sem ela, o módulo do X mostra dados de exemplo claramente identificados, para que possa pré-visualizar o resultado antes de adicionar um token.
  • STEAM_API_KEY, STACKEXCHANGE_KEY, GRAVATAR_API_KEY, GITLAB_TOKEN — opcionais, desbloqueiam dados adicionais.
• Proxy / Tor — desligado, Tor, um único proxy personalizado, ou uma lista de proxies que roda em round-robin a cada scan (distribui os limites de taxa).
• Rate — número de scans paralelos e atraso entre pedidos.

Notas

• X (Twitter): o plano gratuito do X é muito limitado — mesmo com um token, o histórico de publicações pode vir vazio em alguns planos; o módulo assinala esse caso.
• Telegram lê apenas a pré-visualização pública t.me/s/ (sem login).
• Gravatar recebe apenas o hash MD5/SHA-256 de um email, nunca o próprio email.
• TikTok aplica frequentemente limites de taxa/bloqueia bots; o módulo tenta novamente e distingue um verdadeiro "não encontrado" de um bloqueio temporário.
• As distribuições temporais são em UTC. O "crescimento" de seguidores do TikTok é uma estimativa (assinalada como tal), não um histórico real.

Licença

Apache License 2.0 — consulte LICENSE.