MCP поиска картинок Яндекса
mcp-yandex-search-api
MCP-сервер на Python для поиска изображений в индексе Яндекс Картинок через Yandex Search API
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только выполняет поиск изображений по публичному индексу, изменяющих вызовов нет
Установка
Ручная установка
git clone <repo-url> mcp-yandex-search-api
cd mcp-yandex-search-api
uv syncУстановка зависимостей через uv перед запуском.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает один инструмент 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
Пример запроса к агенту
Найди крупные цветные изображения новогодней елки в городском стилеОграничения
Только поиск изображений, веб-поиска или других видов поиска Яндекса сервер не дает. Нужен сервисный аккаунт Yandex Cloud с ролью search-api.webSearch.user и API-ключом со скоупом yc.search-api.execute. Требует Python 3.10 и менеджер пакетов uv.
Как отключить. Удалите блок yandex-search-api из конфигурации MCP-клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YANDEX_FOLDER_ID обязательная | ID каталога Yandex Cloud |
| YANDEX_API_KEY секрет | API-ключ сервисного аккаунта, рекомендуемый способ |
| YANDEX_IAM_TOKEN секрет | IAM-токен как альтернатива API-ключу |
Проверка безопасности
- Только выполняет поиск изображений по публичному индексу, изменяющих вызовов нет
Коротко о README
README описывает единственный инструмент search_images со всеми параметрами API, требования к Python и uv, установку сервисного аккаунта с нужной ролью, таблицу переменных окружения, локальный запуск, отладку через MCP Inspector и подключение к VS Code и Cursor с примерами конфигурации и структурой ответа.
Частые вопросы
Можно ли искать текст, а не картинки?
Нет, сервер дает только инструмент search_images для поиска изображений в Яндекс Картинках.
Можно ли получить сырой ответ API вместо JSON?
Да, параметр return_raw_xml=true возвращает исходный XML-ответ Yandex Search API.
Похожие
CLI, скилл и Python-библиотека для управления браузером: агент кликает, заполняет формы и читает страницы через CDP
Скилл собирает обсуждения темы за последние 30 дней из Reddit, X, YouTube, HN, Polymarket и GitHub и сводит их в бриф
Официальный MCP-сервер команды Chrome DevTools: агент управляет живым Chrome, смотрит сеть, консоль и записывает трейсы производительности
Быстрый CLI на Rust для автоматизации браузера агентами: снимки доступности со ссылками на элементы, MCP-сервер и скиллы