yandex-marketing-mcp
This MCP server provides 155 tools for managing Yandex Direct (ad campaigns), Yandex Metrika (analytics), Wordstat (keyword research), and Yandex Webmaster (SEO), with self-configuring OAuth and Yandex Cloud integration.
Authorization & Setup
Configure OAuth client ID, access tokens, and check auth status
Set up Yandex Cloud service accounts and IAM tokens for Wordstat
Yandex Direct — Campaigns & Ads
Create, update, pause, resume, archive/unarchive campaigns with all bidding strategies
Manage ad groups, text ads, dynamic ads, image ads, and shopping ads
Control ad lifecycle: moderate, pause, resume, archive
Yandex Direct — Keywords & Bidding
Add, retrieve, and check search volume of keywords; deduplicate and research keywords
Set manual/automatic bids and manage bid modifiers (device, demographic, regional)
Yandex Direct — Extensions & Negative Keywords
Manage shared negative keyword sets, sitelink sets, and ad extensions/callouts
Yandex Direct — Retargeting & Audiences
Create retargeting lists based on Metrika goals/segments; manage audience targeting conditions
Yandex Direct — Media Assets
Upload/manage ad images, videos, video creatives, product feeds, VCards, and smart ad targets
Yandex Direct — Reporting & Utilities
Generate TSV statistics reports; access reference dictionaries; manage excluded sites and blocked IPs
Update campaign strategies; get client account info; check account changes
Wordstat — Keyword Research
Get top search queries with frequency, regional, and device breakdown
Analyze search dynamics over time; view regional distribution; check API quota
Yandex Metrika — Analytics
Manage counters, goals, segments, filters, access grants, delegates, labels, and annotations
Generate table, time-series, comparison (A vs B), and drilldown reports
Upload offline conversions, calls, advertising expenses, and user parameters
Yandex Webmaster — SEO
Add/manage hosts, run site verification, view diagnostics and SQI history
Monitor indexing history, crawled/in-search page samples, and popular search queries
Manage sitemaps, inspect external backlinks and broken internal links, submit URLs for recrawl
Safety & Multi-Account Features
Read-only mode, confirm mode (preview before execution), sandbox mode for Direct testing
Multi-account support via
client_loginparameter; allowed logins whitelist for access control
Provides tools for configuring Yandex Cloud service accounts and IAM tokens to enable Wordstat keyword analysis and other Yandex marketing services.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@yandex-marketing-mcpcreate a new text campaign in Yandex Direct for summer sale"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
yandex-marketing-mcp
MCP-сервер для управления Яндекс Директом, аналитикой в Яндекс Метрике, подбором ключевых слов через Wordstat и SEO-инструментами Яндекс Вебмастера — с самонастраивающимся OAuth прямо из AI-ассистента.
155 инструментов для полного цикла работы с рекламой и поиском из Claude Code, Cursor, Windsurf и других MCP-клиентов.
Установка
npm install && npm run buildТребуется Node.js 20+.
Related MCP server: ya-metrics-mcp
Подключение к MCP-клиенту
Добавьте в конфигурацию MCP-клиента (например, ~/.claude.json, секция mcpServers):
{
"yandex-marketing": {
"type": "stdio",
"command": "node",
"args": ["F:/projects/yandex-marketing-mcp/build/index.js"]
}
}Поправьте путь к build/index.js под вашу систему.
Авторизация (самонастройка)
Сервер не требует токенов при запуске — он проведёт авторизацию через инструменты. Конфигурация хранится в ~/.yandex-marketing-mcp/config.json и обновляется автоматически. Переменные окружения (YANDEX_OAUTH_CLIENT_ID, YD_OAUTH_TOKEN, YC_FOLDER_ID) читаются один раз при старте как начальные значения — источник правды всегда файл конфигурации.
Шаг 1. Зарегистрируйте OAuth-приложение
Перейдите на https://oauth.yandex.ru/client/new и создайте приложение:
Redirect URI: выберите «Подставить URL для разработки» (
https://oauth.yandex.ru/verification_code)В разделе «Доступ к данным» отметьте следующие скоупы:
direct:api— управление рекламой в Яндекс Директеmetrika:read— чтение данных Метрикиmetrika:write— управление целями и счётчикамиcloud:auth— IAM-токен (для Wordstat больше не работает, см. «Настройка Wordstat» ниже)webmaster:hostview— просмотр данных Вебмастераwebmaster:verify— верификация сайтов в Вебмастере
Сохраните и запомните Client ID
Шаг 2. Сохраните Client ID через инструмент
Вызовите yd_set_client_id с вашим Client ID — инструмент сохранит его и вернёт ссылку для авторизации.
Шаг 3. Получите токен
Откройте ссылку из ответа yd_set_client_id в браузере, подтвердите доступ. После редиректа скопируйте значение параметра access_token из адресной строки.
Шаг 4. Сохраните токен
Вызовите yd_set_token с полученным токеном. Токен проверяется через API Метрики перед сохранением.
Проверка статуса: yd_auth_status — показывает, что настроено, валиден ли токен, и подсказывает следующий шаг. Поле token_valid относится к Директу, Метрике и Вебмастеру; готовность Wordstat показывается отдельно в wordstat_ready.
Шаг 5. Настройка Wordstat — сервисный аккаунт Yandex Cloud
Wordstat ходит через Yandex Cloud и требует IAM-токен. С 1 июня 2026 года Облако не обменивает на IAM пользовательские OAuth-токены, выпущенные начиная с этой даты — запрет привязан к дате выпуска токена, поэтому перевыпуск не помогает. Скоупа cloud:auth теперь недостаточно, нужен сервисный аккаунт.
# ID каталога
yc resource-manager folder list
# Сервисный аккаунт и авторизованный ключ
yc iam service-account create --name wordstat-mcp
yc iam key create --service-account-name wordstat-mcp -o key.jsonПриватный ключ в Облаке не хранится и повторно не выдаётся — если потеряете key.json, придётся создавать новый ключ.
Дальше вызовите yd_set_service_account:
{ "key_file": "~/key.json", "yc_folder_id": "b1g..." }Сервер подпишет JWT (PS256) и сам будет обменивать его на IAM-токен, продлевая по мере истечения. Проверить: yd_wordstat_regions_tree.
Временный вариант, если сервисный аккаунт заводить некогда: yc iam create-token и затем yd_set_iam_token. IAM-токен живёт не больше 12 часов, после чего вызовы упадут — это костыль на один сеанс, не решение.
Сервисному аккаунту нужна роль на каталог для доступа к Wordstat, а к облаку — привязанный платёжный аккаунт. Актуальные названия ролей и тарифы смотрите в документации Yandex Search API: сверьте их в браузере перед первым платным вызовом.
Возможности
Сервис | Инструментов | Описание |
Авторизация | 5 | Self-setup OAuth + сервисный аккаунт Yandex Cloud |
Яндекс Директ (основной) | 46 | Кампании, группы, объявления, ключевики, ставки, корректировки, минус-фразы, сайтлинки, ретаргетинг, изображения, отчёты |
Яндекс Директ (расширенный) | 26 | Визитки, фиды, смарт-таргеты, видео, креативы, площадки, стратегии |
Wordstat | 5 | Частотность запросов, динамика, регионы |
Яндекс Метрика | 43 | Счётчики, цели, сегменты, фильтры, доступы, отчёты, аннотации, офлайн-данные, метки |
Яндекс Вебмастер | 30 | Хосты, верификация, индексирование, поисковые запросы, ссылки, рекроул |
Полный список инструментов
Авторизация
Инструмент | Описание |
| Проверить статус: client_id, токен, folder_id, готовность Wordstat |
| Сохранить Client ID OAuth-приложения и получить ссылку для авторизации |
| Сохранить OAuth access_token (с валидацией через Метрику); опционально — folder_id |
| Настроить сервисный аккаунт Yandex Cloud для Wordstat (key_file или key_json) |
| Временно сохранить готовый IAM-токен из |
Яндекс Директ — Кампании
Инструмент | Описание |
| Список кампаний с фильтрами (тип, статус, ID) |
| Создать текстовую кампанию (все стратегии: PAY_FOR_CONVERSION, WB_MAXIMUM_CLICKS и др.) |
| Обновить настройки кампании (имя, бюджет, минус-фразы, дата окончания) |
| Приостановить / возобновить / архивировать / разархивировать кампанию |
Яндекс Директ — Группы объявлений
Инструмент | Описание |
| Создать группы объявлений в кампании |
| Получить группы по кампании или ID групп |
| Обновить группу (имя, регионы, минус-фразы, UTM-параметры) |
Яндекс Директ — Объявления
Инструмент | Описание |
| Создать текстовые объявления (с сайтлинками и картинками) |
| Обновить текстовые объявления |
| Получить объявления по кампании, группе или ID |
| Модерация / пауза / возобновление / архив объявлений |
| Создать динамическое текстовое объявление |
| Создать графическое объявление (TextImageAd) |
| Создать товарное объявление (v501 API) |
Яндекс Директ — Ключевые фразы
Инструмент | Описание |
| Добавить ключевые фразы в группу |
| Получить фразы по кампании, группе или ID |
| Проверить наличие трафика у фраз (до 10 000) |
| Дедупликация и устранение пересечений фраз |
Яндекс Директ — Ставки
Инструмент | Описание |
| Установить ставки для ключевых фраз |
| Получить ставки и прогнозы трафика |
| Установить ставки (поиск и сеть) |
| Автоматические ставки по целевой позиции |
Яндекс Директ — Корректировки ставок
Инструмент | Описание |
| Добавить корректировки (устройства, демография, регионы) |
| Получить корректировки |
| Обновить корректировки по ID |
| Удалить корректировки |
| Включить / выключить корректировки |
Яндекс Директ — Минус-фразы
Инструмент | Описание |
| Создать набор минус-фраз (общий, до 30 наборов) |
| Получить наборы минус-фраз |
| Обновить набор минус-фраз |
| Удалить набор минус-фраз |
Яндекс Директ — Сайтлинки и уточнения
Инструмент | Описание |
| Создать набор быстрых ссылок (1–8 штук) |
| Получить наборы быстрых ссылок |
| Удалить наборы быстрых ссылок |
| Создать уточнения (callouts, до 25 символов) |
| Получить уточнения |
| Удалить уточнения |
| Привязать уточнения к объявлению (v501) |
Яндекс Директ — Ретаргетинг и аудитории
Инструмент | Описание |
| Создать список ретаргетинга на основе целей Метрики |
| Получить списки ретаргетинга |
| Удалить списки ретаргетинга |
| Добавить аудиторный таргетинг в группу |
| Получить аудиторные таргетинги |
| Удалить аудиторные таргетинги |
Яндекс Директ — Изображения
Инструмент | Описание |
| Загрузить изображения (base64, до 100 за раз) |
| Получить изображения |
| Удалить изображения |
Яндекс Директ — Видео и креативы
Инструмент | Описание |
| Загрузить видео из файла |
| Получить видео |
| Создать видеокреатив |
| Получить креативы |
Яндекс Директ — Фиды
Инструмент | Описание |
| Добавить фид (RETAIL, HOTELS, REALTY, AUTOMOBILES, FLIGHTS, OTHER) |
| Получить фиды |
| Обновить фид |
| Удалить фиды |
Яндекс Директ — Визитки
Инструмент | Описание |
| Создать визитку для кампании |
| Получить визитки |
| Удалить визитки |
Яндекс Директ — Смарт-таргеты
Инструмент | Описание |
| Создать смарт-таргет (фильтр фида) |
| Получить смарт-таргеты |
| Пауза / возобновление / удаление смарт-таргетов |
Яндекс Директ — Площадки и стратегия
Инструмент | Описание |
| Получить список заблокированных площадок |
| Обновить список заблокированных площадок |
| Заблокировать IP-адреса (до 25 шт.) |
| Сменить стратегию ставок, CPA, цель, недельный бюджет |
Яндекс Директ — Отчёты и справочники
Инструмент | Описание |
| Статистика (TSV, любой тип: кампании, группы, объявления, фразы) |
| Справочники (регионы, валюты, категории, временные зоны и др.) |
| Справочник регионов |
| Справочник интересов |
| Проверка изменений с заданной временной метки |
| Информация об аккаунте (баланс, настройки, логин) |
| Организации из Яндекс Бизнеса |
Wordstat API
Инструмент | Описание |
| Популярные запросы с ключевым словом (частотность, регионы, устройства) |
| Динамика частотности по периодам (день / неделя / месяц) |
| Региональное распределение запросов |
| Дерево регионов Wordstat (ID для фильтрации) |
| Квота API Wordstat |
Яндекс Метрика — Счётчики
Инструмент | Описание |
| Список счётчиков |
| Детали счётчика |
| Создать счётчик |
| Обновить счётчик |
| Удалить счётчик |
Яндекс Метрика — Цели
Инструмент | Описание |
| Список целей счётчика |
| Создать цель |
| Обновить цель |
| Удалить цель |
Яндекс Метрика — Сегменты
Инструмент | Описание |
| Список сегментов |
| Создать сегмент |
| Обновить сегмент |
| Удалить сегмент |
Яндекс Метрика — Фильтры
Инструмент | Описание |
| Список фильтров счётчика |
| Создать фильтр (IP, URL, заголовок и др.) |
| Обновить фильтр |
| Удалить фильтр |
Яндекс Метрика — Доступы
Инструмент | Описание |
| Список прав доступа к счётчику |
| Добавить доступ (view или edit) |
| Обновить доступ |
| Удалить доступ |
| Список делегатов (глобальный доступ) |
| Добавить делегата |
| Удалить делегата |
Яндекс Метрика — Отчёты
Инструмент | Описание |
| Табличный отчёт (визиты, пользователи, конверсии, произвольные метрики) |
| Отчёт по времени (группировка: день, неделя, месяц) |
| Сравнение двух периодов (A vs B) |
| Иерархический drilldown |
Яндекс Метрика — Метки и аннотации
Инструмент | Описание |
| Список меток |
| Создать метку |
| Обновить метку |
| Удалить метку |
| Привязать счётчик к метке |
| Отвязать счётчик от метки |
| Список аннотаций на графиках |
| Создать аннотацию |
| Обновить аннотацию |
| Удалить аннотацию |
Яндекс Метрика — Офлайн-данные
Инструмент | Описание |
| Загрузить офлайн-конверсии |
| Статус загрузки конверсий |
| Загрузить данные о звонках |
| Загрузить рекламные расходы |
| Загрузить параметры пользователей |
Яндекс Вебмастер — Хосты
Инструмент | Описание |
| Получить данные текущего пользователя (user_id) |
| Список всех хостов (верифицированных и нет) |
| Добавить хост на верификацию |
| Детали хоста |
| Удалить (отвязать) хост |
| Сводка хоста: SQI и количество проблем |
| Список владельцев хоста |
Яндекс Вебмастер — Верификация
Инструмент | Описание |
| Статус верификации хоста |
| Запустить верификацию (DNS, HTML-файл, мета-тег и др.) |
Яндекс Вебмастер — Диагностика и SQI
Инструмент | Описание |
| Диагностика и список проблем хоста |
| История SQI (Site Quality Index) |
Яндекс Вебмастер — Индексирование
Инструмент | Описание |
| История crawled-страниц |
| Примеры проиндексированных страниц |
| История страниц в поиске |
| Примеры страниц в поиске |
| Примеры страниц, добавленных или удалённых из поиска |
Яндекс Вебмастер — Поисковые запросы
Инструмент | Описание |
| Популярные поисковые запросы (показы, клики, CTR, позиция) |
| Агрегированная история поисковых запросов |
Яндекс Вебмастер — Карты сайта
Инструмент | Описание |
| Карты сайта, известные Яндексу |
| Карты сайта, добавленные пользователем |
| Добавить карту сайта |
| Удалить карту сайта |
Яндекс Вебмастер — Ссылки
Инструмент | Описание |
| Примеры внешних ссылок (бэклинков) |
| История количества внешних ссылок |
| Примеры битых внутренних ссылок |
Яндекс Вебмастер — Рекроул
Инструмент | Описание |
| Отправить URL на переиндексацию |
| Список задач очереди рекроула |
| Статус задачи рекроула |
| Дневная квота рекроула |
| Мониторируемые важные страницы |
Переменные окружения
Все переменные опциональны — сервер запускается без них и проведёт настройку через инструменты.
Переменная | Описание |
| Client ID OAuth-приложения (seed; сохраняется через |
| OAuth access_token (seed; сохраняется через |
| ID каталога Yandex Cloud для Wordstat (seed; сохраняется через |
| ID сервисного аккаунта Yandex Cloud (seed; сохраняется через |
| ID авторизованного ключа сервисного аккаунта (seed) |
| Приватный ключ сервисного аккаунта в PEM (seed) |
| Готовый IAM-токен из |
|
|
| Логин клиента по умолчанию (для агентских аккаунтов) |
|
|
|
|
| Белый список логинов клиентов через запятую (только для инструментов Директа) |
|
|
| Путь к лог-файлу (пусто — только stderr, файл не создаётся) |
|
|
Режимы безопасности
Read-only (
YD_READONLY=true) — агент видит и анализирует данные, но физически не может создать, изменить или удалить кампании, ставки, счётчики или цели.Confirm-режим (
YD_CONFIRM=true) — любой изменяющий вызов сначала возвращает превью операции; для выполнения нужно повторить вызов сconfirm=true.Мульти-аккаунт — инструменты Директа принимают необязательный аргумент
client_login;YD_ALLOWED_LOGINSограничивает доступные логины.Partial-success — изменяющие ответы Директа разбираются на per-item
Errors/Warningsи сводятся в поле_partial_success.Логи — файл создаётся только при заданном
YD_LOG_FILE; тела запросов пишутся только приYD_LOG_BODIES=true.
Лицензия
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityCmaintenanceUnified MCP server for managing Meta Ads, LinkedIn Ads, Google Ads, GA4, and Search Console with 89 read/write tools, multi-account support, OAuth setup, and safe dry-run mutations.Last updatedMIT
- AlicenseCqualityCmaintenanceMCP server for Yandex Metrika analytics, enabling AI assistants to access traffic, content, demographics, conversion, e-commerce, and drill-down reports.Last updated312MIT
- Alicense-qualityDmaintenanceMCP server for Yandex Direct, Metrika, Wordstat, and Webmaster APIs, providing 132 tools to manage advertising campaigns, analytics, keyword research, and reporting through any MCP-compatible client.Last updated56MIT
- AlicenseCqualityCmaintenanceMCP server that provides 46 tools for managing Yandex Webmaster API v4, enabling site management, sitemaps, indexing, search analytics, and more through natural language.Last updated46543MIT
Related MCP Connectors
MCP for Yandex Direct: manage ad campaigns & analytics from Claude or ChatGPT
Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.
Manage Google, Meta, Amazon, TikTok, LinkedIn & ChatGPT ads. 430 tools for campaigns & analytics.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/skiddgoddamn/yandex-marketing-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server