Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Las reseñas y las cuentas llegarán en una etapa posterior.
PopNx MCPServidores MCP para quienes usan IA · explicados con palabras sencillas

Yandex Wordstat MCP Server

de solaixversión 0.1.1i★ –iSe ejecuta en tu computadora
Nombre en el registroio.github.solaix/wordstat-mcp-server

Instalar

Resumen

Descripción del creador (original en inglés)

Unofficial Yandex Wordstat MCP server for SEO keyword research, trends, and regional interest.

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

  • Conexión: Se ejecuta en tu computadora
  • Transporte: stdio
  • Categoría: Marketing y redes sociales
  • Debes completar: YANDEX_WORDSTAT_API_KEY, YANDEX_WORDSTAT_IAM_TOKEN

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

  • Revisiones básicas: 1 de 1 superadas
  • Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
  • Debes completar tú: YANDEX_WORDSTAT_API_KEY, YANDEX_WORDSTAT_IAM_TOKEN, YANDEX_WORDSTAT_FOLDER_ID, YANDEX_WORDSTAT_TIMEOUT_MS, YANDEX_WORDSTAT_MAX_RETRIES, YANDEX_WORDSTAT_MAX_RPS, YANDEX_WORDSTAT_MAX_RPH, YANDEX_WORDSTAT_MAX_CONCURRENCY, YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS, YANDEX_WORDSTAT_LOG_LEVEL

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

  • npmNode.js instalado (para el comando npx)

¿Qué app usas?

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "wordstat": {
      "command": "npx",
      "args": [
        "-y",
        "wordstat-mcp-server"
      ],
      "env": {
        "YANDEX_WORDSTAT_API_KEY": "your-value",
        "YANDEX_WORDSTAT_IAM_TOKEN": "your-value",
        "YANDEX_WORDSTAT_FOLDER_ID": "your-value",
        "YANDEX_WORDSTAT_TIMEOUT_MS": "your-value",
        "YANDEX_WORDSTAT_MAX_RETRIES": "your-value",
        "YANDEX_WORDSTAT_MAX_RPS": "your-value",
        "YANDEX_WORDSTAT_MAX_RPH": "your-value",
        "YANDEX_WORDSTAT_MAX_CONCURRENCY": "your-value",
        "YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS": "your-value",
        "YANDEX_WORDSTAT_LOG_LEVEL": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add wordstat --env YANDEX_WORDSTAT_API_KEY=your-value --env YANDEX_WORDSTAT_IAM_TOKEN=your-value --env YANDEX_WORDSTAT_FOLDER_ID=your-value --env YANDEX_WORDSTAT_TIMEOUT_MS=your-value --env YANDEX_WORDSTAT_MAX_RETRIES=your-value --env YANDEX_WORDSTAT_MAX_RPS=your-value --env YANDEX_WORDSTAT_MAX_RPH=your-value --env YANDEX_WORDSTAT_MAX_CONCURRENCY=your-value --env YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS=your-value --env YANDEX_WORDSTAT_LOG_LEVEL=your-value -- npx -y wordstat-mcp-server

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "wordstat": {
      "command": "npx",
      "args": [
        "-y",
        "wordstat-mcp-server"
      ],
      "env": {
        "YANDEX_WORDSTAT_API_KEY": "your-value",
        "YANDEX_WORDSTAT_IAM_TOKEN": "your-value",
        "YANDEX_WORDSTAT_FOLDER_ID": "your-value",
        "YANDEX_WORDSTAT_TIMEOUT_MS": "your-value",
        "YANDEX_WORDSTAT_MAX_RETRIES": "your-value",
        "YANDEX_WORDSTAT_MAX_RPS": "your-value",
        "YANDEX_WORDSTAT_MAX_RPH": "your-value",
        "YANDEX_WORDSTAT_MAX_CONCURRENCY": "your-value",
        "YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS": "your-value",
        "YANDEX_WORDSTAT_LOG_LEVEL": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "wordstat": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wordstat-mcp-server"
      ],
      "env": {
        "YANDEX_WORDSTAT_API_KEY": "your-value",
        "YANDEX_WORDSTAT_IAM_TOKEN": "your-value",
        "YANDEX_WORDSTAT_FOLDER_ID": "your-value",
        "YANDEX_WORDSTAT_TIMEOUT_MS": "your-value",
        "YANDEX_WORDSTAT_MAX_RETRIES": "your-value",
        "YANDEX_WORDSTAT_MAX_RPS": "your-value",
        "YANDEX_WORDSTAT_MAX_RPH": "your-value",
        "YANDEX_WORDSTAT_MAX_CONCURRENCY": "your-value",
        "YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS": "your-value",
        "YANDEX_WORDSTAT_LOG_LEVEL": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

  • YANDEX_WORDSTAT_API_KEY secreto env
    Yandex Cloud API key. Set exactly one credential: this or YANDEX_WORDSTAT_IAM_TOKEN.
  • YANDEX_WORDSTAT_IAM_TOKEN secreto env
    Yandex Cloud IAM token. Set exactly one credential: this or YANDEX_WORDSTAT_API_KEY.
  • YANDEX_WORDSTAT_FOLDER_ID env
    Folder ID required for user or federated-user IAM tokens.
  • YANDEX_WORDSTAT_TIMEOUT_MS env
    Request timeout in milliseconds (1-300000). Server default: 30000.
  • YANDEX_WORDSTAT_MAX_RETRIES env
    Maximum retries for transient failures (0-10). Server default: 2.
  • YANDEX_WORDSTAT_MAX_RPS env
    Maximum requests started per second (1-10000). Server default: 8.
  • YANDEX_WORDSTAT_MAX_RPH env
    Maximum logical requests per hour (0-1000000); 0 disables this limit. Server default: 100.
  • YANDEX_WORDSTAT_MAX_CONCURRENCY env
    Maximum concurrent requests (1-100). Server default: 4.
  • YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS env
    Regions-tree cache lifetime in milliseconds (0-2592000000). Server default: 86400000.
  • YANDEX_WORDSTAT_LOG_LEVEL env
    Diagnostic log level. Server default: error.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 7 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub solaix, dueña del repo

  • … Aún sin revisar

    Sigue en mantenimiento

    Todavía no hemos leído este repo en GitHub

  • … Aún sin revisar

    Tiene licencia

    Todavía no hemos leído este repo en GitHub

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Marketing y redes socialesi

  • Más estrellas que el 0% de los otros 3560 servidores de esta categoría
  • Publicado en el registro más recientemente que el 83% de los otros 3560 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 100% de los otros 3560 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Yandex Wordstat MCP Server?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: YANDEX_WORDSTAT_API_KEY, YANDEX_WORDSTAT_IAM_TOKEN

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.1.1) llegó al registro hace 6 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

An MCP server retrieving transcripts of YouTube videos

Se ejecuta en tu computadora★ 495MITActualizado hace 10 días
Instalar

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

Se ejecuta en tu computadora★ 244MITActualizado hace 10 días
Instalar

AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.

Se ejecuta en la nube★ 137MITActualizado hace 10 días
Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Yandex Wordstat MCP Server

Неофициальный open-source MCP-сервер, который даёт AI-агентам типизированный read-only доступ ко всем стандартным методам Yandex Wordstat API.

Статус: 0.1.1, исправление совместимости с пропущенными protobuf-default значениями Wordstat API.

English

Возможности

  • все четыре метода Wordstat API и дополнительный локальный поиск ID региона по названию;
  • строгие входные и выходные схемы, безопасные авто-диапазоны дат и проверка операторов;
  • повторы временных ошибок с учётом Retry-After, таймауты и отмена запросов;
  • локальные лимиты RPS, запросов в час и параллельности;
  • кэш дерева регионов, дедупликация одновременных запросов и fallback на устаревший кэш;
  • счётчики API-вызовов, HTTP-попыток и приблизительно тарифицируемых вызовов;
  • stdio-транспорт без записи логов в протокольный stdout.

Все инструменты помечены как read-only и idempotent. Запросы к Wordstat являются внешними API-вызовами и могут тарифицироваться.

Требования и доступ

  • Node.js 22.23.4+, 24.22.1+ или 26.12.1+ в соответствующей LTS-линейке;
  • API-ключ со scope yc.search-api.execute или IAM-токен;
  • роль search-api.webSearch.user на нужный каталог Yandex Cloud.

Задайте ровно один credential в окружении MCP-клиента:

export YANDEX_WORDSTAT_API_KEY='your-api-key'

или: export YANDEX_WORDSTAT_IAM_TOKEN='your-iam-token'

Не сохраняйте реальные credentials в репозитории или общей MCP-конфигурации. Перезапустите клиент после изменения его окружения.

Когда нужен YANDEX_WORDSTAT_FOLDER_ID

Переменная обязательна для IAM-токена аккаунта Яндекса или федеративного аккаунта. Укажите ID каталога, на который назначена роль search-api.webSearch.user:

export YANDEX_WORDSTAT_FOLDER_ID='b1g...'

Для API-ключа или IAM-токена сервисного аккаунта переменную обычно не задают: Search API использует каталог сервисного аккаунта.

Подключение к MCP-клиенту

Выберите один способ авторизации: API-ключ или IAM-токен. Не передавайте оба одновременно. В примерах Codex и Claude Code переменные уже экспортированы в окружение процесса клиента.

Codex CLI / IDE

Добавьте в ~/.codex/config.toml:

[mcp_servers.yandex-wordstat]

command = "npx" args = ["-y", "wordstat-mcp-server@latest"] env_vars = ["YANDEX_WORDSTAT_API_KEY"]

Для IAM-токена аккаунта Яндекса или федеративного аккаунта используйте:

[mcp_servers.yandex-wordstat]

command = "npx" args = ["-y", "wordstat-mcp-server@latest"] env_vars = ["YANDEX_WORDSTAT_IAM_TOKEN", "YANDEX_WORDSTAT_FOLDER_ID"]

Затем проверьте подключение командой codex mcp list. Codex CLI и IDE используют общую конфигурацию.

Claude Code
claude mcp add-json --scope user yandex-wordstat \

'{"command":"npx","args":["-y","wordstat-mcp-server@latest"],"env":{"YANDEX_WORDSTAT_API_KEY":"${YANDEX_WORDSTAT_API_KEY}"}}' claude mcp list

Вариант с IAM-токеном аккаунта Яндекса или федеративного аккаунта:

claude mcp add-json --scope user yandex-wordstat \

'{"command":"npx","args":["-y","wordstat-mcp-server@latest"],"env":{"YANDEX_WORDSTAT_IAM_TOKEN":"${YANDEX_WORDSTAT_IAM_TOKEN}","YANDEX_WORDSTAT_FOLDER_ID":"${YANDEX_WORDSTAT_FOLDER_ID}"}}' claude mcp list

Hermes Agent

Добавьте сервер в пользовательский ~/.hermes/config.yaml:

mcp_servers:

yandex_wordstat: command: "npx" args: ["-y", "wordstat-mcp-server@latest"] env: YANDEX_WORDSTAT_API_KEY: "your-api-key"

Вариант с IAM-токеном аккаунта Яндекса или федеративного аккаунта:

mcp_servers:

yandex_wordstat: command: "npx" args: ["-y", "wordstat-mcp-server@latest"] env: YANDEX_WORDSTAT_IAM_TOKEN: "your-iam-token" YANDEX_WORDSTAT_FOLDER_ID: "your-folder-id"

Hermes передаёт stdio-серверу только явно перечисленные переменные. Не добавляйте пользовательский конфиг с credential в репозиторий.

Проверьте подключение командой hermes mcp test yandex_wordstat, затем перезапустите Hermes или выполните /reload-mcp. Инструменты будут зарегистрированы с префиксом mcp_yandex_wordstat_. Параллельные вызовы по умолчанию выключены, что помогает контролировать квоту.

Инструменты

ИнструментНазначениеВажные параметры
wordstat_top_requestsПопулярные и связанные запросы за последние 30 днейphrase, num_phrases 1–2000, region_ids, devices
wordstat_dynamicsДневная, недельная или месячная динамикаphrase, period, from_date, to_date, auto_dates, фильтры
wordstat_regionsЧастота, доля и affinity index по регионам за последние 30 днейphrase, region_type, limit, offset, resolve_names
wordstat_regions_treeИерархия поддерживаемых регионовmax_depth 1–20, root_region_id
wordstat_find_regionsЛокальный поиск ID региона по названиюquery, limit, parent_region_id, include_children

Значения devices: all, desktop, phone, tablet; all нельзя сочетать с другими значениями. В одном запросе допускается до 100 region_ids.

wordstat_find_regions работает по кэшированному дереву. Он полезен, когда агент знает название региона, но не его ID. wordstat_regions при resolve_names: true делает дополнительный бесплатный вызов дерева только при промахе кэша. Каждая следующая страница wordstat_regions заново вызывает платный метод распределения по регионам, поэтому для полной выборки лучше использовать максимальный limit.

Даты и операторы

wordstat_dynamics принимает даты в формате YYYY-MM-DD. Если при auto_dates: true обе даты отсутствуют, сервер запрашивает последние 60 завершённых дней, 52 завершённые недели или 12 завершённых месяцев — в зависимости от детализации. Если отсутствует только одна граница, сервер вычисляет её; автоматически добавленный to_date всегда указывает на последний завершённый период. Явно переданные границы не сдвигаются. При auto_dates: false обязателен только from_date; to_date можно не задавать.

Дневной диапазон не может превышать 60 дней. Для недельной и месячной детализации Wordstat документирует диапазон от 3 недель или месяцев до 5 лет; самая ранняя доступная история начинается с января 2018 года. Неделя задаётся от понедельника до воскресенья, месяц — от первого до последнего дня месяца.

Live-проверки показали наблюдаемое, но не документированное поведение: последние календарные точки могут быть ещё не опубликованы, API возвращает только доступную часть пересекающегося диапазона, а диапазон целиком после последней опубликованной точки может получить HTTP 400. Поскольку HTTP 400 может иметь и другие причины, проверьте все параметры запроса; для недавнего диапазона попробуйте более ранние даты. Сервер не сдвигает явно заданный диапазон и не делает дополнительный платный запрос автоматически.

Для дневной динамики разрешены операторы -, !, +, кавычки, [], () и |; для недельной и месячной — только +. Явные неподдерживаемые операторы для недельной и месячной детализации отклоняются до платного API-вызова.

Метаданные результата

Каждый успешный ответ содержит:

  • api_calls — логические вызовы Wordstat API, включая бесплатное дерево регионов;
  • http_attempts — все HTTP-попытки, в том числе повторы;
  • billable_calls_estimate — оценка платных вызовов; финальный биллинг определяет Yandex;
  • local_hourly_budget_remaining — остаток локального часового лимита или null;
  • content_truncated — был ли сокращён текстовый MCP-контент из-за размера.

Поля count и total_count возвращаются строками, чтобы не терять точность 64-битных целых.

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

Расширение семантики
Подбери запросы по теме «онлайн-курсы английского». Покажи 100 популярных запросов

и похожие запросы за последний месяц. Сгруппируй их по смыслу: обучение, цена, формат, уровень и бренды. В каждой группе выдели 5 самых популярных фраз. Популярные и похожие запросы покажи отдельно.

Сравнение регионального спроса
Сравни спрос на «доставка цветов» в Москве и Санкт-Петербурге за последние 12 полных

месяцев. Найди нужные регионы сам. Покажи динамику по месяцам для каждого города, отметь месяцы с самым высоким и низким спросом и объясни различия в сезонности. Если каких-то данных нет, не додумывай их.

Интерес по регионам
Покажи, в каких регионах запросом «горнолыжный курорт» интересуются сильнее всего.

Составь два списка: топ-15 регионов по индексу интереса и топ-15 по числу запросов. Для каждого региона укажи число запросов, долю и индекс интереса. Коротко объясни, почему списки отличаются. Загружай дополнительные страницы только при необходимости.

Сезонность и сравнение с прошлым годом
Проанализируй спрос на «кондиционер» по России за последние 24 полных календарных месяца,

не включая текущий месяц. Используй регион «Россия» с ID 225 и обязательно задай начало и конец периода. Сравни каждый месяц с тем же месяцем годом ранее. Покажи изменение в запросах и процентах, а также начало и пик сезона. Если данных не хватает, перечисли пропущенные месяцы и сравни только полные пары. Если год назад было ноль запросов, процентное изменение не рассчитывай.

Различия по устройствам
Сравни спрос на «заказать продукты» с компьютеров, телефонов и планшетов за последние

60 полных дней. Для каждого типа устройства покажи общее число запросов, среднее за день и его долю среди трёх типов устройств. Сравнивай только даты, которые есть во всех выборках. Не называй число запросов количеством уникальных пользователей.

Влияние операторов Wordstat
Покажи, как кавычки влияют на статистику запроса «ремонт квартир». Сравни за последние

60 полных дней обычный запрос ремонт квартир и запрос в кавычках "ремонт квартир". Покажи общую частотность каждого варианта, разницу между ними и простыми словами объясни, что ограничивают кавычки в Wordstat.

Контроль стоимости исследования
Нужно изучить запрос «ипотека»: популярные и похожие запросы, динамику по месяцам

и интерес по регионам. Сначала скажи, сколько платных обращений к Wordstat потребуется, и дождись моего подтверждения. После исследования покажи фактическое число обращений и отдельно отметь повторные попытки, если они были.

Конфигурация

ПеременнаяПо умолчаниюДопустимые значения
YANDEX_WORDSTAT_API_KEY—Ровно один из двух credentials
YANDEX_WORDSTAT_IAM_TOKEN—Ровно один из двух credentials
YANDEX_WORDSTAT_FOLDER_ID—До 50 символов; см. условия выше
YANDEX_WORDSTAT_TIMEOUT_MS300001–300000
YANDEX_WORDSTAT_MAX_RETRIES20–10
YANDEX_WORDSTAT_MAX_RPS81–10000
YANDEX_WORDSTAT_MAX_RPH1000–1000000; 0 отключает лимит
YANDEX_WORDSTAT_MAX_CONCURRENCY41–100
YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS864000000–2592000000
YANDEX_WORDSTAT_LOG_LEVEL

Solo se muestra el principio; lee el resto en el repo

Pregunta a PopNx