clearfront — MCP-сервер для Claude Code: OSINT-разведка
Отдаёт агенту 30 инструментов OSINT: проверка email, доменов, IP и утечек. Работает локально, данные уходят только в выбранные вами API.
claude mcp add clearfront -e HIBP_API_KEY=<HIBP_API_KEY> -e IPINFO_TOKEN=<IPINFO_TOKEN> -e SHODAN_API_KEY=<SHODAN_API_KEY> -e VIRUSTOTAL_API_KEY=<VIRUSTOTAL_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx clearfrontЧто делает clearfront
clearfront — MCP-сервер для разведки по открытым источникам. Агенту достаточно передать email, ник, домен, IP или имя человека, и он запускает проверку по публичным базам, а затем собирает отчёт и граф связей между найденными фактами.
Внутри 30 инструментов: перебор аккаунтов по email и нику, поиск поддоменов через certificate transparency, восстановление старых URL из Wayback Machine, проверка утечек, WHOIS, метаданные EXIF с GPS, Shodan, VirusTotal, Censys, AbuseIPDB, GitHub на утечки секретов, генерация и живой поиск дорков. Результаты приходят из реальных вызовов бинарников, а не из модели. Часть инструментов опирается на внешние программы в PATH: holehe, sherlock, sublist3r, phoneinfoga, theHarvester. Если какой-то из них не установлен, соответствующий инструмент вернёт ошибку, остальные продолжат работать.
Ключи хранятся в .env в корне проекта, python-dotenv подхватывает их при старте. Для самого агента нужен ANTHROPIC_API_KEY либо локальная Ollama, либо любой OpenAI-совместимый endpoint. Ключи для HIBP_API_KEY, SHODAN_API_KEY, VIRUSTOTAL_API_KEY и остальных сервисов необязательны, но без них часть инструментов не заработает. Инструмент рассчитан на легальную и авторизованную проверку — за соблюдение законов отвечает пользователь.
Какие задачи решает
- проверить, какие аккаунты привязаны к рабочему email
- найти поддомены домена через certificate transparency
- посмотреть, светился ли IP в атаках и утечках
- вытащить GPS-координаты из метаданных фотографии
- собрать граф связей по найденным данным
Примеры запросов агенту
- Прогони OSINT-проверку по адресу
[email protected]и покажи отчёт - Найди поддомены домена
example.comи проверь их в Shodan - Проверь ник
someuserпо публичным площадкам и собери граф связей
Как установить clearfront
Командой платформы
claude mcp add clearfront -e HIBP_API_KEY=<HIBP_API_KEY> -e IPINFO_TOKEN=<IPINFO_TOKEN> -e SHODAN_API_KEY=<SHODAN_API_KEY> -e VIRUSTOTAL_API_KEY=<VIRUSTOTAL_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx clearfrontВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from clearfront <команда>
Командой платформы
codex mcp add clearfront --env HIBP_API_KEY=<HIBP_API_KEY> --env IPINFO_TOKEN=<IPINFO_TOKEN> --env SHODAN_API_KEY=<SHODAN_API_KEY> --env VIRUSTOTAL_API_KEY=<VIRUSTOTAL_API_KEY> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx clearfrontВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from clearfront <команда>
Файл настроек
{
"mcpServers": {
"clearfront": {
"command": "uvx",
"args": [
"clearfront"
],
"env": {
"HIBP_API_KEY": "<HIBP_API_KEY>",
"IPINFO_TOKEN": "<IPINFO_TOKEN>",
"SHODAN_API_KEY": "<SHODAN_API_KEY>",
"VIRUSTOTAL_API_KEY": "<VIRUSTOTAL_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from clearfront <команда>
Файл настроек
{
"servers": {
"clearfront": {
"type": "stdio",
"command": "uvx",
"args": [
"clearfront"
],
"env": {
"HIBP_API_KEY": "<HIBP_API_KEY>",
"IPINFO_TOKEN": "<IPINFO_TOKEN>",
"SHODAN_API_KEY": "<SHODAN_API_KEY>",
"VIRUSTOTAL_API_KEY": "<VIRUSTOTAL_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from clearfront <команда>
Командой платформы
gemini mcp add -e HIBP_API_KEY=<HIBP_API_KEY> -e IPINFO_TOKEN=<IPINFO_TOKEN> -e SHODAN_API_KEY=<SHODAN_API_KEY> -e VIRUSTOTAL_API_KEY=<VIRUSTOTAL_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> clearfront uvx clearfrontВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from clearfront <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о clearfront
Как установить clearfront в Claude Code?
Добавьте сервер командой `claude mcp add clearfront -e HIBP_API_KEY=<HIBP_API_KEY> -e IPINFO_TOKEN=<IPINFO_TOKEN> -e SHODAN_API_KEY=<SHODAN_API_KEY> -e VIRUSTOTAL_API_KEY=<VIRUSTOTAL_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx clearfront`. Ключи подставьте свои.
Что делает clearfront?
Это MCP-сервер для разведки по открытым источникам. Он принимает email, ник, домен, IP или имя и прогоняет их через 30 инструментов, после чего отдаёт отчёт и граф связей.
Что нужно для работы clearfront?
Python 3.10+ и ключ для одного из бэкендов: Anthropic, локальная Ollama или OpenAI-совместимый endpoint. Часть инструментов требует внешних бинарников в PATH и ключей к сервисам вроде Shodan или VirusTotal.
