yandex-wordstat-mcp от nikolaymokh-dev

yandex-wordstat-mcp

MCP-сервер Вордстата через Yandex Search API с оценкой и учетом стоимости запросов до и после вызова

nikolaymokh-dev/yandex-wordstat-mcpАвтор:nikolaymokh-dev

Установка

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

npx skillfoxx add mcp/nikolaymokh-dev-yandex-wordstat-mcp

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

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

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

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

claude mcp add --transport stdio --env 'YANDEX_SEARCH_API_KEY=<ваш YANDEX_SEARCH_API_KEY>' --env 'YANDEX_FOLDER_ID=<ваш YANDEX_FOLDER_ID>' yandex-wordstat -- uvx --from git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp yandex-wordstat-mcp

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

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp",
        "yandex-wordstat-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>"
      }
    }
  }
}

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

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

YANDEX_SEARCH_API_KEYсекрет, обязательная: API-ключ Yandex Cloud для Search API
YANDEX_FOLDER_IDсекрет, обязательная: ID каталога (folder ID) в Yandex Cloud

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

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

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

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

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp",
        "yandex-wordstat-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>"
      }
    }
  }
}

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

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

YANDEX_SEARCH_API_KEYсекрет, обязательная: API-ключ Yandex Cloud для Search API
YANDEX_FOLDER_IDсекрет, обязательная: ID каталога (folder ID) в Yandex Cloud

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

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

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

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

code --add-mcp '{"name":"yandex-wordstat","type":"stdio","command":"uvx","args":["--from","git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp","yandex-wordstat-mcp"],"env":{"YANDEX_SEARCH_API_KEY":"<ваш YANDEX_SEARCH_API_KEY>","YANDEX_FOLDER_ID":"<ваш YANDEX_FOLDER_ID>"}}'

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

{
  "servers": {
    "yandex-wordstat": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp",
        "yandex-wordstat-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>"
      }
    }
  }
}

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

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

YANDEX_SEARCH_API_KEYсекрет, обязательная: API-ключ Yandex Cloud для Search API
YANDEX_FOLDER_IDсекрет, обязательная: ID каталога (folder ID) в Yandex Cloud

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

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

codex mcp add yandex-wordstat --env 'YANDEX_SEARCH_API_KEY=<ваш YANDEX_SEARCH_API_KEY>' --env 'YANDEX_FOLDER_ID=<ваш YANDEX_FOLDER_ID>' -- uvx --from git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp yandex-wordstat-mcp

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

[mcp_servers.yandex-wordstat]
command = "uvx"
args = ["--from", "git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp", "yandex-wordstat-mcp"]
env = { YANDEX_SEARCH_API_KEY = "<ваш YANDEX_SEARCH_API_KEY>", YANDEX_FOLDER_ID = "<ваш YANDEX_FOLDER_ID>" }

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

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

YANDEX_SEARCH_API_KEYсекрет, обязательная: API-ключ Yandex Cloud для Search API
YANDEX_FOLDER_IDсекрет, обязательная: ID каталога (folder ID) в Yandex Cloud

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

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

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp",
        "yandex-wordstat-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>"
      }
    }
  }
}

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

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

YANDEX_SEARCH_API_KEYсекрет, обязательная: API-ключ Yandex Cloud для Search API
YANDEX_FOLDER_IDсекрет, обязательная: ID каталога (folder ID) в Yandex Cloud

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

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

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp",
        "yandex-wordstat-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>"
      }
    }
  }
}

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

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

YANDEX_SEARCH_API_KEYсекрет, обязательная: API-ключ Yandex Cloud для Search API
YANDEX_FOLDER_IDсекрет, обязательная: ID каталога (folder ID) в Yandex Cloud

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

Бывший Windsurf.

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

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp",
        "yandex-wordstat-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>"
      }
    }
  }
}

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

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

YANDEX_SEARCH_API_KEYсекрет, обязательная: API-ключ Yandex Cloud для Search API
YANDEX_FOLDER_IDсекрет, обязательная: ID каталога (folder ID) в Yandex Cloud

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

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

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp",
        "yandex-wordstat-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>"
      }
    }
  }
}

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

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

YANDEX_SEARCH_API_KEYсекрет, обязательная: API-ключ Yandex Cloud для Search API
YANDEX_FOLDER_IDсекрет, обязательная: ID каталога (folder ID) в Yandex Cloud

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

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

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

{
  "mcp": {
    "yandex-wordstat": {
      "type": "local",
      "command": [
        "uvx",
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp",
        "yandex-wordstat-mcp"
      ],
      "environment": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>"
      }
    }
  }
}

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

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

YANDEX_SEARCH_API_KEYсекрет, обязательная: API-ключ Yandex Cloud для Search API
YANDEX_FOLDER_IDсекрет, обязательная: ID каталога (folder ID) в Yandex Cloud

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

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

{
  "context_servers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp",
        "yandex-wordstat-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>"
      }
    }
  }
}

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

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

YANDEX_SEARCH_API_KEYсекрет, обязательная: API-ключ Yandex Cloud для Search API
YANDEX_FOLDER_IDсекрет, обязательная: ID каталога (folder ID) в Yandex Cloud

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

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

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp",
        "yandex-wordstat-mcp"
      ],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<ваш YANDEX_SEARCH_API_KEY>",
        "YANDEX_FOLDER_ID": "<ваш YANDEX_FOLDER_ID>"
      }
    }
  }
}

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

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

YANDEX_SEARCH_API_KEYсекрет, обязательная: API-ключ Yandex Cloud для Search API
YANDEX_FOLDER_IDсекрет, обязательная: ID каталога (folder ID) в Yandex Cloud

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

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

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

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

Добавь сервер командой claude mcp add yandex-wordstat --env YANDEX_SEARCH_API_KEY=<ключ> --env YANDEX_FOLDER_ID=<id> -- uvx --from git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp yandex-wordstat-mcp, затем проверь wordstat_cost_estimate перед массовым сбором.

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

claude mcp add yandex-wordstat --env YANDEX_SEARCH_API_KEY=<ваш-API-ключ> --env YANDEX_FOLDER_ID=<ваш-folder-id> -- uvx --from git+https://github.com/nikolaymokh-dev/yandex-wordstat-mcp yandex-wordstat-mcp

Команда из README: ставит и запускает сервер напрямую из Git через uvx, клонировать не нужно.

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

Что делает

Тонкая обертка над Wordstat-методами Yandex Search API: топ запросов с похожими фразами, динамика частоты по месяцам, неделям или дням, распределение по регионам с affinity-индексом и дерево кодов регионов. Отдельно от самого Вордстата сервер ведет локальный лог вызовов и дает два инструмента учета: wordstat_cost_report, сводка фактических трат, wordstat_cost_estimate, оценка стоимости пачки запросов заранее, до того как агент их отправит.

Для кого. Для тех, кто хочет видеть расход по платному Search API до и после того, как агент сделал запросы.

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

Нужна частотность и динамика Вордстата с прозрачным учетом трат
Хочется заранее оценить стоимость пачки запросов перед массовым сбором семантики
Нужен установочный one-liner через uvx прямо из GitHub без клонирования

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

Нет привязанной карты в биллинге Yandex Cloud: без нее Search API часто отвечает 403
Нужны инструменты за пределами четырех методов Wordstat API

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

Оцени, сколько будет стоить проверить динамику по 50 фразам за год, прежде чем запускать

Ограничения

Требует привязанную к биллингу карту в Yandex Cloud (даже без реального расхода), ключ со scope yc.search-api.execute и роль search-api.webSearch.user. Секреты читаются только из окружения при запуске, файл .env локальной разработки автоматически не подхватывается.

Как отключить. Выполните claude mcp remove yandex-wordstat или удалите запись сервера из конфигурации клиента.

MCP

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

Переменные окружения
Переменные окружения
YANDEX_SEARCH_API_KEY обязательная, секрет	API-ключ Yandex Cloud со scope yc.search-api.execute.
YANDEX_FOLDER_ID обязательная	ID каталога Yandex Cloud из консоли, часть URL после /folders/.

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

Только читает статистику поисковых запросов, ничего не меняет в аккаунтах
Запросы платные, но сервер сам дает инструменты контроля расхода до и после вызовов

Коротко о README

README на русском описывает установку одной командой через uvx из GitHub, дает пошаговую настройку Yandex Cloud с привязкой карты и назначением роли, таблицу инструментов с двумя дополнительными для учета трат и таблицу частых ошибок 401/403.

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

Почему Search API отвечает 403?

Чаще всего нет привязанной карты в биллинге Yandex Cloud или у ключа не та область прав, README разбирает оба случая.

Как узнать, сколько уже потрачено?

Инструмент wordstat_cost_report дает сводку по локальному логу вызовов.

Скиллы 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