MCP поиска картинок Яндекса

mcp-yandex-search-api

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

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

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

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

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

gennadynemchin/mcp-yandex-search-api

Установка

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

npx skillfoxx add mcp/mcp-yandex-search-api

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

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

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

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

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

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

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

Что делает

Сервер дает один инструмент search_images, который ищет изображения по текстовому запросу в индексе Яндекс Картинок и поддерживает все параметры Yandex Search API: тип поиска, семейный фильтр, исправление опечаток, формат, размер, ориентацию, цвет, ограничение по сайту, user agent, номер страницы и число результатов на странице. XML-ответ API автоматически парсится в JSON со ссылками на оригинал изображения, превью и страницу-источник, либо можно запросить сырой XML параметром return_raw_xml. Авторизация идет по API-ключу сервисного аккаунта или IAM-токену.

Для кого. Для тех, кому нужен агентский поиск изображений именно в индексе Яндекса, а не Google или Bing.

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

  • Нужно найти изображения по теме с фильтрами по размеру, цвету или ориентации
  • Нужен поиск картинок в пределах конкретного сайта
  • Работаете в VS Code, Cursor или другом MCP-клиенте и хотите готовый парсинг XML в JSON

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

  • Нужен веб-поиск по тексту, а не поиск изображений: сервер дает только search_images
  • Нет платежного аккаунта Yandex Cloud с ролью search-api.webSearch.user

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

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

MCP

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

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

YANDEX_FOLDER_ID обязательная
ID каталога Yandex Cloud
YANDEX_API_KEY секрет
API-ключ сервисного аккаунта, рекомендуемый способ
YANDEX_IAM_TOKEN секрет
IAM-токен как альтернатива API-ключу

Ограничения

Только поиск изображений, веб-поиска или других видов поиска Яндекса сервер не дает. Нужен сервисный аккаунт Yandex Cloud с ролью search-api.webSearch.user и API-ключом со скоупом yc.search-api.execute. Требует Python 3.10 и менеджер пакетов uv.

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

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

Можно ли искать текст, а не картинки?

Нет, сервер дает только инструмент search_images для поиска изображений в Яндекс Картинках.

Можно ли получить сырой ответ API вместо JSON?

Да, параметр return_raw_xml=true возвращает исходный XML-ответ Yandex Search API.

Чем этот MCP отличается от других серверов Yandex Search API?

Сервер на Python дает один инструмент search_images: поиск изображений по текстовому запросу в индексе Яндекс Картинок. Поддерживаются все параметры Yandex Search API: тип поиска, семейный фильтр, исправление запроса.

Можно ли искать текст, а не картинки, и получить сырой ответ API?

Этот сервер ищет только изображения. Для поиска по вебу берите сервер Yandex Search API с веб-инструментами. Формат вывода описан в README. Установка: git clone и uv, работает в VS Code и Cursor.

Обсуждение

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

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

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

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

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

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

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

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

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

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

MCP Yandex Search.API с Wordstat

Yandex Search.API MCP Server

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

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

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

Коротко о README

README описывает единственный инструмент search_images со всеми параметрами API, требования к Python и uv, установку сервисного аккаунта с нужной ролью, таблицу переменных окружения, локальный запуск, отладку через MCP Inspector и подключение к VS Code и Cursor с примерами конфигурации и структурой ответа.

Бейдж для README

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