Yandex Search MCP Server
Официальный MCP-сервер Яндекса для веб-поиска через Yandex Search API: ответы со ссылками на источники и генеративный ответ
Установка
{
"mcpServers": {
"yandexSearch": {
"type": "sse",
"url": "https://d5de9siimt9bkld7viic.emzafcgx.apigw.yandexcloud.net:3000/sse",
"headers": {
"ApiKey": "<your_api_key>",
"FolderId": "<your_folder_id>"
}
}
}
}Тот же блок подходит для VS Code в .vscode/mcp.json.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту два инструмента: веб-поиск в реальном времени с источниками и поиск с генеративным ответом, который собирает модель Яндекса по результатам выдачи. Подключиться можно к удаленному серверу Яндекса по SSE, передав API-ключ и ID каталога в заголовках, или запустить сервер локально через Docker, Podman или Python. Для работы нужен аккаунт в Yandex Search API и сервисный аккаунт с нужной ролью.
Для кого. Для разработчиков и исследователей, которым нужен свежий поиск по русскоязычному интернету в агенте.
Подходит, если
- Нужны актуальные данные из интернета, особенно по российским источникам
- Нужен короткий ответ со ссылками вместо списка страниц
- Нельзя пользоваться западными поисковыми API
Не подходит, если
- Нет платежного аккаунта в Yandex Cloud
- Нужен поиск по закрытым документам компании
Пример запроса к агенту
Найди через yandexSearch последние изменения в правилах маркировки товаров и дай ссылки на источникиОграничения
Search API платный, нужен API-ключ со scope yc.search-api.execute и роль search-api.editor у сервисного аккаунта. Удаленный сервер работает по SSE, клиентам без поддержки SSE нужен mcp-remote. Названия инструментов в разных разделах README расходятся. Последнее обновление в марте 2026, новые серверы Яндекс развивает в репозитории yandex-cloud/mcp.
Как отключить. Удалите блок yandexSearch из конфигурации MCP клиента и отзовите API-ключ в консоли Yandex Cloud.
MCP
- Транспорт
- sse
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| SEARCH_API_KEY обязательная, секрет | API-ключ Yandex Search API для локального запуска |
| FOLDER_ID обязательная | ID каталога Yandex Cloud |
Проверка безопасности
- Запросы отправляются в платный облачный API
- Требует API-ключ сервисного аккаунта
Коротко о README
README на английском описывает два инструмента поиска и порядок получения API-ключа и ID каталога. Рекомендуемый способ это удаленный сервер: даны пошаговые инструкции для Claude Desktop через mcp-remote, для Cursor и VS Code с типом sse. Для локального запуска описаны сборка контейнера в Docker или Podman и запуск на Python, приведены примеры запросов и советы по устранению проблем.
Частые вопросы
Чем отличается от поиска в yandex-cloud/mcp?
Это более ранний отдельный сервер. В наборе Yandex Cloud поиск ставится через npm-пакет с OAuth-авторизацией.
Можно ли запустить без удаленного сервера?
Да, README описывает сборку Docker-образа и запуск server.py на Python с переменными SEARCH_API_KEY и FOLDER_ID.
Похожие
CLI, скилл и Python-библиотека для управления браузером: агент кликает, заполняет формы и читает страницы через CDP
Скилл собирает обсуждения темы за последние 30 дней из Reddit, X, YouTube, HN, Polymarket и GitHub и сводит их в бриф
Официальный MCP-сервер команды Chrome DevTools: агент управляет живым Chrome, смотрит сеть, консоль и записывает трейсы производительности
Быстрый CLI на Rust для автоматизации браузера агентами: снимки доступности со ссылками на элементы, MCP-сервер и скиллы