MCP Yandex Search.API с Wordstat

Yandex Search.API MCP Server

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

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

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

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

  • Запускает npm-сервер, который вызывает Search API и Wordstat от имени сервисного аккаунта Yandex Cloud
  • Только читает выдачу и спрос, запросы тратят квоту аккаунта
Все причины и проверки
Российский стек

shufl9dka/yandex-searchapi-mcp

Установка

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

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

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

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

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

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

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

  • Запускает npm-сервер, который вызывает Search API и Wordstat от имени сервисного аккаунта Yandex Cloud
  • Только читает выдачу и спрос, запросы тратят квоту аккаунта

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

Что делает

Сервер дает семь инструментов поверх REST-эндпоинтов Search.API: web_search, image_search и generative_search используют /v2/web/search, /v2/image/search и /v2/gen/search, а wordstat_get_top, wordstat_get_dynamics, wordstat_get_regions_distribution и wordstat_get_regions_tree покрывают Wordstat REST. Веб- и картиночный поиск декодируют rawData из Base64 и разбирают XML в структурированные группы документов, веб-поиск всегда работает с форматом XML. Входные параметры инструментов минимальны по умолчанию, чтобы не раздувать контекст модели, при этом searchType доступен везде и по умолчанию SEARCH_TYPE_COM.

Для кого. Для разработчиков и маркетологов, которым нужны и поиск, и спрос по ключевым словам Wordstat в одном официальном MCP-сервере.

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

  • Нужны и поиск, и спрос по ключевым словам Wordstat в одном сервере
  • Важно, чтобы веб- и картиночный поиск возвращали структурированные группы документов, а не сырой XML
  • Устраивает установка одной командой npm install из зарегистрированного пакета

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

  • Нужен доступ к Яндекс Вебмастеру или Директу: сервер покрывает только Search.API и Wordstat
  • Не готовы оформлять сервисный аккаунт Yandex Cloud с ключом и Folder ID

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

Найди топ похожих запросов для купить зимнюю резину и покажи динамику спроса за последний месяц

MCP

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

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

API_KEY обязательная, секрет
Ключ сервисного аккаунта Yandex Cloud для Search.API
FOLDER_ID обязательная
ID папки Yandex Cloud

Ограничения

Нужны переменные FOLDER_ID и API_KEY сервисного аккаунта Yandex Cloud. Веб-поиск принудительно использует формат XML, других форматов ответа нет. Wordstat недоступен без отдельного разрешения на использование этого метода в Yandex Cloud.

Как отключить. Удалите запись yandex-searchapi из mcpServers в конфигурации клиента.

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

В каком формате приходит веб-поиск?

Сервер всегда запрашивает XML (responseFormat FORMAT_XML) и сам разбирает его в структурированные группы документов.

Нужен ли отдельный доступ для Wordstat?

Да, методы Wordstat в Yandex Cloud обычно требуют отдельного разрешения на сервисном аккаунте.

Обсуждение

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

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

MCP-сервер Yandex Cloud Search API v2: Вордстат и веб-поиск с файловым кешем, нормализацией дат и устойчивостью к 429

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

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

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

Компактный MCP-сервер на TypeScript для Яндекс Вордстата через Yandex Search API: топ запросов, динамика и регионы

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

Компактный MCP-сервер на официальном SDK для пяти операций Яндекс Wordstat: топ, динамика, регионы, дерево регионов, данные аккаунта

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

MCP-сервер к Яндекс Вордстату через Yandex Cloud Search API: частотность, динамика, регионы и построитель фраз с операторами

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

Коротко о README

README перечисляет все семь инструментов с входными и выходными полями, объясняет, что сервер использует только REST-эндпоинты Search.API и Wordstat, дает установку через npm и пример конфигурации MCP-клиента с переменными FOLDER_ID и API_KEY.

Бейдж для README

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