MCP для Wordstat на Go со своим OAuth
yandex-wordstat-mcp
MCP-сервер на Go для Яндекс Wordstat с тремя инструментами и встроенным OAuth-сервером для защиты удаленного доступа
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает статистику запросов Wordstat, ничего не меняет во внешних системах
Установка
Ручная установка
go build -o yandex-wordstat-mcp ./cmd/yandex-wordstat-mcpСборка из исходников, перед запуском задайте YANDEX_API_KEY и YANDEX_FOLDER_ID.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает три инструмента: топ запросов с опциями точной словоформы и фиксированного порядка фраз, динамику частоты по дням, неделям или месяцам за период и полное дерево регионов 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 в репозитории отсутствует
Пример запроса к агенту
Покажи динамику запроса «ремонт квартир» по месяцам за последний годОграничения
Репозиторий без README и без звезд, автор один. Установка возможна только сборкой из исходников на Go, готового бинарного релиза не описано. OAuth-слой добавляет сложность настройки для тех, кому нужен только простой локальный запуск.
Как отключить. Остановите процесс сервера и удалите его из конфигурации MCP клиента.
MCP
- Транспорт
- http
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| YANDEX_API_KEY обязательная, секрет | Ключ Yandex Search API для Wordstat |
| YANDEX_FOLDER_ID обязательная | Folder id Yandex Cloud |
Проверка безопасности
- Только читает статистику запросов Wordstat, ничего не меняет во внешних системах
Коротко о README
README отсутствует. Описание составлено по коду: go.mod указывает официальный modelcontextprotocol/go-sdk, main.go регистрирует три инструмента (top, dynamics, region tree) и поднимает HTTP-сервер с защищенным OAuth-обработчиком на /mcp и health-check на /healthz, oauth.go реализует authorization code с PKCE и хранение клиентов и токенов в памяти процесса.
Частые вопросы
Есть ли инструмент по регионам показов?
Нет, только дерево регионов wordstat_regions_tree, отдельного инструмента распределения показов по регионам в коде нет.
Зачем нужен встроенный OAuth?
Он защищает HTTP-эндпоинт /mcp отдельной авторизацией клиентов, а не полагается только на ключ Yandex в переменных окружения.
Похожие
Скиллы DataLens
DataLens Skills
Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов