Поисковый шлюз SerpentSeek с 39 провайдерами
SerpentSeek
Самостоятельно размещаемый поисковый шлюз на Go с MCP-инструментом поиска: 39 провайдеров, включая официальный Yandex Search API v2
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Запросы идут под платными ключами того, кто развернул сервис, и расход средств лежит на нем
- Админ-панель дает доступ к ключам провайдеров и истории всех запросов
Установка
Ручная установка
cp .env.example .env && docker compose up --buildБыстрый старт из README, UI поднимается на localhost:8080, провайдеры настраиваются после входа в админку.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
SerpentSeek это единый шлюз для 39 встроенных поисковых провайдеров: SearXNG, Brave, Google Vertex AI Search, Yandex, SerpApi, DataForSEO, Exa, Tavily, Kagi, Perplexity и другие, с визуальным редактором цепочек фолбэка между провайдерами. Яндекс подключен как драйвер yandex с ключом и folder_id по официальному эндпоинту /v2/web/search, а генеративный ответ YandexGPT доступен отдельным драйвером yandex_gen через /v2/gen/search на узле типа answer. Сервер отдает единственный MCP-инструмент search по streamable HTTP с авторизацией Bearer-токеном, поддерживает stdio-обертку через mcp-remote для клиентов без HTTP-транспорта, ведет историю запросов с живой трассировкой по SSE и хранит данные в SQLite или PostgreSQL. Все запросы идут под ключами того, кто развернул сервис, и оплачиваются им же.
Для кого. Для команд, которым нужен один самостоятельно размещаемый поисковый шлюз с фолбэком между провайдерами, включая официальный поиск Яндекса, для Open WebUI и MCP-клиентов.
Подходит, если
- Нужен фолбэк между несколькими поисковыми провайдерами, включая Яндекс, в одной цепочке
- Нужен и /search эндпоинт для Open WebUI, и MCP-инструмент для Claude, Cursor, VS Code одновременно
- Важны аудит запросов, ключи API и WebAuthn-passkeys для админ-панели
Не подходит, если
- Нужен только Яндекс без остальных 38 провайдеров: проще взять специализированный Yandex Search API MCP-сервер
- Не хочется разворачивать и администрировать отдельный сервис: SerpentSeek это полноценное приложение с базой данных и веб-панелью
Пример запроса к агенту
Найди по Яндексу свежие материалы про новый закон и дай краткий сгенерированный ответ со ссылкамиОграничения
Yandex Search API платный, нужны api_key и folder_id Yandex Cloud, настроенные на странице провайдеров после первого запуска. Passkeys требуют HTTPS и домен, по HTTP или голому IP доступны только API-ключи. SearXNG не входит в поставку и разворачивается отдельно под лицензией AGPLv3. Все расходы по провайдерам ложатся на того, кто развернул сервис, авторы проекта не несут ответственности за них.
Как отключить. Остановите docker compose down и удалите MCP-сервер serpentseek из клиента.
MCP
- Транспорт
- http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| GOOGLE_API_KEY секрет | Ключ для дефолтного провайдера google_vertex, создаваемого при первом запуске |
| SEARXNG_URL | Адрес внешнего инстанса SearXNG, если используется этот провайдер |
Проверка безопасности
- Запросы идут под платными ключами того, кто развернул сервис, и расход средств лежит на нем
- Админ-панель дает доступ к ключам провайдеров и истории всех запросов
Коротко о README
README перечисляет все 39 провайдеров по категориям (web/SERP, ИИ-поиск, академические, корпоративные, генеративные узлы) с полями учетных данных, показывает быстрый старт через docker compose, интеграцию с Open WebUI и MCP, настройку PostgreSQL, аутентификацию через API-ключи и passkeys, фоновые задачи очистки и раздел рисков про платность провайдеров и ответственность за расходы.
Частые вопросы
Можно ли использовать сразу несколько провайдеров с фолбэком?
Да, визуальный редактор цепочек позволяет выстроить порядок провайдеров, включая несколько экземпляров одного драйвера с разными ключами.
Нужен ли отдельный ключ для генеративного ответа Яндекса?
Да, драйвер yandex_gen использует свой api_key и folder_id на узле типа answer.
Похожие
CLI, скилл и Python-библиотека для управления браузером: агент кликает, заполняет формы и читает страницы через CDP
Скилл собирает обсуждения темы за последние 30 дней из Reddit, X, YouTube, HN, Polymarket и GitHub и сводит их в бриф
Официальный MCP-сервер команды Chrome DevTools: агент управляет живым Chrome, смотрит сеть, консоль и записывает трейсы производительности
Быстрый CLI на Rust для автоматизации браузера агентами: снимки доступности со ссылками на элементы, MCP-сервер и скиллы