askads/mcp-yandex-wordstat

**Яндекс Вордстат 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.
1. Получите доступ и добавьте сервер в AI-приложение — инструкции для пяти приложений ниже.
2. Спросите: «Сколько в месяц ищут „купить велосипед“ и какие есть похожие запросы?»
Codex
**Через интерфейс приложения:**
1. Откройте **Settings → Plugins → MCP servers**.
2. Нажмите **Add server**.
3. Добавьте команду запуска npx -y mcp-yandex-wordstat@latest и переменные окружения WORDSTAT_API_KEY, WORDSTAT_FOLDER_ID.
**Через командную строку:**
Проверьте подключение:
Официальная инструкция Codex
Claude Code
Проверьте сервер:
Документация Claude Code
Claude Desktop
Откройте **Settings → Developer → Edit Config** и добавьте сервер в claude_desktop_config.json:
Если **Edit Config** недоступна, отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows.
Cursor
Для всех проектов создайте ~/.cursor/mcp.json; только для текущего проекта — .cursor/mcp.json:
Документация Cursor
VS Code
Откройте палитру команд и выполните **MCP: Open User Configuration**. Добавьте в mcp.json:
Проверьте запуск командой **MCP: List Servers**.
Документация VS Code
Что можно поручить
Подобрать и оценить спрос
- «Сколько раз за месяц ищут эту фразу и какие похожие запросы встречаются?»
- «Подбери запросы вокруг „доставка пиццы“ с их частотностью».
- «Покажи запросы, содержащие мою фразу, отдельно от семантически похожих».
Понять сезонность
- «Покажи спрос на „лыжи“ по месяцам за год».
- «В какие недели спрос на эту услугу растёт или падает?»
- «Сравни динамику запроса на телефонах и компьютерах».
Сравнить регионы
- «В каких городах интерес к „ремонту квартир“ выше среднего?»
- «Сравни спрос в Москве и Санкт-Петербурге».
- «Найди ID нужного региона и сузь следующий отчёт до него».
Как читать данные спроса