SkillFoxx
Telegram

MCP-сервер Yandex Search API v2

yandex-search-mcp

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

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

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

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

  • Запускает Python-сервер, который ищет по вебу и картинкам через Yandex Search API
  • Нужен ключ сервисного аккаунта Yandex Cloud, запросы тратят его квоту
Все причины и проверки
Российский стек

oleg-cat/yandex-search-mcpАвтор:oleg-cat

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/oleg-cat-yandex-search-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

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

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

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

  • Запускает Python-сервер, который ищет по вебу и картинкам через Yandex Search API
  • Нужен ключ сервисного аккаунта Yandex Cloud, запросы тратят его квоту

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

Что делает

Сервер на Python дает три типизированных инструмента: yandex_web_search для классического веб-поиска с операторами site, host, date и минус-словами, yandex_image_search с фильтрами по формату, размеру, ориентации и цвету, и yandex_gen_search для одного ИИ-ответа со ссылками на источники. Поддерживаются все шесть индексов Яндекса: ru, com, tr, kk, be, uz. Автор написал сервер с нуля взамен официального yandex/yandex-search-mcp-server, который называет демкой под турецкий рынок с хрупким XML-парсингом и хаком json.loads на генеративном поиске. Здесь XML парсится defusedxml против живых фикстур API, есть повторы с экспоненциальной задержкой на 429 и 5xx и юнит-контракт ошибок, а API-ключ по тестам никогда не попадает в логи.

Для кого. Для разработчиков, которым нужен надежный и типизированный доступ к поиску Яндекса, включая ИИ-ответ с источниками, из Claude Code, Codex или opencode.

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

  • Нужен официальный Yandex Search API v2, а не скрапинг выдачи
  • Нужен генеративный поиск с явными ссылками на источники, а не только список документов
  • Работаете с русскоязычным поиском и нужны все шесть индексов Яндекса

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

  • Нет сервисного аккаунта Yandex Cloud: без API-ключа и Folder ID сервер не запустится
  • Нужен мгновенный ответ от генеративного поиска: квота 1 запрос в секунду, а ответы занимают десятки секунд

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

Найди свежие новости про закон о такси за последние две недели и дай короткий ответ со ссылками на источники

MCP

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

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

YANDEX_SEARCH_API_KEY обязательная, секрет
Api-Key сервисного аккаунта Yandex Cloud со scope yc.search-api.execute
YANDEX_FOLDER_ID обязательная
ID папки Yandex Cloud с ролью search-api.webSearch.user
YANDEX_MCP_ENABLED_TOOLS
Список разрешенных инструментов через пробел, по умолчанию все

Ограничения

Пакет не публикуется в PyPI, устанавливается клонированием и pip install -e. Квоты по умолчанию: 10 RPS и 10000 в час для веб- и картиночного поиска, 1 RPS и 1000 в час для генеративного поиска, сервер их не обходит, только повторяет запрос при 429 и 5xx. Нужен ключ сервисного аккаунта Yandex Cloud со scope yc.search-api.execute и ролью search-api.webSearch.user.

Как отключить. Удалите сервер командой claude mcp remove yandex-search или codex mcp remove yandex-search, либо уберите запись из конфигурации.

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

Чем это лучше официального сервера Яндекса?

Автор указывает на регион только tr/en у официального сервера, хрупкий XML-парсинг регулярками и несуществующий пин зависимости; здесь парсер проверен против живых фикстур и поддержаны все 6 индексов.

Почему генеративный поиск такой медленный?

Квота 1 запрос в секунду, а сам ответ формируется десятки секунд, таймаут по умолчанию 120 секунд.

Обсуждение

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

Яндекс Поиск — все инструменты

MCP-сервер Yandex Search API v2 по HTTP

Yandex Search API MCP server, StreamableHTTP build

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

Форк официального сервера Яндекса с добавленным HTTP-транспортом и полным набором типов поиска: веб, генеративный, картинки

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

MCP-сервер на Python для поиска изображений в индексе Яндекс Картинок через Yandex Search API

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

Форк официального сервера Яндекса с отложенным async-поиском по умолчанию, который экономит до 94% на тарифе Search API

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

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

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

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

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

Коротко о README

README подробно объясняет отличия от официального сервера Яндекса, дает получение ключа и Folder ID в Yandex Cloud, установку через venv, конфиги для Claude Code, Codex CLI, opencode и Docker, полные таблицы параметров для всех трех инструментов, таблицу квот и раздел troubleshooting с типичными ошибками авторизации и лимитов.

Бейдж для README

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