Yandex Direct MCP

Install

/plugin marketplace add etopro/plugin-marketplace
/plugin install yandex-direct@plugin-marketplace

This is third-party code. Review the repository files before installing.

What it does

The plugin installs a local MCP server built on direct-cli that covers most of the Direct API: campaigns, ad groups, ads, keywords and negative keywords, bids and modifiers, strategies, retargeting, feeds, reports, Metrica goals, Wordstat and budget forecasts. Finance operations are included: balance, top-ups, invoices and transfers between accounts. Three skills help manage campaigns, write ads within character limits and run exploratory stats analysis. The tool set can be narrowed with a profile such as analytics only, and Campaign Masters are read through a Playwright-driven browser.

Who it is for. For PPC specialists and business owners who run Yandex Direct campaigns.

Example request

Show campaigns for the last week and find ads where a lead costs more than 1500 rubles

Limitations

Before first login you must create a Yandex OAuth app with direct:api access and get your API application approved in Direct, otherwise requests return incomplete_registration. Python 3.11 is required. Campaign Masters need Playwright, Chromium and a manual terminal login. Unofficial plugin.

How to disable. Uninstall the yandex-direct plugin via /plugin. Saved auth lives in ~/.direct-cli/, and the Masters profile is removed with direct masters logout.

Security check

• Changes bids, budgets and campaign states in an ad account
• Includes finance operations: top-ups, invoices and transfers between accounts
• Stores a Yandex OAuth token and a live session

README in short

The Russian README starts with plugin marketplace install and Yandex login. It lists capability groups, sample prompts and ways to connect Claude Code, Codex and other MCP clients. It details creating the OAuth app and API application, profiles that limit tools, and separate browser auth for Campaign Masters. It ends with a skills table and development commands. MIT licensed.

SKILL.md

---
name: direct-ads
description: "Написание рекламных объявлений для Яндекс.Директ. Используется когда пользователь просит написать, улучшить или проверить текст объявления, заголовки, или тексты для контекстной рекламы."
user-invocable: true
argument-hint: "[тема или описание рекламируемого продукта/услуги]"
---

# Написание объявлений Яндекс.Директ

Скилл для создания эффективных рекламных объявлений в Яндекс.Директ.

## Лимиты символов

| Элемент | Максимум символов |
|---|---|
| Title (Заголовок) | 35 |
| Title2 (Второй заголовок) | 30 |
| Text (Текст объявления) | 81 |

## Правила написания

### Заголовок (Title)
- Начинайте с главного предложения или УТП
- Используйте цифры и конкретику: "Скидка 30%", "Доставка за 30 мин"
- Включите гео если релевантно: "Пицца Москва"

### Второй заголовок (Title2)
- Дополняйте первый заголовок
- Добавьте призыв к действию: "Закажите сейчас"
- Укажите дополнительные преимущества

### Текст объявления
- Подробности о предложении
- Условия доставки/оплаты
- Гарантии и преимущества
- Не повторяйте то, что уже в заголовках

Related