SkillFoxx
Telegram

Вордстат MCP на Go: частоты Яндекса для ИИ-агента

yandex-wordstat-mcp-golang

MCP-сервер на Go с четырьмя инструментами Вордстата и доступом по Bearer-токену: популярные запросы, динамика и регионы

  • 0 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Запросы к Вордстату тарифицируются Яндексом: цикл агента без ограничений тратит баланс
  • Ключ Yandex Cloud и токен сервера лежат в окружении контейнера, при утечке доступ получает посторонний
Все причины и проверки
Российский стек

977adam/yandex-wordstat-mcp-golangАвтор:977ADAM

Установка

Ручная установка

docker compose up --build

Задайте `WORDSTAT_API_KEY`, `WORDSTAT_FOLDER_ID` и `WORDSTAT_MCP_TOKEN`; в README инструкции нет, файлы `Dockerfile` и `docker-compose.yml` лежат в корне.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Запросы к Вордстату тарифицируются Яндексом: цикл агента без ограничений тратит баланс
  • Ключ Yandex Cloud и токен сервера лежат в окружении контейнера, при утечке доступ получает посторонний

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

Что делает

MCP-сервер на Go отправляет запросы в Wordstat API Яндекса (Search API v2, `searchapi.api.cloud.yandex.net/v2/wordstat/`) и отдает агенту четыре инструмента: популярные и связанные запросы по фразе за 30 дней (`top_requests`), динамику частоты, распределение по регионам и дерево регионов. Работает по Streamable HTTP, порт по умолчанию 8080, доступ закрывается Bearer-токеном из переменной `WORDSTAT_MCP_TOKEN`. Ключ Yandex Cloud и идентификатор каталога берутся из `WORDSTAT_API_KEY` и `WORDSTAT_FOLDER_ID`. Клиент повторяет запрос при ответах 429 и 5xx (всего три попытки), ограничивает частоту вызовов и кеширует ответы. В репозитории есть `Dockerfile`, `docker-compose.yml`, `Makefile` и тесты.

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

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

  • Агент подбирает ключевые фразы и сам смотрит частоту по Москве или России
  • Нужна динамика спроса по неделям или месяцам для планирования контента
  • Команде удобнее один HTTP-сервер с токеном, чем ключи Yandex Cloud на каждом компьютере
  • Требуется сравнить интерес к фразе по регионам и городам

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

  • Нужен локальный stdio-сервер без Docker и сети: здесь транспорт только Streamable HTTP
  • Нужны подробная документация и примеры настройки: README в репозитории пустой, ориентироваться придется по коду
  • Фразы надо обрабатывать пачками на сотни запросов: квота Search API общая, каждый вызов тарифицируется

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

Покажи топ запросов по фразе «купить кофемашину» за 30 дней для региона 213 и динамику по месяцам

MCP

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

Переменные окружения

WORDSTAT_API_KEY обязательная, секрет
Ключ Yandex Cloud с доступом к Search API
WORDSTAT_FOLDER_ID обязательная
Идентификатор каталога Yandex Cloud
WORDSTAT_MCP_TOKEN секрет
Bearer-токен для доступа к самому MCP-серверу
WORDSTAT_HTTP_ADDR
Адрес и порт HTTP-сервера, по умолчанию порт 8080

Ограничения

Репозиторий небольшой: ноль звезд, последний коммит в октябре 2026 года, README пустой, поэтому установку и настройку клиента приходится выводить из `Dockerfile`, `docker-compose.yml` и исходников. Транспорт один, Streamable HTTP, stdio нет. Нужен ключ Yandex Cloud с доступом к Search API и идентификатор каталога. Вызовы к Вордстату тарифицируются Яндексом, кеш и ограничитель частоты только смягчают расход. Частоты берутся за последние 30 дней, период для динамики задается в параметрах.

Как отключить. Удалите сервер из настроек MCP-клиента, остановите контейнер и удалите ключ `WORDSTAT_API_KEY` с токеном `WORDSTAT_MCP_TOKEN`.

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

Какие инструменты есть?

Четыре: популярные запросы `top_requests`, динамика частоты, распределение по регионам и дерево регионов.

Где взять ключ?

В Yandex Cloud: нужен API-ключ с доступом к Search API и идентификатор каталога, их передают в `WORDSTAT_API_KEY` и `WORDSTAT_FOLDER_ID`.

Как закрыт доступ к серверу?

Bearer-токеном: значение берется из `WORDSTAT_MCP_TOKEN`, клиент передает его в заголовке Authorization.

Можно ли запустить без Docker?

Да, это обычный Go-проект с точкой входа `cmd/server/main.go`, но готовой инструкции в README нет.

Что с лимитами запросов?

Клиент ограничивает частоту, кеширует ответы и повторяет вызов при 429 и 5xx до трех попыток.

Обсуждение

Вопросов и отзывов пока нет.

Яндекс Вордстат — все инструменты
Российский стек

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

MCP-серверРасширенный доступ2
Российский стек

Компактный MCP-сервер на TypeScript для Яндекс Вордстата через Yandex Search API: топ запросов, динамика и регионы

MCP-серверРасширенный доступ1
Российский стек

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

MCP-серверРасширенный доступ3
Российский стек

Неофициальный MCP-сервер Вордстата на TypeScript, только чтение: пять инструментов, локальные лимиты вызовов, кеш регионов и счетчики расходов

MCP-серверМинимальный доступ
Российский стек

MCP-сервер Вордстата через Yandex Cloud Search API: частотность и похожие запросы, сезонность, спрос по регионам и устройствам

MCP-серверРасширенный доступ9

Коротко о README

README практически пуст: в нем только дерево каталогов. Описание берется из кода и файла `tech.md` с требованиями к серверу: транспорт Streamable HTTP, порт 8080, обработка ошибок и безопасность.

Бейдж для README

Сообщить о проблеме