🔍 Servidor MCP de Ferramentas OSINT

Um servidor MCP abrangente que expõe múltiplas ferramentas OSINT para assistentes de IA como Claude. Este servidor permite que a IA realize tarefas sofisticadas de reconhecimento e coleta de informações usando ferramentas OSINT padrão da indústria.

🛠️ Ferramentas Disponíveis

🔍 Sherlock - Pesquisa de Nome de Usuário

Pesquise nomes de usuário em mais de 399 plataformas de redes sociais e sites. Perfeito para análise de pegada digital.

• Entrada: Nome de usuário
• Saída: Lista de plataformas onde o nome de usuário existe

📧 Holehe - Verificação de E-mail

Verifique se um e-mail está registrado em mais de 120 plataformas. Rápido e preciso.

• Entrada: Endereço de e-mail
• Saída: Plataformas onde o e-mail está registrado

🕷️ SpiderFoot - OSINT Abrangente

O canivete suíço do OSINT. Realiza reconhecimento profundo com detecção automática de tipo de alvo.

• Entrada: IP, domínio, e-mail, telefone, nome de usuário, nome de pessoa, endereço Bitcoin ou bloco de rede
• Saída: Relatório de inteligência abrangente
• ⚠️ Nota: SpiderFoot pode levar de 5 a 30 minutos para concluir uma varredura completa. Seja paciente!

🔎 GHunt - Informações de Conta Google

Extraia informações de contas do Google usando e-mail ou ID do Google.

• Entrada: E-mail ou ID do Google
• Saída: Detalhes da conta do Google e informações associadas

🌐 Maigret - Pesquisa Avançada de Nome de Usuário

Pesquise em mais de 3000 sites com detecção de falsos positivos e análise detalhada.

• Entrada: Nome de usuário
• Saída: Relatório detalhado com pontuações de confiança

🌾 TheHarvester - Inteligência de Domínio

Colete e-mails, subdomínios, hosts, nomes de funcionários e muito mais de fontes públicas.

• Entrada: Nome de domínio ou empresa
• Saída: Inteligência abrangente do domínio

🐦 Blackbird - OSINT Rápido de Nome de Usuário

Pesquisas ultrarrápidas em 581 sites para reconhecimento de nome de usuário.

• Entrada: Nome de usuário
• Saída: Resultados rápidos de descoberta de perfil

🚀 Instalação

Configuração do Servidor MCP

1. Clone este repositório:

git clone https://github.com/frishtik/osint-tools-mcp-server.git
cd osint-tools-mcp-server

2. Instale as dependências:

pip install -r requirements.txt

Isso instalará automaticamente Sherlock, Holehe, Maigret e TheHarvester.

3. Configure o Claude Desktop:

Adicione à sua configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

{
  "mcpServers": {
    "osint-tools": {
      "command": "python",
      "args": ["/caminho/para/osint-tools-mcp-server/src/osint_tools_mcp_server.py"],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

4. Reinicie o Claude Desktop para carregar o novo servidor MCP.

Pré-requisitos para Ferramentas Adicionais

Algumas ferramentas requerem instalação manual devido à sua complexidade:

SpiderFoot

git clone https://github.com/smicallef/spiderfoot.git /opt/spiderfoot
cd /opt/spiderfoot
pip install -r requirements.txt

GHunt

git clone https://github.com/mxrch/GHunt.git /opt/ghunt
cd /opt/ghunt
pip install -r requirements.txt

Blackbird

git clone https://github.com/p1ngul1n0/blackbird.git /opt/blackbird
cd /opt/blackbird
pip install -r requirements.txt

🎮 Dicas de Uso

Primeiros Passos

Trabalhar com IA para OSINT é um pouco uma arte. Veja como obter os melhores resultados:

Comece Simples com o Holehe

Recomendo começar com a ferramenta Holehe — é rápida, confiável e fornece resultados imediatos:

"Verifique se [email protected] está registrado em alguma plataforma"

Avance para Pesquisas de Nome de Usuário

Depois de se sentir confortável, tente pesquisas de nome de usuário com Sherlock ou Maigret:

"Pesquise o nome de usuário 'johndoe123' em plataformas de redes sociais"

Orquestrações Complexas

Aqui é onde fica interessante. Você pode encadear ferramentas:

"Encontrei um e-mail [email protected]. Você pode:
1. Verificar em quais plataformas ele está registrado
2. Extrair o domínio e pesquisar subdomínios e outros e-mails
3. Procurar nomes de usuário associados a este domínio"

Deixe a IA Ser Inteligente

Às vezes a melhor abordagem é dar contexto ao Claude e deixá-lo decidir:

"Estou investigando a pegada digital do nome de usuário 'hackerman2024'. 
Use seu julgamento para coletar o máximo de informações possível."

Dicas Profissionais 🎯

1. Paciência com SpiderFoot: É extremamente minucioso, mas pode levar até 30 minutos para uma varredura completa. Inicie e tome um café!

2. Processamento Paralelo: Claude pode executar várias ferramentas simultaneamente. Não hesite em pedir pesquisas paralelas:

   "Pesquise por 'johndoe' tanto no Sherlock quanto no Maigret ao mesmo tempo"
   

3. Saiba Quando Segurar a Rédea:

   • Para investigações específicas: Seja explícito sobre quais ferramentas usar
   • Para pesquisa exploratória: Deixe Claude escolher as ferramentas
   • Para tarefas sensíveis ao tempo: Evite SpiderFoot, use ferramentas mais rápidas

4. Cruze Resultados: Ferramentas diferentes têm bancos de dados diferentes. Maigret pode encontrar contas que Sherlock perde e vice-versa.

5. E-mail Primeiro, Nome de Usuário Depois: Se você tem um e-mail, comece por ele — geralmente é mais único que nomes de usuário.

⚖️ Uso Ético e Conformidade Legal

🚨 IMPORTANTE: Esta ferramenta é apenas para pesquisa de segurança legítima e investigações OSINT.

Você DEVE:

• ✅ Apenas coletar informações publicamente disponíveis
• ✅ Respeitar as leis de privacidade da sua jurisdição (LGPD, GDPR, etc.)
• ✅ Seguir os Termos de Serviço das plataformas
• ✅ Usar os achados de forma responsável e ética
• ✅ Obter autorização adequada para qualquer investigação profissional

Você NÃO DEVE:

• ❌ Usar isso para perseguição, assédio ou qualquer propósito malicioso
• ❌ Violar leis locais, estaduais ou federais
• ❌ Acessar informações privadas ou protegidas
• ❌ Usar achados para prejudicar indivíduos ou organizações

🔧 Solução de Problemas

Problemas Comuns

Ferramentas não encontradas: Certifique-se de que todas as ferramentas OSINT estão instaladas e no seu PATH:

which sherlock holehe maigret theharvester

Erros no SpiderFoot: Garanta que o SpiderFoot está instalado em /opt/spiderfoot ou atualize o caminho no código.

Problemas de tempo limite: Algumas ferramentas podem expirar em conexões lentas. Tente aumentar o parâmetro de tempo limite:

"Pesquise o nome de usuário com um tempo limite de 30 segundos"
"

**Limitação de taxa**: Algumas plataformas limitam a taxa de pesquisas. Se você estiver sendo bloqueado, espere um pouco e tente novamente.

## 🏗️ Arquitetura

Este servidor MCP usa asyncio do Python para execução não bloqueante de ferramentas. Cada ferramenta roda em um subprocesso, permitindo execução paralela e tratamento adequado de tempo limite.

Claude Desktop <-> Protocolo MCP <-> Servidor OSINT MCP <-> Ferramentas OSINT

## 🤝 Contribuindo

Encontrou um bug? Quer adicionar uma nova ferramenta? Contribuições são bem-vindas!