SkillFoxx
Telegram

MCP для Wordstat на Go со своим OAuth

yandex-wordstat-mcp

MCP-сервер на Go для Яндекс Wordstat с тремя инструментами и встроенным OAuth-сервером для защиты удаленного доступа

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

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

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

  • Запускает HTTP-сервер на Go, который по ключу Yandex Search API читает статистику Вордстата
  • Эндпоинт /mcp закрыт собственным слоем OAuth, ничего не меняет во внешних системах
Все причины и проверки
Российский стек

bogachenko/yandex-wordstat-mcpАвтор:bogachenko

Похожий инструмент с большим сообществом: Яндекс Вордстат MCP, 9 ★ репозитория

Установка

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

go build -o yandex-wordstat-mcp ./cmd/yandex-wordstat-mcp

Сборка из исходников, перед запуском задайте YANDEX_API_KEY и YANDEX_FOLDER_ID.

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

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

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

  • Запускает HTTP-сервер на Go, который по ключу Yandex Search API читает статистику Вордстата
  • Эндпоинт /mcp закрыт собственным слоем OAuth, ничего не меняет во внешних системах

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

Что делает

Сервер дает три инструмента: топ запросов с опциями точной словоформы и фиксированного порядка фраз, динамику частоты по дням, неделям или месяцам за период и полное дерево регионов Wordstat. Написан на Go с использованием официального modelcontextprotocol/go-sdk, поднимает Streamable HTTP MCP на /mcp и health-check на /healthz. У сервера есть собственный встроенный OAuth 2.0 слой с authorization code, PKCE и динамической регистрацией клиентов, который защищает эндпоинт /mcp отдельно от ключа Yandex. Ключ и folder id Yandex задаются переменными окружения и обязательны при старте.

Для кого. Для тех, кому нужен самостоятельно хостящийся сервер Wordstat на Go с защитой доступа отдельным OAuth-слоем

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

  • Нужен компактный бинарь на Go без рантайма Node или Python
  • Нужен удаленный HTTP MCP-сервер, закрытый собственной OAuth-авторизацией
  • Достаточно базовых операций: топ, динамика, дерево регионов

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

  • Нужно распределение показов по регионам как отдельный инструмент: его здесь нет
  • Нужна готовая документация по установке: README в репозитории отсутствует

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

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

MCP

Транспорт
http
Авторизация
OAuth

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

YANDEX_API_KEY обязательная, секрет
Ключ Yandex Search API для Wordstat
YANDEX_FOLDER_ID обязательная
Folder id Yandex Cloud

Ограничения

Репозиторий без README и без звезд, автор один. Установка возможна только сборкой из исходников на Go, готового бинарного релиза не описано. OAuth-слой добавляет сложность настройки для тех, кому нужен только простой локальный запуск.

Как отключить. Остановите процесс сервера и удалите его из конфигурации MCP клиента.

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

Есть ли инструмент по регионам показов?

Нет, только дерево регионов wordstat_regions_tree, отдельного инструмента распределения показов по регионам в коде нет.

Зачем нужен встроенный OAuth?

Он защищает HTTP-эндпоинт /mcp отдельной авторизацией клиентов, а не полагается только на ключ Yandex в переменных окружения.

Обсуждение

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

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

Компактный MCP-сервер на официальном SDK для пяти операций Яндекс Wordstat: топ, динамика, регионы, дерево регионов, данные аккаунта

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

MCP-сервер только для чтения статистики Яндекс Вордстата: топ фраз, динамика, регионы, с OAuth-входом для ChatGPT

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

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

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

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

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

MCP-сервер на Bun для официального Yandex Wordstat API v2 с учетом стоимости запросов и лимитами расходов в рублях

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

Коротко о README

README отсутствует. Описание составлено по коду: go.mod указывает официальный modelcontextprotocol/go-sdk, main.go регистрирует три инструмента (top, dynamics, region tree) и поднимает HTTP-сервер с защищенным OAuth-обработчиком на /mcp и health-check на /healthz, oauth.go реализует authorization code с PKCE и хранение клиентов и токенов в памяти процесса.

Бейдж для README

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