# clearfront

Отдаёт агенту 30 инструментов OSINT: проверка email, доменов, IP и утечек. Работает локально, данные уходят только в выбранные вами API.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Автор: scottmartinanderson
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/scottmartinanderson/clearfront
- Обновлён: 2026-08-26
- HTML: https://affpapa.org/nevibecode/mcp/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` и остальных сервисов необязательны, но без них часть инструментов не заработает. Инструмент рассчитан на легальную и авторизованную проверку — за соблюдение законов отвечает пользователь.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `HIBP_API_KEY`, `IPINFO_TOKEN`, `SHODAN_API_KEY`, `VIRUSTOTAL_API_KEY`, `ANTHROPIC_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 <команда>

## Когда брать
- проверить, какие аккаунты привязаны к рабочему email
- найти поддомены домена через certificate transparency
- посмотреть, светился ли IP в атаках и утечках
- вытащить GPS-координаты из метаданных фотографии
- собрать граф связей по найденным данным

## Примеры запросов агенту
- Прогони OSINT-проверку по адресу `target@example.com` и покажи отчёт
- Найди поддомены домена `example.com` и проверь их в Shodan
- Проверь ник `someuser` по публичным площадкам и собери граф связей

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12109

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md