@scom82/yandex-search-mcp
MCP-сервер Yandex Cloud Search API v2: Вордстат и веб-поиск с файловым кешем, нормализацией дат и устойчивостью к 429
- 0 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер вызывает Wordstat и веб-поиск через Yandex Cloud по ключу сервисного аккаунта
- Запросы платные, синхронный поиск дороже асинхронного, данные только читаются
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/scom82-yandex-search-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер вызывает Wordstat и веб-поиск через Yandex Cloud по ключу сервисного аккаунта
- Запросы платные, синхронный поиск дороже асинхронного, данные только читаются
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер закрывает пять инструментов: четыре метода Wordstat (топ похожих фраз с ассоциациями, динамика по датам, распределение по регионам с affinity-индексом, бесплатное дерево регионов) и websearch_query, поиск Яндекса с синхронным и вдвое-в-шестнадцать-раз более дешевым асинхронным режимом. Сервер сам решает мелкие неудобства API: числа int64 приходят строками и парсятся в числа, обычные ISO-даты автоматически выравниваются под границы периода Вордстата, короткие значения вроде monthly или desktop дополняются нужным префиксом enum, а результаты веб-поиска декодируются из base64 в чистый JSON вместо XML с тегами подсветки. Ответы кешируются в файл на 30 дней для Вордстата и на 1 день для веб-поиска.
Для кого. Для разработчиков, которым нужен надежный слой поверх Yandex Cloud Search API с кешем и защитой от типичных ошибок формата.
Подходит, если
- Нужны и Вордстат, и веб-поиск Яндекса в одном сервере
- Важно не тратить деньги на повторные одинаковые запросы: есть файловый кеш
- Нужна дешевая пакетная обработка веб-поиска: есть асинхронный режим
Не подходит, если
- Устраивает старый форк yandex-mcp с методами api.wordstat.yandex.net: тот хост Яндекс отключил, отсюда и появился этот сервер
- Не нужен веб-поиск, а нужен только Вордстат без кеша и нормализации
Пример запроса к агенту
Найди топ похожих запросов к фразе «доставка цветов» и покажи, кто занимает выдачу Яндекса по этому запросуMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
YC_SEARCH_API_KEYобязательная, секрет- Ключ сервисного аккаунта Yandex Cloud.
YC_FOLDER_IDобязательная- ID каталога, добавляется в тело каждого запроса.
Ограничения
Нужны YC_SEARCH_API_KEY и YC_FOLDER_ID сервисного аккаунта с ролью search-api.webSearch.user. Синхронный веб-поиск стоит около 488 рублей за 1000 запросов, асинхронный, около 30.5 рубля. Планируемая функция Generative Search вынесена в отдельный будущий этап (Phase 2) и в этой версии не реализована. Пакет не опубликован в PyPI/npm registry с отдельным README, лицензия MIT.
Как отключить. Удалите запись yandex-search из .mcp.json или выполните claude mcp remove yandex-search.
Частые вопросы
Почему у старого yandex-mcp сломались инструменты wordstat_*?
Яндекс отключил отдельный хост api.wordstat.yandex.net, поэтому этот сервер переехал на Yandex Cloud Search API v2 с теми же именами инструментов.
Асинхронный веб-поиск отдает результат сразу?
Нет, нужно опрашивать /operations/{id}, зато он примерно в 16 раз дешевле синхронного.
Обсуждение
Вопросов и отзывов пока нет.
Яндекс Поиск и Вордстат MCP: web_search и частоты фраз
mcp-yandex-search
MCP-сервер на одном ключе AI Studio: четыре метода Вордстата, поиск по индексу Яндекса и сырой запрос к Wordstat API
MCP-сервер Вордстата через Yandex Cloud Search API: частотность и похожие запросы, сезонность, спрос по регионам и устройствам
MCP-сервер для Яндекс Вордстата через официальный Yandex Cloud Search API: частотность, похожие запросы, динамика и регионы
MCP Yandex Search.API с Wordstat
Yandex Search.API MCP Server
MCP-сервер официального Search.API Яндекса: веб, картинки, генеративный поиск и четыре инструмента Wordstat в одном пакете npm
MCP-сервер Вордстата от khanton
Yandex Wordstat MCP Server
Компактный MCP-сервер на TypeScript для Яндекс Вордстата через Yandex Search API: топ запросов, динамика и регионы
MCP-сервер к Яндекс Вордстату через Yandex Cloud Search API: частотность, динамика, регионы и построитель фраз с операторами
Коротко о README
README объясняет предысторию, замену отключенного хоста Вордстата, дает таблицу пяти инструментов, подробно описывает автоматические доработки формата (int64, даты, enum-префиксы, декодирование base64), таблицу переменных окружения и инструкцию по получению сервисного ключа в консоли Yandex Cloud.