Что агент находит через Яндекс
Без поиска модель отвечает по данным обучения с датой отсечки. Сервер поиска подставляет в контекст сегодняшние страницы, и агент цитирует их со ссылками.
- Веб, картинки и ИИ-ответ. MCP-сервер Yandex Search API v2 дает 3 типизированных инструмента с операторами
site,hostиdateи работает со всеми 6 индексами: ru, com, tr, kk, be и uz. При ответах 429 и 5xx он повторяет запрос с растущей паузой. - Поиск и спрос в одном пакете. MCP Yandex Search.API с Wordstat добавляет к трем видам поиска 4 метода Вордстата. @scom82/yandex-search-mcp кеширует Вордстат на 30 дней, выдачу на 1 день и переводит ответ из XML в чистый JSON.
- Плагин для Claude Code. Поиск по рунету через Yandex Search API ставит скилл
ru-web-searchи агентаru-web-searcherна модели Haiku. Агент включается сам, когда вопрос задан по-русски или касается доменов .ru. - Экономия на тарифе. MCP Yandex Search API с отложенным поиском по умолчанию отправляет запросы в отложенном режиме и хранит идентификаторы операций в SQLite, так что результат можно забрать после перезапуска.
- Поиск в закрытом контуре. MCP-сервер поиска Яндекса с офлайн-установкой поставляется сборками на 21 и 330 МБ и Dockerfile под Astra Linux.
- SEO по данным Яндекса. yaseo ставит набор SEO-скиллов и строит план правок сайта. Перед каждым платным запросом он называет число обращений и ждет подтверждения.
Как получить ключ Yandex Search API
Начинают с организации, облака и каталога в Yandex Cloud и платежного аккаунта. API-ключ создают в интерфейсе AI Studio, вместе с ним появляется сервисный аккаунт. Документация называет для поисковых запросов роль search-api.webSearch.user, а роли search-api.executor и search-api.editor считает устаревшими. Область действия ключа yc.search-api.execute, рядом понадобится идентификатор каталога folderId.
Запросы идут по REST или gRPC в синхронном или отложенном режиме. Синхронный ответ приходит сразу, отложенный рассчитан на пакетную обработку. По описаниям серверов он в разы дешевле, особенно ночью.
У Яндекса есть свой сервер yandex/yandex-search-mcp-server с инструментами ai_search_post и web_search_post и удаленным адресом для подключения по заголовкам ApiKey и FolderId. В каталоге его карточки пока нет, зато есть форки с HTTP-транспортом и отложенным режимом.
npx skillfoxx add mcp/oleg-cat-yandex-search-mcp
Официальный API или разбор выдачи
Серверы на Search API только читают публичные результаты, у них минимальный уровень доступа, и VPN им не нужен. Альтернативы обходятся без ключа Yandex Cloud, но платят за это стабильностью или правилами Яндекса.
MCP-сервер поиска Яндекса через браузер ходит в Яндекс через Playwright с cookies вашего аккаунта и режимом скрытности, и аккаунт рискует блокировкой. MCP чистого поиска по Яндексу, Bing и DuckDuckGo разбирает HTML-страницу выдачи. Любая смена верстки ломает такой парсер. Скиллы на Apify и серверы xmlriver-mcp и MCP-сервер поиска Яндекса и Google отдают выдачу через сторонние платные сервисы.
Деньги, ключи и логи
Запросы к Search API оплачиваются по тарифу с платежного аккаунта Yandex Cloud. Поставьте в облаке бюджет с уведомлением до того, как агент начнет массовый прогон. Квоты по умолчанию, по описанию одного из серверов, 10 запросов в секунду для веб-поиска и 1 запрос в секунду для генеративного ответа.
Ключ храните в переменных окружения клиента. Сервер на .NET пишет запросы и начало ответов в файл рядом с бинарником. Saymon RU Data API берет оплату в USDC с подключенного кошелька при любом обращении и подтверждения у человека не спрашивает.
Для частотности запросов загляните в раздел Вордстат, для ключей и ролей облака в Yandex Cloud.