Yandex Wordstat MCP

MCP server for Yandex Wordstat — keyword search-demand: top & related queries, demand dynamics, and regional distribution. Read-only.

Яндекс Вордстат MCPподключает AI-приложение к статистике поискового спроса Яндекса. Спросите, как часто ищут фразу, в какие месяцы интерес растёт и в каких городах тема популярнее, — ассистент соберёт данные Вордстата и объяснит результат. Сервер работает через Yandex Cloud Search API, поэтому не требует доступа к рекламному кабинету Директа.

- Пять инструментов.Топ и похожие запросы, динамика спроса, распределение по регионам, справочник регионов и технический запрос к API.
- Только чтение.API Вордстата не создаёт кампании, объявления, ключевые фразы и другие объекты.
- Спрос и сезонность.Топ запросов и регионы показывают последние 30 дней; динамика строится по дням, неделям или месяцам за нужный период.
- Регион и устройство.Отчёты можно сузить до региона и сравнить спрос на компьютерах, телефонах и планшетах.
- Без OAuth Директа.Нужны API-ключ и ID каталога Yandex Cloud для Search API.

Сколько в месяц ищут «купить велосипед» и какие есть похожие запросы?

Подключить сервер·Посмотреть сценарии·Открыть техническую документацию

- Быстрый старт
- Что можно поручить
- Как читать данные спроса
- Как получить доступ
- Что может изменить данные
- Данные, лимиты и работа в фоне
- Техническая документация
- Поддержка

Нужны Node.js 20 или новее, API-ключ Yandex Cloud для Search API и ID каталога Yandex Cloud.
- Получите доступи добавьте сервер в AI-приложение — инструкции для пяти приложений ниже.
- Спросите: «Сколько в месяц ищут „купить велосипед“ и какие есть похожие запросы?»
- ОткройтеSettings → Plugins → MCP servers.
- НажмитеAdd server.
- Добавьте команду запускаnpx -y mcp-yandex-wordstat@latestи переменные окруженияWORDSTAT_API_KEY,WORDSTAT_FOLDER_ID.

codex mcp add yandex-wordstat \ --env WORDSTAT_API_KEY=ваш_ключ \ --env WORDSTAT_FOLDER_ID=ваш_folder_id \ -- npx -y mcp-yandex-wordstat@latest

claude mcp add \ --env WORDSTAT_API_KEY=ваш_ключ \ --env WORDSTAT_FOLDER_ID=ваш_folder_id \ --transport stdio \ --scope user \ yandex-wordstat \ -- npx -y mcp-yandex-wordstat@latest

{ "mcpServers": { "yandex-wordstat": { "command": "npx", "args": ["-y", "mcp-yandex-wordstat@latest"], "env": { "WORDSTAT_API_KEY": "ваш_ключ", "WORDSTAT_FOLDER_ID": "ваш_folder_id" } } } }

ЕслиEdit Configнедоступна, отредактируйте~/Library/Application Support/Claude/claude_desktop_config.jsonна macOS или%APPDATA%\Claude\claude_desktop_config.jsonна Windows.

Для всех проектов создайте~/.cursor/mcp.json; только для текущего проекта —.cursor/mcp.json:

{ "mcpServers": { "yandex-wordstat": { "command": "npx", "args": ["-y", "mcp-yandex-wordstat@latest"], "env": { "WORDSTAT_API_KEY": "ваш_ключ", "WORDSTAT_FOLDER_ID": "ваш_folder_id" } } } }

Откройте палитру команд и выполнитеMCP: Open User Configuration. Добавьте вmcp.json:

{ "servers": { "yandex-wordstat": { "type": "stdio", "command": "npx", "args": ["-y", "mcp-yandex-wordstat@latest"], "env": { "WORDSTAT_API_KEY": "${input:wordstat_api_key}", "WORDSTAT_FOLDER_ID": "${input:wordstat_folder_id}" } } }, "inputs": [ { "type": "promptString", "id": "wordstat_api_key", "description": "API-ключ Yandex Cloud", "password": true }, { "type": "promptString", "id": "wordstat_folder_id", "description": "ID каталога Yandex Cloud" } ] }

Проверьте запуск командойMCP: List Servers.

- «Сколько раз за месяц ищут эту фразу и какие похожие запросы встречаются?»
- «Подбери запросы вокруг „доставка пиццы“ с их частотностью».
- «Покажи запросы, содержащие мою фразу, отдельно от семантически похожих».

- «Покажи спрос на „лыжи“ по месяцам за год».
- «В какие недели спрос на эту услугу растёт или падает?»
- «Сравни динамику запроса на телефонах и компьютерах».

- «В каких городах интерес к „ремонту квартир“ выше среднего?»
- «Сравни спрос в Москве и Санкт-Петербурге».
- «Найди ID нужного региона и сузь следующий отчёт до него».

top_requestsпоказывает популярные запросы, которые содержат заданную фразу, и семантически близкие запросы. ОбщийtotalCountотносится к последним 30 дням.

dynamicsвозвращает ряд{date, count, share}с дневной, недельной или месячной детализацией.regionsраспределяет спрос за последние 30 дней по регионам, аaffinityIndexвыше 100% означает интерес выше среднего. Значения счётчиков могут приходить строками: Яндекс передаёт большие целые числа в JSON в таком виде.

Один вызов строит данные только для одной фразы. Для большого списка ключевых слов лучше сначала сузить список, а не запускать все запросы подряд: квота Yandex Cloud Search API общая для одного ключа.
- В Yandex Cloud создайте сервисный аккаунт с рольюsearch-api.webSearch.user.
- Выпустите для него API-ключ со scopeyc.search-api.execute— шаги описаны вдокументации AI Studio.
- Найдите ID каталога (folderId) вконсоли Yandex Cloudна странице каталога и в URL страницы.
- Передайте ключ какWORDSTAT_API_KEY, а каталог какWORDSTAT_FOLDER_ID.

- Каталог MCP-возможностей— страницы по пользовательским задачам для каждого инструмента.
- Все инструменты и параметры
- Документация по разработке
- Документация по публикации
- Документация Yandex Cloud Search API

Нашли ошибку или не хватает сценария?Создайте issueили напишите вTelegram.

Official MCP server for Amazon product research, competitor analysis, keyword discovery, and PPC planning using real Amazon marketplace data.