Яндекс Поиск и Вордстат MCP: web_search и частоты фраз
mcp-yandex-search
MCP-сервер на одном ключе AI Studio: четыре метода Вордстата, поиск по индексу Яндекса и сырой запрос к Wordstat API
- 0 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Сервер только читает статистику и выдачу, но каждый вызов тарифицируется Яндексом и расходует общую квоту ключа
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-yandex-searchОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Сервер только читает статистику и выдачу, но каждый вызов тарифицируется Яндексом и расходует общую квоту ключа
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер на Node.js ходит в Yandex Search API по одному ключу из AI Studio (`YANDEX_API_KEY`) и дает шесть инструментов: `wordstat_get_top` (топ и похожие запросы за 30 дней), `wordstat_get_dynamics`, `wordstat_get_regions`, `wordstat_get_regions_tree`, `web_search` (поиск по индексу Яндекса, режимы `async`, `sync` и `auto`) и `raw_request` для любого пути Wordstat API. Стандартный транспорт stdio, переменная `MCP_TRANSPORT=http` включает HTTP на порту 3100 с проверкой `/health`. Повторы при 429, 5xx и таймаутах учитывают `Retry-After`, дерево регионов кешируется, телеметрии нет. Запуск: `npx -y mcp-yandex-search`.
Для кого. SEO-специалистам, контент-маркетологам и редакторам, которым нужны и частоты фраз, и выдача Яндекса в одном подключении.
Подходит, если
- Сначала надо проверить спрос по фразе, затем посмотреть, что Яндекс показывает по ней в выдаче
- Нужен метод Wordstat API, которого нет среди готовых инструментов, и поможет `raw_request`
- Сервер должен работать для нескольких пользователей по HTTP, а не локально
- Не хочется заводить отдельный ключ под Вордстат и отдельный под поиск
Не подходит, если
- Нужны Метрика, Вебмастер или Директ: сервер покрывает только Вордстат и поиск
- Нужна обработка тысяч фраз: квота Search API общая на ключ, а на каждую фразу уходит один вызов
- Нужны параллельные вызовы без очереди: отложенный поиск ждет операцию до десяти минут
Пример запроса к агенту
Сравни частоту фраз «ипотека на новостройку» и «ипотека на вторичку» по месяцам и покажи, что Яндекс выдает по первойMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
YANDEX_API_KEYобязательная, секрет- API-ключ Yandex Search API из AI Studio
YANDEX_FOLDER_ID- Идентификатор каталога Yandex Cloud, ключам AI Studio не нужен
MCP_TRANSPORT- Транспорт: stdio или http
Ограничения
Нужен ключ Yandex Search API с ролью `search-api.webSearch.user`, а для ключей не из AI Studio еще и `YANDEX_FOLDER_ID`. Квота общая на ключ, один вызов равен одной фразе. Частоты Вордстата считаются за последние 30 дней, даты принимает только `wordstat_get_dynamics`. Отложенный `web_search` по умолчанию ждет операцию до 600 секунд. При ошибках 401 и 403 проверяют доступ к Search API и каталог. Проект маленький: ноль звезд, последний коммит в октябре 2026 года, лицензия MIT, тесты идут без сети.
Как отключить. Удалите сервер из настроек клиента, отзовите ключ `YANDEX_API_KEY` в кабинете Yandex Cloud.
Частые вопросы
Какие инструменты есть?
Шесть: четыре метода Вордстата, `web_search` для поиска по индексу Яндекса и `raw_request` для произвольного пути Wordstat API.
Где взять ключ?
В AI Studio: сервисный аккаунт с ролью `search-api.webSearch.user` создается вместе с ключом.
Как включить HTTP вместо stdio?
Задать `MCP_TRANSPORT=http`; порт по умолчанию 3100, проверка живости по адресу `/health`.
Что делает `raw_request`?
Отправляет POST на любой относительный путь Wordstat API с вашим телом запроса, если нужного метода нет среди готовых инструментов.
Отправляет ли сервер статистику использования?
Нет, телеметрии в нем нет.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер для Яндекс Вордстата через официальный Yandex Cloud Search API: частотность, похожие запросы, динамика и регионы
MCP-сервер Yandex Cloud Search API v2: Вордстат и веб-поиск с файловым кешем, нормализацией дат и устойчивостью к 429
MCP-сервер Вордстата от khanton
Yandex Wordstat MCP Server
Компактный MCP-сервер на TypeScript для Яндекс Вордстата через Yandex Search API: топ запросов, динамика и регионы
MCP Yandex Search.API с Wordstat
Yandex Search.API MCP Server
MCP-сервер официального Search.API Яндекса: веб, картинки, генеративный поиск и четыре инструмента Wordstat в одном пакете npm
MCP-сервер к Яндекс Вордстату через Yandex Cloud Search API: частотность, динамика, регионы и построитель фраз с операторами
MCP-сервер Вордстата через Yandex Cloud Search API: частотность и похожие запросы, сезонность, спрос по регионам и устройствам
Коротко о README
README коротко описывает быстрый старт с ключом AI Studio, примеры конфигурации для Claude Desktop, Cursor и opencode, таблицу из шести инструментов с параметрами, переменные окружения и поведение сервера при ошибках и повторах.