SkillFoxx

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

  • 0 ★ on the repository
  • Last commit
  • MIT
Skill

Broad access

Why this level

  • The script can perform real writes to Direct with the --execute flag, including creating ads and campaigns
  • It requires a Direct token with access to the live account
  • Review the payload in preview mode first and confirm campaigns are created stopped
All reasons and checks
Russian stack

shelpakovzhenya-art/yandex.directAuthor:shelpakovzhenya-art

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/yandex-direct

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The script can perform real writes to Direct with the --execute flag, including creating ads and campaigns
  • It requires a Direct token with access to the live account
  • Review the payload in preview mode first and confirm campaigns are created stopped

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

What it does

The $yandex-direct skill guides an agent through the full Direct advertising cycle: gathers demand via Wordstat v2 with associations and seasonality, keeps measured data separate from hypotheses, designs Unified Performance Campaign structure splitting Search, YAN, brand and remarketing, generates combinatorial ResponsiveAd creatives (up to 7 headlines and 3 texts), checks moderation and landing-page match, builds a measurement plan via Metrika goals, CPA and ad spend ratio, and designs A/B tests. The yandex_direct_toolkit.py script can call the Wordstat and Direct APIs directly with no third-party Python packages, but every call defaults to preview: an actual write to Direct needs the --execute flag and a separate confirmation token printed by the preview.

Who it is for. For PPC specialists who want to run a Direct launch from demand research to live ads through an agent, with a checkpoint at every step.

Good fit when

  • You need the full cycle: demand, campaign structure, ads, moderation, measurement
  • You need explicit confirmation before every live write to Direct
  • You need combinatorial ResponsiveAd creatives for API v501

Not a fit when

  • You need a strictly read-only audit with no chance of real writes: writes are part of this skill's design
  • You lack Wordstat v2 and Direct API tokens: without them the skill only gives advice, not real data

Example request

Gather demand data for greenhouse installation in the Moscow region, design a Unified Performance Campaign and prepare combinatorial ads without publishing

Limitations

Wordstat tokens (YANDEX_SEARCH_API_KEY, YANDEX_FOLDER_ID) and a Direct token (YANDEX_DIRECT_TOKEN) must be set up separately and never committed. Paid Wordstat calls and live writes to Direct each require their own confirmation token. The skill does not guarantee sales or beating competitors; it only strengthens the controllable parts: demand quality, relevance and iteration speed.

How to disable. Delete the skills/yandex-direct folder from your agent's skills directory.

FAQ

Can the skill publish a campaign right away?

No, all Wordstat and Direct calls default to preview; a live write needs the --execute flag and a separate confirmation token.

Are third-party Python packages needed?

No, the yandex_direct_toolkit.py script calls Wordstat v2 and the Direct API directly.

How is the full-cycle Yandex Direct skill different from other Direct skills?

The $yandex-direct skill takes the agent through the whole ad cycle: semantics via Wordstat v2 with associations and seasonality, separating measured data from hypotheses, campaign structure, unified performance campaigns, combinatorial ads, moderation, Metrika and API batches with a dry-run mode.

Can the skill publish a campaign right away and do I need third-party Python packages?

Dry-run batches first show what will change, and you confirm publishing yourself. Install with npx skills add shelpakovzhenya-art/yandex.direct, a skill for Codex. See the README for Python requirements. Risk is high because it works with an ad budget.

Discussion

No questions or reviews yet.

All Yandex Direct tools

Yandex Direct search campaign builder skill

Yandex Direct Campaign Builder

Russian stack

An Agent Skill for the full cycle of a Yandex Direct search campaign: from Wordstat and keywords to launch and optimization

SkillExtended access

Yandex Direct planning and audit skill

Yandex Direct Skill for Codex and AI agents

Russian stack

A read-only Codex skill: Unified Performance Campaign structure, Search and YAN, negatives, moderation, strategies and Metrika goals, without API access

SkillMinimal access
Russian stack

A Codex and Claude Code plugin with skills and MCP for Yandex Direct, Metrika, Wordstat v2, Roistat, amoCRM and Yandex Search API

PluginBroad access21
Russian stack

A skill for auditing and running Yandex Direct campaigns via API v5: 55 checks, an A-F grade, ad creation and reports

SkillBroad access64
Russian stack

A skill that takes a new Yandex Direct campaign from brief to a draft in the account: keywords, negatives, ads, Metrika goals and bids

SkillBroad access14
Russian stack

An MCP server for Yandex Direct, Metrica, Wordstat and Audience analytics: raw reports, data joins and an HTML dashboard

MCP serverExtended access9

README in short

The bilingual README describes ten skill modes: demand research, intent checking, competitor analysis, Unified Performance Campaign architecture, combinatorial ads, landing pages, moderation, Metrika and optimization, A/B testing, and safe API access. It shows install via npx skills add, example toolkit-script runs for package validation and payload building, required environment variables, and verification commands via unittest.

README badge

Original SKILL.md

---
name: yandex-direct
description: >-
  Планирует, создает, проверяет и оптимизирует кампании Яндекс Директа:
  Wordstat-семантика, интенты, ЕПК, комбинаторные объявления, минус-фразы,
  посадочные, Метрика, эксперименты и безопасные API-пакеты. Использовать для
  запуска, аудита или масштабирования Яндекс Директа; не использовать как
  обещание гарантированных продаж.
---

# Yandex Direct Growth Engine

Управляй не кликами, а проверяемой экономикой: целевые конверсии, прибыль,
маржа, ДРР/CPA и качество лидов. Не обещай результат, который зависит от
аукциона, оффера, сайта или внешнего спроса.

## Неподвижные правила

- Перед исследованием установи продукт, географию, тип клиента, целевое действие,
  маржу/допустимый CPA, бюджет, URL и факты, которые можно подтвердить на сайте.
- Не выдумывай частотность, цены, сроки, отзывы, рейтинги, гарантии и преимущества.
- Перед live-записью покажи точный payload, окружение, объекты, бюджет и последствия;
  получи отдельное явное подтверждение. Создавай новые кампании остановленными.
- Не меняй ставки, бюджеты, стратегии, статусы и минус-фразы live-аккаунта как
  побочный эффект аудита. Чтение аккаунта не разрешает запись.

Report a problem