MCP-сервер поиска Яндекса на TypeScript
yandex-search-mcp
MCP-сервер на TypeScript для Yandex Search API с собственным парсером результатов и тестами
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только выполняет поисковые запросы к публичному API, изменяющих вызовов нет
Установка
Ручная установка
git clone https://github.com/nikolayxhd/yandex-search-mcp.git
cd yandex-search-mcp
npm installУстановка зависимостей перед подключением к MCP-клиенту.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на Node.js и TypeScript ходит в Yandex Search API по ключу сервисного аккаунта и Folder ID Yandex Cloud, разбирает XML-ответ своим парсером и отдает структурированный результат агенту. В репозитории отдельно вынесены модули парсера, клиента API и debug-скрипты для проверки запроса и парсинга без MCP-обвязки, плюс juest-тесты на утилиты HTML и парсер. README очень краткий: только ссылки на документацию Яндекс Cloud и пример JSON-конфига для MCP-клиента.
Для кого. Для разработчиков, которым нужен легкий TypeScript-сервер поиска Яндекса и которые готовы разобраться в конфигурации по примеру без развернутой документации.
Подходит, если
- Нужен простой сервер поиска Яндекса на Node.js без лишних зависимостей
- Устраивает минимальная документация, а конфигурация ясна из примера в README
- Хотите готовый парсер XML-ответа Yandex Search API с тестами вместо своего
Не подходит, если
- Нужна подробная документация с описанием инструментов и параметров
- Важна активная поддержка: последний пуш был больше года назад
Пример запроса к агенту
Найди в Яндексе последние новости о запуске нового ЖК в этом районеОграничения
Последний пуш был больше года назад, автор не отвечал на изменения в API с тех пор. README не описывает набор инструментов и их параметры, разбираться приходится по исходникам src/index.ts и src/yandex_search_api.ts. Нужен ключ сервисного аккаунта и Folder ID Yandex Cloud. Лицензии в репозитории нет.
Как отключить. Удалите блок yandex-search-mcp из конфигурации MCP-клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YANDEX_API_KEY обязательная, секрет | API-ключ сервисного аккаунта Yandex Cloud |
| YANDEX_FOLDER_ID обязательная | ID каталога Yandex Cloud |
Проверка безопасности
- Только выполняет поисковые запросы к публичному API, изменяющих вызовов нет
Коротко о README
README состоит из трех ссылок на документацию Yandex Cloud по Search API, IAM-ключам и Folder ID, и одного примера JSON-конфига MCP-сервера с путем к src/index.ts и переменными YANDEX_API_KEY, YANDEX_FOLDER_ID. Описания инструментов и параметров README не дает.
Частые вопросы
Активно ли поддерживается проект?
Нет, последний пуш был более года назад, README тоже с тех пор не обновлялся.
Есть ли тесты?
Да, в каталоге test/ есть проверки парсера и HTML-утилит, а в debug/ отдельные скрипты для ручной проверки API и парсинга.
Похожие
CLI, скилл и Python-библиотека для управления браузером: агент кликает, заполняет формы и читает страницы через CDP
Скилл собирает обсуждения темы за последние 30 дней из Reddit, X, YouTube, HN, Polymarket и GitHub и сводит их в бриф
Официальный MCP-сервер команды Chrome DevTools: агент управляет живым Chrome, смотрит сеть, консоль и записывает трейсы производительности
Быстрый CLI на Rust для автоматизации браузера агентами: снимки доступности со ссылками на элементы, MCP-сервер и скиллы