yandex-direct-manager skill
A skill that takes a new Yandex Direct campaign from brief to a draft in the account: keywords, negatives, ads, Metrika goals and bids
- 12 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- 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
Install
- Works in
- Services
Manual 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/install.py installs dependencies and checks module imports.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- 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
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.
Good fit when
- You need keywords and negatives for a new campaign
- You need ads written within Direct character limits
- You need to create a campaign in the account from an agreed plan
Not a fit when
- You need analytics or optimization of running campaigns
- Your Direct account is not connected to click.ru and you have no other MCP
Example request
Build a Yandex Direct campaign for flower delivery in Moscow with a monthly budget of 100 thousand rublesLimitations
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.
FAQ
Will the campaign go live by itself?
No, it is created as a draft after preview and confirmation. Launching stays with the marketer.
Where does cost per click come from?
In order: similar campaigns in the account, the live auction, a mask forecast, a niche reference, then the marketer's value. The source is saved in the step file.
Discussion
No questions or reviews yet.
Related
All Yandex Direct toolsYandex Direct search campaign builder skill
Yandex Direct Campaign Builder
An Agent Skill for the full cycle of a Yandex Direct search campaign: from Wordstat and keywords to launch and optimization
A skill for auditing and running Yandex Direct campaigns via API v5: 55 checks, an A-F grade, ad creation and reports
Yandex Direct full-cycle skill
yandex.direct
A skill for running Direct: Wordstat demand research, Unified Performance Campaigns, combinatorial ads, moderation, Metrika and safe dry-run API payloads
Yandex Direct skill with CPA optimization
Yandex.Direct Skill для Claude Code
A dependency-free Python skill that builds Direct campaigns from a blueprint, pulls leads from Metrika and optimizes bids toward a target CPA or ROI
End-to-end Yandex Direct audit skill
ya-direct-codex
An Agent Skill for full Yandex Direct audit, optimization and API v5 work: search, the ad network, Unified Performance, strategies and attribution
An MCP server for Yandex Direct, Metrica, Audiences and Wordstat with read-only mode and change confirmation
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.
README badge
Original 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: маркетолог]`, а они здесь не формальность: заливка идёт только после явного «ОК».