yandex-direct-manager

Install

git clone https://github.com/ai-hub-open/yandex-direct-manager.git
cd yandex-direct-manager
python install.py
cp -r yandex-direct-manager ~/.claude/skills/

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

What it does

The skill walks the agent through ten campaign-building steps and saves a file per step, so work resumes after a dropped session. The agent gathers a brief, builds keyword masks and checks volumes in Wordstat, expands and clusters keywords, designs a unified campaign structure and three levels of negatives. It then sets up Metrika goals, writes ads checked against Direct limits, prepares a bidding strategy and, after a dry-run preview, creates the campaign as a draft. Cost per click comes from account history, the auction or a forecast with the source recorded, and at checkpoints the agent waits for the marketer's decision.

Who it is for. For marketers and PPC specialists launching new Yandex Direct campaigns.

Example request

Build a Yandex Direct campaign for flower delivery in Moscow with a monthly budget of 100 thousand rubles

Limitations

The skill only creates a new campaign and does not manage it afterwards. Direct and Wordstat go through click.ru hosted MCP servers, which need a click.ru API token and only cover accounts connected in click.ru. Scripts need Python 3.9; without code execution some checks become manual. The project is pre-1.0 and steps may change.

How to disable. Delete the yandex-direct-manager folder from ~/.claude/skills and remove the MCP servers with python -m scripts.setup_yandex_direct_mcp using the --remove flag.

Security check

• Creates campaigns, ads, bids and Metrika goals in a live ad account
• Sends the click.ru token and account data through third-party hosted MCP servers

README in short

The Russian README describes the skill's contract: a brief and account access in, a campaign and justification files out. A route table lists steps and artifacts, with separate notes on CPC sources, image upload and checkpoints. Installation uses install.py and copying into the skills folder, and MCP is connected by a script with a click.ru token. Apache 2.0 licensed.

SKILL.md

---
name: yandex-direct-manager
description: Тактический пайплайн создания рекламной кампании в Яндекс.Директе через MCP — сбор семантики через Wordstat, кластеризация на НЧ/СЧ/ВЧ и Поиск/РСЯ, минусация (3 уровня + кросс), создание объявлений по лимитам Директа, настройка целей в Метрике, выбор стратегии торгов и заливка в DRAFT. Используй когда пользователь говорит «сделай РК в Директе», «собери семантику», «нужны ключи и минусы», «напиши объявления», «запусти кампанию», «залей через MCP». Не для аналитики, не для оптимизации работающих кампаний, не для стратегии бренда — только создание новой кампании от брифа до DRAFT.
---

# Yandex Direct — пайплайн создания кампании

Скилл проводит маркетолога от брифа до залитой в **DRAFT** рекламной кампании в Яндекс.Директе. Фокус — только **создание**: семантика → кластеризация → минусы → объявления → заливка. Аналитика, оптимизация уже работающих кампаний, исследования рынка — **не задача этого скилла**.

Пайплайн опирается на два MCP: `yandex-direct` (прогноз CPC, аудит аккаунта, дедупликация, заливка кампании целиком) и `yandex-wordstat` (частотности и сбор семантики на Шагах 1 и 3). Оба — **хостовые серверы aihub.click.ru**: локально ничего не запускается, Bun и клон репозитория не нужны. Подключение — `scripts/setup_yandex_direct_mcp.py` (пишет конфиги Cursor / Claude Code / Claude Desktop), общий справочник — `docs/hosted-mcp-setup.md` репозитория пакета. Скилл не проверяет подключение MCP заранее — если на каком-то шаге инструмент не отвечает, обрабатываем ошибку по месту: Шаг 2 уходит на справочник CPC, Шаги 1 и 3 — на `scripts/wordstat_api.py` или браузер, Шаг 10 — на Директ Коммандер.

## Что нужно от среды

**Обязательный минимум — две способности:**

- **Чтение и запись файлов** в рабочей папке `direct-campaigns/<slug>/`. На этом держится весь пайплайн: каждый шаг порождает артефакт, следующий шаг его читает.
- **Диалог с пользователем** — задать вопрос, получить ответ, дождаться подтверждения. Без этого не работают гейты `[GATE: маркетолог]`, а они здесь не формальность: заливка идёт только после явного «ОК».

Related