yandex-tools-mcp
Пять MCP-серверов для Вордстата, Поиска, Вебмастера, Метрики и Директа плюс плагин Claude Code со скиллами подбора ключей и анализа конкурентов
Установка
claude --plugin-dir /path/to/yandex-tools-mcpЗапуск всех пяти серверов как плагина со скиллами. Ключи задайте переменными окружения до запуска.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Набор из пяти отдельных npm-пакетов дает агенту API Яндекса. Вордстат показывает популярные запросы, динамику и распределение по регионам, Поиск возвращает выдачу, Вебмастер отдает данные об индексации и запросах сайта, Метрика дает статистику трафика. Сервер Директа читает кампании, группы, объявления, фразы, ставки и отчеты, а также создает и меняет кампании, объявления, фразы и ставки. Все пакеты можно поставить одним плагином Claude Code, в котором есть скиллы для подбора ключевых слов и разбора конкурентов в выдаче.
Для кого. Для SEO-специалистов и специалистов по контекстной рекламе, работающих с Яндексом.
Подходит, если
- Нужно собрать семантику и частотности из Вордстата прямо в диалоге с агентом
- Нужно посмотреть, какие сайты стоят в выдаче Яндекса по запросам
- Нужно получить отчет по кампаниям Директа или трафику из Метрики
Не подходит, если
- Не готовы давать агенту OAuth-токен Директа с доступом к боевому аккаунту
- Нужны Аудитории или другие сервисы Яндекса, которых нет в наборе
Пример запроса к агенту
Собери через Вордстат топ запросов по теме «ремонт квартир» в Санкт-Петербурге и покажи, растет ли спрос за последний годОграничения
Вордстат и Поиск требуют ключа API и идентификатора каталога в Yandex Cloud, где эти API платные. Вебмастер, Метрика и Директ работают по OAuth-токенам, для Директа нужно свое приложение с доступом к API. Сервер Директа по умолчанию работает с песочницей, реальные кампании меняются только после YANDEX_DIRECT_LIVE=1.
Как отключить. Удалите блоки yandex-* из конфигурации MCP клиента или перестаньте запускать Claude Code с --plugin-dir, затем отзовите OAuth-токены в настройках Яндекс ID.
MCP
- Транспорт
- stdio
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| YANDEX_SEARCH_API_KEY секрет | Ключ API Yandex Cloud для Поиска и Вордстата |
| YANDEX_FOLDER_ID | Идентификатор каталога Yandex Cloud |
| YANDEX_WEBMASTER_TOKEN секрет | OAuth-токен Вебмастера |
| YANDEX_METRIKA_TOKEN секрет | OAuth-токен Метрики |
| YANDEX_DIRECT_TOKEN секрет | OAuth-токен с доступом к API Директа |
| YANDEX_DIRECT_LIVE | Значение 1 переключает Директ с песочницы на боевой аккаунт |
| YANDEX_DIRECT_LOGIN | Логин клиента для агентских аккаунтов |
Проверка безопасности
- В боевом режиме Директа создает кампании, меняет бюджеты и ставки, то есть тратит деньги
- Хранит OAuth-токены и ключ Yandex Cloud
Коротко о README
README на английском и русском перечисляет пять пакетов с готовыми блоками конфигурации для npx и нужными переменными. Отдельно описан запуск всех серверов как плагина Claude Code и два встроенных скилла. В README пакета Директа есть предупреждение о реальных тратах, порядок получения OAuth-токена и таблица инструментов с пометками чтения и записи. Лицензия MIT.
Частые вопросы
Может ли агент потратить деньги в Директе?
Да, если включить боевой режим переменной YANDEX_DIRECT_LIVE=1: инструменты создают кампании, меняют бюджеты и ставки. Без нее все изменения идут в песочницу.
Можно ли поставить только Вордстат?
Да, каждый сервер ставится отдельным npm-пакетом со своим блоком конфигурации.
Похожие
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов
Набор скиллов Claude Code для аудита сайта под AI-поиск: цитируемость, доступ AI-краулеров, llms.txt, разметка и отчеты
Экспериментальный официальный MCP-сервер Google Analytics 4: отчеты, воронки и данные реального времени по запросу агенту
Google Search Console MCP
Google Search Console MCP Server for SEOs
MCP-сервер для Google Search Console: запросы и страницы с кликами и позициями, проверка индексации URL, сайтмапы и готовые SEO-скиллы