BIRDY-EDWARDS 2.0

Infiltrar & Expor

Ferramenta automatizada de inteligência de Facebook com IA para perfilamento de alvos, análise de rede e relatórios de ameaças. Executa inteiramente no dispositivo via Ollama. Plataforma SOCMINT de Facebook com IA — 100% local, zero dependência de nuvem. Para a versão lite, consulte este repositório clique aqui

Instalação · Solução de problemas · Aviso legal · Contribuição

Documentação

Guias completos de uso para ambos os modos de investigação estão disponíveis no site do projeto:

• Clique aqui

Como funciona

O que há de novo na v2.0

• 🗽 Flexibilidade — Agora você pode interromper a investigação em qualquer fase e gerar o relatório em PDF
• 🎬 Inteligência de reels — A IA extrai resumo de contexto, tópico, entidades nomeadas e hashtags de cada legenda de reel
• 🔗 Matriz de coordenação de co-comentaristas — Mapa de calor de quem comenta junto com quem. Clique em qualquer célula para ver postagens compartilhadas
• 👤 Detecção facial híbrida HOG + CNN — Seleção automática de modelo por tamanho de imagem com fallback CNN→HOG. A detecção facial agora também é executada em capturas de tela de postagens de texto
• 📬 Notificações via Telegram — Relatório em PDF enviado automaticamente para o seu chat do Telegram configurado ao concluir
• 📄 Suíte completa de PDF — Adicionadas seções de inteligência de imagem, inteligência de reels, galeria de rostos, linha do tempo de postagens e pares de co-comentaristas. Bengali, Hindi, Árabe e Urdu são renderizados corretamente
• ⚙️ Fila de investigações — Até 5 investigações enfileiradas e executadas automaticamente em sequência
• 🔄 Página de progresso em tempo real — Contadores de estatísticas ao vivo são desbloqueados conforme os dados chegam durante o pipeline
• 📅 Modificação de data e hora — Durante a raspagem, é possível que coletemos apenas a data e não o carimbo de data/hora exato; portanto, como investigador, se você quiser modificar isso para o carimbo de data/hora exato, agora é possível.

Recursos

• 🔍 Coleta de perfil — Coleta automatizada de dados de postagens, fotos, reels, dados "sobre", comentários, links e nomes de perfis de comentaristas com extração de data em 9 estratégias
• 🗂️ Investigação em lote — Envie até 10 URLs de postagens mistas e execute o pipeline completo de IA em todas elas
• 🧠 Inteligência de interações — Análise de sentimento, posicionamento, emoção e idioma por interação com IA em mais de 140 idiomas, incluindo Bengali, Hindi, Árabe, Urdu e Kuki
• 📊 Pontuação de atores — Pontuação composta ponderada com classificação em 5 níveis. Os 14 principais perfis secundários são raspados em varreduras médias e profundas
• 🌍 Detecção de país — O LLM identifica o país de origem a partir de sinais do perfil com selo de % de confiança e detecção sob demanda por comentarista
• 🔬 Inteligência de imagem — LLM de visão por foto para cena, multidão, símbolos, armas, OCR e estimativa de localização
• 🎬 Inteligência de reels + postagens de texto — A IA extrai entidades, tópicos, tipos de narrativa e indicadores de ameaça de legendas e postagens
• 👤 Inteligência facial — Detecção híbrida HOG + CNN, codificação 128D, agrupamento de identidades, visualização de árvore facial D3
• 🕸️ Grafos de rede — Grafo de força D3 interativo, matriz de mapa de calor de co-comentaristas com postagens compartilhadas ao clicar, arestas de agrupamento por sobrenome
• 📄 Relatórios em PDF — Relatório completo de inteligência com inteligência de imagem, inteligência de reels, galeria de rostos, linha do tempo de postagens, análise de co-comentaristas e renderização de scripts multilíngues
• 📬 Entrega via Telegram — Relatório em PDF enviado automaticamente ao chat configurado ao concluir a investigação
• 🤖 IA local — Alimentado por Ollama, gemma4:e2b / e4b / 12b e outros modelos, executa em GPU ou CPU
• 🐳 Pronto para Docker — Implantação com um comando no Linux e Windows

⚠️ Aviso legal

O BIRDY-EDWARDS é desenvolvido estritamente para fins de inteligência autorizada, aplicação da lei e pesquisa acadêmica.

Escopo do acesso a dados:

• Esta ferramenta opera exclusivamente usando uma sessão válida do Facebook autenticada pelo operador
• Ela acessa apenas dados de perfil, postagens, fotos, reels e comentários visíveis publicamente
• Ela não acessa mensagens privadas, perfis bloqueados, conteúdo restrito ou qualquer dado não visível para um usuário conectado
• Ela não usa bots, contas falsas ou criação automatizada de contas — o operador fornece sua própria sessão autenticada

Responsabilidade legal:

• Esta ferramenta deve ser usada apenas em perfis e conteúdos onde você tenha autorização legal explícita para coletar e analisar dados
• O uso sem autorização pode violar os Termos de Serviço do Facebook, leis de privacidade aplicáveis (GDPR, IT Act, DPDP Act) e regulamentações locais
• O desenvolvedor não assume nenhuma responsabilidade por uso indevido, coleta não autorizada de dados ou qualquer dano causado pelo uso inadequado
• Todas as investigações são de responsabilidade exclusiva do operador

Ao usar o BIRDY-EDWARDS, você confirma que seu uso é legal, autorizado e está em conformidade com todas as leis aplicáveis em sua jurisdição.

Requisitos do sistema

Instalação

Pré-requisitos

Etapa 1 — Instalar o Docker

• Linux: https://docs.docker.com/engine/install/ubuntu/
• Windows: https://docs.docker.com/desktop/install/windows-install/

Etapa 2 — Instalar o Ollama

• Linux:

curl -fsSL https://ollama.com/install.sh | sh

• Windows: Baixe o instalador em https://ollama.com/download

Etapa 3 — Iniciar o Ollama vinculado a todas as interfaces

• Linux:

OLLAMA_HOST=0.0.0.0:11434 ollama serve

Para tornar isso permanente:

sudo systemctl edit ollama

Adicione:

[Service]
Environment="OLLAMA_HOST=0.0.0.0:11434"

sudo systemctl daemon-reload && sudo systemctl restart ollama

• Windows: O Ollama escuta em todas as interfaces por padrão — nenhuma configuração extra é necessária. Se não for o caso,

$env:OLLAMA_HOST="0.0.0.0"
ollama serve

Início rápido

Etapa 1 — Clonar o repositório

git clone https://github.com/jeet-ganguly/birdy-edwards.git
cd birdy-edwards

Etapa 2 — Criar os arquivos e diretórios necessários

• Linux:

mkdir -p app/reports app/face_data app/post_screenshots app/status
touch app/fb_cookies.pkl app/socmint.db app/socmint_manual.db app/.ollama_model app/queue.db

• Windows (PowerShell):

New-Item -ItemType Directory app/reports, app/face_data, app/post_screenshots, app/status
New-Item -ItemType File app/fb_cookies.pkl, app/socmint.db, app/socmint_manual.db, app/.ollama_model

Etapa 3 — Criar a imagem Docker

⚠️ A primeira compilação leva 15–25 minutos — o dlib é compilado a partir do código-fonte. As compilações subsequentes são rápidas (camadas em cache).

docker compose build

Etapa 4 — Iniciar o contêiner

docker compose up -d

docker compose logs -f

Etapa 5 — Abrir a interface web

http://localhost:5000

Etapa 6 — Importar cookies de sessão

http://localhost:5000/tools/import-cookies

Baixar um modelo de IA

Baixe um modelo na sua máquina host:

ollama pull gemma4:e2b

Ou use o painel Modelo de IA na interface web — selecione um modelo e clique em Aplicar e Baixar.

Se você estiver usando uma máquina virtual, escolha um modelo de acordo com a RAM alocada da VM.

Importar cookies de sessão

O BIRDY-EDWARDS requer uma sessão válida do Facebook. Use a extensão de navegador Cookie-Editor — funciona em todas as plataformas, sem necessidade de Selenium.

🔒 Segurança operacional: É fortemente recomendado usar uma conta fantoche dedicada para investigações em vez da sua conta pessoal do Facebook. Isso protege sua identidade e evita que sua conta principal seja sinalizada ou restrita.

1. Instale o Cookie-Editor → Chrome · Firefox
2. Faça login na sua conta de investigação dedicada no Facebook
3. Clique no Cookie-Editor enquanto estiver em facebook.com
4. Clique em Exportar → Exportar como JSON
5. Vá para http://localhost:5000/tools/import-cookies e cole

Configurar notificações do Telegram

Receba seu relatório em PDF automaticamente após cada investigação.

1. Crie um bot do Telegram via @BotFather e copie o token do bot
2. Obtenha seu chat ID — envie uma mensagem para o seu bot e depois visite https://api.telegram.org/bot<TOKEN>/getUpdates
3. Vá para o painel Telegram na interface web
4. Cole seu token do bot e chat ID e clique em Salvar
5. Clique em Testar para verificar a conexão

A partir desse ponto, toda investigação concluída envia automaticamente uma notificação com o relatório em PDF anexado.

Como você pode ajudar

Se você acha o BIRDY-EDWARDS útil ou interessante, aqui estão algumas maneiras de apoiar o projeto:

• ⭐ Dê uma estrela no repositório — ajuda outras pessoas a descobrirem a ferramenta
• 🐛 Relate bugs — abra uma Issue se algo não estiver funcionando
• 🔧 Contribua — consulte a seção Contribuição para começar
• 📢 Compartilhe — publique em comunidades de OSINT, fóruns, X ou com colegas que possam achá-lo útil
• 💬 Dê feedback — sugestões para novos recursos ou melhorias são sempre bem-vindas

Toda contribuição, grande ou pequena, ajuda a construir melhores ferramentas para a comunidade de OSINT e inteligência de ameaças.

Solução de problemas

Ollama inacessível a partir do Docker

docker exec -it birdy-edwards curl http://host.docker.internal:11434/api/tags

Se falhar, reinicie o Ollama com OLLAMA_HOST=0.0.0.0:11434 ollama serve

Erro de banco de dados: tabela inexistente ou outro erro relacionado ao banco
Inicie uma nova investigação — o esquema é criado automaticamente no primeiro uso. Se você interromper o processo durante a análise, exclua essa investigação e inicie uma nova.

Cookies expirados
Vá para http://localhost:5000/tools/import-cookies e reimporte cookies novos.

Porta 5000 já em uso
Altere em docker-compose.yml: "5001:5000" e acesse em http://localhost:5001

Sem memória durante a compilação
Aumente a memória do Docker Desktop para 8 GB+ via Configurações → Recursos → Memória

Mapa não carrega
Os tiles do Leaflet + ArcGIS exigem acesso à internet na máquina host. Se estiver executando totalmente sem rede, o contêiner do mapa aparecerá em branco — todos os outros recursos funcionam normalmente.

Telegram não envia
Confirme que seu bot foi iniciado enviando uma mensagem /start. Verifique se o chat ID está correto usando a URL getUpdates. Verifique se a porta 443 não está bloqueada na sua rede.

Contribuição

Contribuições são bem-vindas. Siga estas diretrizes para manter o projeto limpo e consistente.

Relatando bugs

• Abra uma Issue descrevendo o bug, os passos para reproduzi-lo e seu ambiente (SO, RAM, versão do Docker)
• Anexe os logs relevantes de docker compose logs

Solicitações de recursos

• Abra uma Issue com uma descrição clara do recurso e seu caso de uso
• Discuta antes de abrir um Pull Request para mudanças grandes

Enviando um Pull Request

• Faça um fork do repositório
• Crie um branch de recurso: git checkout -b feature/nome-do-seu-recurso
• Faça commit das suas alterações: git commit -m "Adicionar: descrição curta"
• Envie para o seu branch: git push origin feature/nome-do-seu-recurso
• Abra um Pull Request contra main

Diretrizes de código

• Siga o estilo de código existente — Python 3.12, convenções do Flask
• Teste suas alterações localmente via Docker antes de enviar
• Não faça commit de fb_cookies.pkl, bancos de dados ou qualquer dado raspado
• Mantenha as alterações no raspador mínimas — o DOM do Facebook muda com frequência

O que aceitamos

• Correções de bugs e melhorias de estabilidade
• Suporte a novos modelos do Ollama
• Melhorias na interface
• Melhorias na documentação
• Suporte adicional a idiomas para OCR e análise de comentários

O que não aceitamos

• Recursos que contornam controles de segurança da plataforma
• Alterações que introduzam dependências de nuvem
• Código que armazene ou transmita dados de investigação externamente

Agradecimentos

• Inspirado por Sherlock
• Inspirado pela comunidade de pesquisa em OSINT e inteligência de ameaças
• SeleniumBase — Automação não detectada do Chrome
• Ollama — Motor de inferência LLM local
• face_recognition — Biblioteca de detecção e codificação facial
• Leaflet — Biblioteca de mapas interativos
• ArcGIS — Tiles de mapa com fronteiras constitucionais corretas
• pyvis — Visualização interativa de grafos de rede
• reportlab — Geração de PDF
• pytesseract — Wrapper do motor OCR
• D3.js — Visualização de dados e grafos interativos