Yandex Wordstat MCP Server

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

MCP-серверРоссийский стек

baltic-tea/yandex-wordstat-mcpАвтор:baltic_tea

Установка

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

npx skillfoxx add mcp/yandex-wordstat-mcp-server

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

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

Собрано автоматически, проверьте перед установкой.

Выполните в терминале

claude mcp add --transport stdio --env 'WORDSTAT_FOLDER_ID=<значение WORDSTAT_FOLDER_ID>' yandex-wordstat -- uvx --from git+https://github.com/baltic-tea/yandex-wordstat-mcp.git wordstat-mcp

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<значение WORDSTAT_FOLDER_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

WORDSTAT_FOLDER_IDобязательная: Folder ID for each API request
WORDSTAT_API_KEYсекрет, необязательная: API key for authentication
WORDSTAT_IAM_TOKENсекрет, необязательная: IAM token for authentication, used if specified instead of API key

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<значение WORDSTAT_FOLDER_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

WORDSTAT_FOLDER_IDобязательная: Folder ID for each API request
WORDSTAT_API_KEYсекрет, необязательная: API key for authentication
WORDSTAT_IAM_TOKENсекрет, необязательная: IAM token for authentication, used if specified instead of API key

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"yandex-wordstat","type":"stdio","command":"uvx","args":["--from","git+https://github.com/baltic-tea/yandex-wordstat-mcp.git","wordstat-mcp"],"env":{"WORDSTAT_FOLDER_ID":"<значение WORDSTAT_FOLDER_ID>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "yandex-wordstat": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<значение WORDSTAT_FOLDER_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

WORDSTAT_FOLDER_IDобязательная: Folder ID for each API request
WORDSTAT_API_KEYсекрет, необязательная: API key for authentication
WORDSTAT_IAM_TOKENсекрет, необязательная: IAM token for authentication, used if specified instead of API key

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add yandex-wordstat --env 'WORDSTAT_FOLDER_ID=<значение WORDSTAT_FOLDER_ID>' -- uvx --from git+https://github.com/baltic-tea/yandex-wordstat-mcp.git wordstat-mcp

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.yandex-wordstat]
command = "uvx"
args = ["--from", "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git", "wordstat-mcp"]
env = { WORDSTAT_FOLDER_ID = "<значение WORDSTAT_FOLDER_ID>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

WORDSTAT_FOLDER_IDобязательная: Folder ID for each API request
WORDSTAT_API_KEYсекрет, необязательная: API key for authentication
WORDSTAT_IAM_TOKENсекрет, необязательная: IAM token for authentication, used if specified instead of API key

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<значение WORDSTAT_FOLDER_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

WORDSTAT_FOLDER_IDобязательная: Folder ID for each API request
WORDSTAT_API_KEYсекрет, необязательная: API key for authentication
WORDSTAT_IAM_TOKENсекрет, необязательная: IAM token for authentication, used if specified instead of API key

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<значение WORDSTAT_FOLDER_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

WORDSTAT_FOLDER_IDобязательная: Folder ID for each API request
WORDSTAT_API_KEYсекрет, необязательная: API key for authentication
WORDSTAT_IAM_TOKENсекрет, необязательная: IAM token for authentication, used if specified instead of API key

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<значение WORDSTAT_FOLDER_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

WORDSTAT_FOLDER_IDобязательная: Folder ID for each API request
WORDSTAT_API_KEYсекрет, необязательная: API key for authentication
WORDSTAT_IAM_TOKENсекрет, необязательная: IAM token for authentication, used if specified instead of API key

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<значение WORDSTAT_FOLDER_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

WORDSTAT_FOLDER_IDобязательная: Folder ID for each API request
WORDSTAT_API_KEYсекрет, необязательная: API key for authentication
WORDSTAT_IAM_TOKENсекрет, необязательная: IAM token for authentication, used if specified instead of API key

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "yandex-wordstat": {
      "type": "local",
      "command": [
        "uvx",
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "environment": {
        "WORDSTAT_FOLDER_ID": "<значение WORDSTAT_FOLDER_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

WORDSTAT_FOLDER_IDобязательная: Folder ID for each API request
WORDSTAT_API_KEYсекрет, необязательная: API key for authentication
WORDSTAT_IAM_TOKENсекрет, необязательная: IAM token for authentication, used if specified instead of API key

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<значение WORDSTAT_FOLDER_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

WORDSTAT_FOLDER_IDобязательная: Folder ID for each API request
WORDSTAT_API_KEYсекрет, необязательная: API key for authentication
WORDSTAT_IAM_TOKENсекрет, необязательная: IAM token for authentication, used if specified instead of API key

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<значение WORDSTAT_FOLDER_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

WORDSTAT_FOLDER_IDобязательная: Folder ID for each API request
WORDSTAT_API_KEYсекрет, необязательная: API key for authentication
WORDSTAT_IAM_TOKENсекрет, необязательная: IAM token for authentication, used if specified instead of API key

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 26 сент. 2026, коммит b8e26a7.

Текст для агента

Установи сервер командой uvx --from git+https://github.com/baltic-tea/yandex-wordstat-mcp.git wordstat-mcp, добавь его в MCP-клиента с переменными WORDSTAT_FOLDER_ID и WORDSTAT_API_KEY (или WORDSTAT_IAM_TOKEN), затем вызови getTop для проверки.

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

uvx --from git+https://github.com/baltic-tea/yandex-wordstat-mcp.git wordstat-mcp

Основной способ из README: запускает сервер напрямую из Git через uvx, без клонирования.

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

Что делает

Сервер на FastMCP оборачивает методы Wordstat API v2 (getTop, getDynamics, getRegionsDistribution, getRegionsTree) и добавляет свои инструменты поверх: build_wordstat_phrase собирает корректную фразу с операторами (кавычки, плюс, минус-слова) из обычной формулировки на русском, find_regions ищет ID региона по названию с локальным кешем дерева регионов, а задачи вроде поиска похожих запросов или сравнения спроса по регионам доступны под понятными именами (find_keyword_queries, get_query_demand_trends). Есть повторные попытки при сетевых сбоях и 429/5xx, ресурс и prompt с гайдом по операторам Вордстата для агента.

Для кого. Для маркетологов и SEO-специалистов, которые собирают семантику и проверяют спрос через агента вместо сайта Вордстата.

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

Нужно проверить частотность фразы и похожие запросы
Нужна сезонность спроса по месяцам, неделям или дням
Нужно сравнить спрос по регионам или найти ID региона по названию города

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

Нет доступа к Yandex Cloud с включенным Search API
Нужны данные Яндекс Директа или готовые кластеры, а не сырые частоты

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

Проверь частотность фразы «купить пылесос» по Москве и покажи топ похожих запросов

Ограничения

Нужен ключ Yandex Cloud (API-ключ или IAM-токен) и Folder ID, вызовы Search API платные по тарифам Яндекс Облака. Метод getDynamics поддерживает только оператор «+» и отклоняет остальные операторы. Дерево регионов кешируется локально в файл .saved, обновление вручную через отдельный инструмент.

Как отключить. Удалите сервер из конфигурации MCP клиента (например, claude mcp remove yandex-wordstat) или сотрите каталог .saved с локальным кешем регионов.

MCP

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

Переменные окружения
Переменные окружения
WORDSTAT_FOLDER_ID обязательная	ID каталога в Yandex Cloud, обязателен для каждого запроса.
WORDSTAT_API_KEY секрет	API-ключ Yandex Cloud; нужен либо он, либо IAM-токен.
WORDSTAT_IAM_TOKEN секрет	IAM-токен Yandex Cloud; имеет приоритет, если задан вместе с API-ключом.

Проверка безопасности

Только читает публичную статистику поисковых запросов, ничего не меняет в аккаунтах пользователя
Каждый вызов Search API тарифицируется Yandex Cloud, стоит следить за расходом баланса

Коротко о README

README на английском и русском описывает установку через uvx прямо из Git, настройку .env с ключом и Folder ID и список инструментов: четыре метода Wordstat API, построитель фраз с операторами, поиск региона с локальным кешем и служебный wordstat_env_health. Отдельно расписана настройка для Claude Desktop, Claude Code и Codex с готовыми командами claude mcp add и codex mcp add.

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

Чем IAM-токен отличается от API-ключа?

Оба подходят для авторизации в Yandex Cloud; если заданы оба, сервер использует IAM-токен.

Можно ли собрать фразу с минус-словами из обычной просьбы?

Да, build_wordstat_phrase понимает формулировки на русском и строит фразу с нужными операторами Вордстата.

Скиллы DataLens

DataLens Skills

Официальный

Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS

СкиллСредний рискРоссийский стекБез VPN12

MCP Яндекс Метрики со всеми 108 методами API

Yandex Metrika MCP Server

Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2

OpenSEO

Официальный

Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO

MCP-серверСредний риск21,5 тыс.

Claude SEO

Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов

ПлагинВысокий риск17,9 тыс.

Установка

Что делает

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

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

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

Ограничения

MCP

Проверка безопасности

Коротко о README

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

Похожие

Скиллы DataLens

MCP Яндекс Метрики со всеми 108 методами API

OpenSEO

Claude SEO