🔍 OSINT Tools MCP Server

Полнофункциональный MCP-сервер, предоставляющий AI-ассистентам, таким как Claude, доступ к множеству OSINT-инструментов. Этот сервер позволяет AI выполнять сложные задачи разведки и сбора информации с помощью отраслевых OSINT-инструментов.

🛠️ Доступные инструменты

🔍 Sherlock — Поиск по имени пользователя

Поиск имени пользователя на 399+ платформах социальных сетей и веб-сайтах. Идеально подходит для анализа цифрового следа.

• Входные данные: имя пользователя
• Результат: список платформ, на которых найдено имя

📧 Holehe — Проверка электронной почты

Проверяет, зарегистрирован ли email на 120+ платформах. Быстро и точно.

• Входные данные: адрес электронной почты
• Результат: платформы, на которых зарегистрирован email

🕷️ SpiderFoot — Комплексный OSINT

Швейцарский нож OSINT. Выполняет глубокую разведку с автоматическим определением типа цели.

• Входные данные: IP, домен, email, телефон, имя пользователя, имя человека, Bitcoin-адрес или сетевой блок
• Результат: полный разведывательный отчёт
• ⚠️ Примечание: полное сканирование SpiderFoot может занять 5–30 минут. Наберитесь терпения!

🔎 GHunt — Интеллект Google-аккаунтов

Извлекает информацию об аккаунтах Google по email или Google ID.

• Входные данные: email или Google ID
• Результат: детали учётной записи Google и связанная информация

🌐 Maigret — Расширенный поиск имени пользователя

Поиск по 3000+ сайтам с детектированием ложных срабатываний и подробным анализом.

• Входные данные: имя пользователя
• Результат: подробный отчёт с оценками достоверности

🌾 TheHarvester — Доменная разведка

Собирает email, поддомены, хосты, имена сотрудников и другие данные из открытых источников.

• Входные данные: домен или название компании
• Результат: всесторонняя доменная разведка

🐦 Blackbird — Быстрый OSINT по имени пользователя

Молниеносный поиск по 581 сайту для разведки по имени пользователя.

• Входные данные: имя пользователя
• Результат: результаты быстрого обнаружения профилей

🚀 Установка

Настройка MCP-сервера

1. Клонируйте репозиторий:

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

2. Установите зависимости:

pip install -r requirements.txt

Это автоматически установит Sherlock, Holehe, Maigret и TheHarvester.

3. Настройте Claude Desktop:

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

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

4. Перезапустите Claude Desktop для загрузки нового MCP-сервера.

Предварительные требования для дополнительных инструментов

Некоторые инструменты требуют ручной установки из-за их сложности:

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

🎮 Советы по использованию

Начало работы

Работа с AI для OSINT — это своего рода искусство. Вот как добиться наилучших результатов:

Начните с простого — Holehe

Рекомендую начать с инструмента Holehe — он быстрый, надёжный и сразу даёт результаты:

"Проверь, зарегистрирован ли [email protected] на каких-либо платформах"

Переходите к поиску имён пользователей

Когда освоитесь, попробуйте поиск имён пользователей с помощью Sherlock или Maigret:

"Найди имя пользователя 'johndoe123' в социальных сетях"

Сложные оркестровки

Здесь всё становится интереснее. Вы можете объединять инструменты:

"Я нашёл email [email protected]. Можешь ли ты:
1. Проверить, на каких платформах он зарегистрирован
2. Извлечь домен и найти поддомены и другие email-адреса
3. Найти любые имена пользователей, связанные с этим доменом"

Позвольте AI проявить смекалку

Иногда лучше просто передать Claude контекст и позволить ему решать:

"Я исследую цифровой след имени пользователя 'hackerman2024'. 
Используй своё усмотрение, чтобы собрать как можно больше информации."

Про-советы 🎯

1. Наберитесь терпения с SpiderFoot: Он чрезвычайно тщателен, но может занять до 30 минут на полное сканирование. Запустите его и выпейте кофе!

2. Параллельная обработка: Claude может запускать несколько инструментов одновременно. Не стесняйтесь запрашивать параллельные поиски:

   root@kitploit:~

   "Найди 'johndoe' одновременно в Sherlock и Maigret"
   

3. Знайте, когда ослабить поводок:

   • Для конкретных расследований: чётко указывайте, какие инструменты использовать
   • Для исследовательского поиска: позвольте Claude выбирать инструменты
   • Для срочных задач: избегайте SpiderFoot, используйте более быстрые инструменты

4. Перекрёстная проверка результатов: Разные инструменты используют разные базы данных. Maigret может найти аккаунты, пропущенные Sherlock, и наоборот.

5. Сначала email, потом имя пользователя: Если у вас есть email, начинайте с него — он обычно более уникален, чем имена пользователей.

⚖️ Этичное использование и соблюдение законодательства

🚨 ВАЖНО: Этот инструмент предназначен только для законных исследований безопасности и OSINT-расследований.

Вы ОБЯЗАНЫ:

• ✅ Собирать только общедоступную информацию
• ✅ Соблюдать законы о конфиденциальности вашей юрисдикции (GDPR, CCPA и др.)
• ✅ Соблюдать правила платформ
• ✅ Использовать полученные данные ответственно и этично
• ✅ Получать соответствующее разрешение для профессиональных расследований

Вы НЕ ДОЛЖНЫ:

• ❌ Использовать это для слежки, преследования или любых вредоносных целей
• ❌ Нарушать какие-либо местные, государственные или федеральные законы
• ❌ Получать доступ к частной или защищённой информации
• ❌ Использовать полученные данные для причинения вреда лицам или организациям

🔧 Устранение неполадок

Частые проблемы

Инструменты не найдены: Убедитесь, что все OSINT-инструменты установлены и находятся в вашем PATH:

which sherlock holehe maigret theharvester

Ошибки SpiderFoot: Убедитесь, что SpiderFoot установлен в /opt/spiderfoot или обновите путь в коде.

Проблемы с таймаутом: Некоторые инструменты могут зависнуть при медленном соединении. Попробуйте увеличить параметр таймаута:

"Найди имя пользователя с таймаутом 30 секунд"

Ограничение частоты запросов: Некоторые платформы ограничивают количество поисковых запросов. Если вас заблокировали, подождите и попробуйте снова.

🏗️ Архитектура

Этот MCP-сервер использует asyncio Python для неблокирующего выполнения инструментов. Каждый инструмент запускается в отдельном процессе, что обеспечивает параллельное выполнение и правильную обработку таймаутов.

Claude Desktop <-> MCP Protocol <-> OSINT MCP Server <-> OSINT Tools

🤝 Вклад

Нашли баг? Хотите добавить новый инструмент? Вклад приветствуется!

1. Форкните репозиторий
2. Создайте ветку для функции (git checkout -b feature/NewOSINTTool)
3. Зафиксируйте изменения (git commit -m 'Add NewOSINTTool support')
4. Отправьте в удалённый репозиторий (git push origin feature/NewOSINTTool)
5. Откройте Pull Request

📚 Благодарности

Особая благодарность этим замечательным проектам:

• mcp-maigret — вдохновение для реализации MCP и структуры README. Поставьте им ⭐!
• Model Context Protocol — протокол, делающий всё это возможным
• Всем невероятным разработчикам OSINT-инструментов

📜 Лицензия

Этот проект лицензирован по лицензии MIT — см. файл LICENSE для подробностей.

⚠️ Отказ от ответственности

Этот инструмент предоставляется только для образовательных и законных целей исследований безопасности. Авторы не несут ответственности за любое неправомерное использование или ущерб, причинённый этой программой. Используйте на свой страх и риск и всегда убедитесь, что у вас есть надлежащее разрешение перед проведением любых расследований.

Помните: С большой силой приходит большая ответственность. Используйте эти инструменты мудро и этично! 🦸‍♂️

Создано с ❤️ для сообщества OSINT