MCP-сервер поиска Яндекса на TypeScript

yandex-search-mcp

MCP-сервер на TypeScript для Yandex Search API с собственным парсером результатов и тестами

  • 0 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Запускает Node-сервер, который ходит в Yandex Search API по ключу сервисного аккаунта
  • Только выполняет поисковые запросы, изменяющих вызовов нет
Все причины и проверки
Российский стек

nikolayxhd/yandex-search-mcp

Установка

Работает в

Ручная установка

git clone https://github.com/nikolayxhd/yandex-search-mcp.git
cd yandex-search-mcp
npm install

Установка зависимостей перед подключением к MCP-клиенту.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Запускает Node-сервер, который ходит в Yandex Search API по ключу сервисного аккаунта
  • Только выполняет поисковые запросы, изменяющих вызовов нет

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер на Node.js и TypeScript ходит в Yandex Search API по ключу сервисного аккаунта и Folder ID Yandex Cloud, разбирает XML-ответ своим парсером и отдает структурированный результат агенту. В репозитории отдельно вынесены модули парсера, клиента API и debug-скрипты для проверки запроса и парсинга без MCP-обвязки, плюс jest-тесты на утилиты HTML и парсер. README очень краткий: только ссылки на документацию Яндекс Cloud и пример JSON-конфига для MCP-клиента.

Для кого. Для разработчиков, которым нужен легкий TypeScript-сервер поиска Яндекса и которые готовы разобраться в конфигурации по примеру без развернутой документации.

Подходит, если

  • Нужен простой сервер поиска Яндекса на Node.js без лишних зависимостей
  • Устраивает минимальная документация, а конфигурация ясна из примера в README
  • Хотите готовый парсер XML-ответа Yandex Search API с тестами вместо своего

Не подходит, если

  • Нужна подробная документация с описанием инструментов и параметров
  • Важна активная поддержка: последний пуш был больше года назад

Пример запроса к агенту

Найди в Яндексе последние новости о запуске нового ЖК в этом районе

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

YANDEX_API_KEY обязательная, секрет
API-ключ сервисного аккаунта Yandex Cloud
YANDEX_FOLDER_ID обязательная
ID каталога Yandex Cloud

Ограничения

Последний пуш был больше года назад, автор не отвечал на изменения в API с тех пор. README не описывает набор инструментов и их параметры, разбираться приходится по исходникам src/index.ts и src/yandex_search_api.ts. Нужен ключ сервисного аккаунта и Folder ID Yandex Cloud. Лицензии в репозитории нет.

Как отключить. Удалите блок yandex-search-mcp из конфигурации MCP-клиента.

Частые вопросы

Активно ли поддерживается проект?

Нет, последний пуш был более года назад, README тоже с тех пор не обновлялся.

Есть ли тесты?

Да, в каталоге test/ есть проверки парсера и HTML-утилит, а в debug/ отдельные скрипты для ручной проверки API и парсинга.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Self-hosted MCP для Yandex Search API v2: веб, картинки и генеративный поиск по всем шести индексам Яндекса

MCP-серверРасширенный доступ4Звезды репозитория
Российский стек

MCP-сервер поиска Яндекса на .NET 10 с нативной AOT-сборкой, конвертацией страниц в Markdown и поиском по regex

MCP-серверРасширенный доступ
Официальный

Официальный MCP-сервер Яндекса для веб-поиска через Yandex Search API: ответы со ссылками на источники и генеративный ответ

MCP-серверРасширенный доступ47Звезды репозитория
Российский стек

MCP-сервер веб-поиска и извлечения контента через Яндекс и Google на базе SerpAPI, с прицелом на результаты для России и СНГ

MCP-серверРасширенный доступ1Звезды репозитория

MCP Yandex Search.API с Wordstat

Yandex Search.API MCP Server

Российский стек

MCP-сервер официального Search.API Яндекса: веб, картинки, генеративный поиск и четыре инструмента Wordstat в одном пакете npm

MCP-серверРасширенный доступ1Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
MCP-сервер поиска Яндекса на TypeScript (эта карточка)нетAPI-ключ0
MCP-сервер поиска Яндекса через браузернетне нужна4ищет в Яндексе через браузер с cookies
MCP-сервер поиска Яндекса и Googleнетне нужна1поиск через Яндекс и Google на SerpAPI
MCP поиска Яндекса на .NET с AOT-компиляциейнетAPI-ключ0на .NET с нативной AOT-сборкой

Коротко о README

README состоит из трех ссылок на документацию Yandex Cloud по Search API, IAM-ключам и Folder ID, и одного примера JSON-конфига MCP-сервера с путем к src/index.ts и переменными YANDEX_API_KEY, YANDEX_FOLDER_ID. Описания инструментов и параметров README не дает.

Бейдж для README

Сообщить о проблеме