# Документация Яндекс Директ (Markdown)

<div align="center">

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/badge/%D0%AF%D0%BD%D0%B4%D0%B5%D0%BA%D1%81_%D0%94%D0%B8%D1%80%D0%B5%D0%BA%D1%82-docs-FFCC00?style=for-the-badge&logo=yandex&logoColor=black">
  <img alt="Yandex Direct Docs" src="https://img.shields.io/badge/%D0%AF%D0%BD%D0%B4%D0%B5%D0%BA%D1%81_%D0%94%D0%B8%D1%80%D0%B5%D0%BA%D1%82-docs-FFCC00?style=for-the-badge&logo=yandex&logoColor=black">
</picture>

[![Страниц](https://img.shields.io/badge/pages-509-blue?style=flat-square)]() [![Язык](https://img.shields.io/badge/lang-ru-green?style=flat-square)]() [![Обновлено](https://img.shields.io/badge/updated-2026--02--11-orange?style=flat-square)]() [![Agent Skill](https://img.shields.io/badge/agent_skill-SKILL.md-8A2BE2?style=flat-square)](SKILL.md) [![Release](https://img.shields.io/github/v/release/VKirill/yandex-direct-docs?style=flat-square&color=brightgreen)](https://github.com/VKirill/yandex-direct-docs/releases/latest)

[![Скачать ZIP](https://img.shields.io/badge/%E2%AC%87%EF%B8%8F_Download_ZIP-Claude_Chat-FF6B35?style=for-the-badge)](https://github.com/VKirill/yandex-direct-docs/releases/download/v1.0.0/yandex-direct-skill.zip) [![Скачать MD](https://img.shields.io/badge/%E2%AC%87%EF%B8%8F_Download_MD-Claude_Chat-FF6B35?style=for-the-badge)](https://github.com/VKirill/yandex-direct-docs/releases/download/v1.0.0/yandex-direct-skill.md)

[![Telegram](https://img.shields.io/badge/%D0%9F%D0%BE%D0%BC%D0%BE%D0%B3%D0%B0%D0%B9_%D0%9C%D0%B0%D1%80%D0%BA%D0%B5%D1%82%D0%B8%D0%BD%D0%B3-Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/pomogay_marketing)

</div>

---

Полная документация **Яндекс Директа** на русском языке в формате Markdown. Автоматически получена с [yandex.ru/support/direct/ru/](https://yandex.ru/support/direct/ru/) по официальному sitemap.xml.

**509 статей** с внутренними ссылками, структурированные по разделам. Подходит для:
- Справочника по контекстной рекламе Яндекса
- Базы знаний для AI-агентов и чат-ботов (Claude Code, Cursor, Windsurf, Kimi и др.)
- Интеграции с [context7](https://context7.com) и другими инструментами документации
- [Agent Skill](https://agentskills.io) — готовый скилл `SKILL.md` для подключения к любому AI-агенту
- Обучения и быстрого поиска информации

## Навигация по разделам

### Кампании и инструменты

| Раздел | Описание |
|--------|----------|
| [Единая перфоманс-кампания](docs/unified-performance-campaign/about.md) | Основной тип для performance-задач — настройка, каталоги, нейро-объявления |
| [Мастер кампаний](docs/campaign-master/about.md) | Упрощённый интерфейс создания кампаний — сайт, товары, Telegram, маркетплейсы |
| [Товарная кампания](docs/product-campaign/create.md) | Продвижение товаров из каталога через фиды |
| [Продвижение приложений](docs/products-mobile-apps-ads/about.md) | Мобильная реклама iOS/Android — создание, трекеры, кросс-платформа |
| [Продвижение организаций](docs/company-ads/create.md) | Карточки компаний в Картах и поиске |
| [Реклама в Telegram](docs/telegram-ads/create.md) | Размещение объявлений в телеграм-каналах партнёров РСЯ |
| [DOOH](docs/dooh/) | Цифровая наружная реклама |

### Охватная и медийная реклама

| Раздел | Описание |
|--------|----------|
| [Медийные кампании (CPM)](docs/products-cpm-campaign/about.md) | Оплата за показы, жанры и тематики, ретаргетинг |
| [Видеообъявления](docs/products-cpm-campaign-video/about.md) | Видеореклама — создание, карусель, ретаргетинг |
| [Видеобаннеры](docs/products-cpm-campaign-videobanner/about.md) | Баннеры с видео — конструктор, форматы |
| [Реклама на главной Яндекса](docs/products-cpm-campaign-frontpage/about.md) | Баннеры на ya.ru |
| [Connected TV](docs/products-cpm-campaign-connected-tv/about.md) | Реклама на Smart TV |
| [Фиксированные CPM-размещения](docs/fixed-cpm-campaigns/products-fixed-cpm.md) | Премиальные баннеры, брендинг, billboard |

### Стратегии показов

| Стратегия | Описание |
|-----------|----------|
| [Выбор стратегии](docs/strategies/select-strategy.md) | Обзор всех стратегий и рекомендации по выбору |
| [Максимум конверсий](docs/strategies/average-cpa.md) | Оптимизация по CPA — целевая цена конверсии |
| [Максимум кликов](docs/strategies/average-cpc.md) | Оптимизация по CPC — максимум трафика |
| [Максимум прибыли](docs/strategies/maximum-profit.md) | Оптимизация рентабельности (ROAS) |
| [Ручное управление](docs/strategies/manual-strategy.md) | Назначение ставок вручную |
| [Портфельные стратегии](docs/strategies/portfolio-strategy.md) | Управление группой кампаний |
| [Приоритетные цели](docs/strategies/priority-goals.md) | Настройка целей для оптимизации |
| [Бюджеты в стратегиях](docs/strategies/budgets-in-strategies.md) | Работа с бюджетами |

### Таргетинги и ключевые фразы

| Раздел | Описание |
|--------|----------|
| [Ключевые фразы](docs/keywords/keywords.md) | Основы подбора ключевых фраз |
| [Минус-фразы](docs/keywords/negative-keywords.md) | Исключение нецелевых запросов |
| [Операторы и символы](docs/keywords/symbols-and-operators.md) | Специальные операторы для точного соответствия |
| [Вордстат](docs/keywords/wordstat.md) | Инструмент подбора слов |
| [Автотаргетинг](docs/impression-criteria/autotargeting.md) | Автоматический подбор аудитории |
| [Ретаргетинг](docs/impression-criteria/retargeting-lists.md) | Возврат посетителей сайта |
| [Офферный ретаргетинг](docs/impression-criteria/offer-retargeting.md) | Ретаргетинг по товарам из фида |
| [Геотаргетинг](docs/efficiency/geotargeting.md) | География показов |
| [Временной таргетинг](docs/efficiency/timetargeting.md) | Расписание показов |

### Эффективность объявлений

| Раздел | Описание |
|--------|----------|
| [Как улучшить объявления](docs/efficiency/improve-your-ads.md) | Общие рекомендации |
| [Тексты и заголовки](docs/efficiency/text-and-title.md) | Написание эффективных объявлений |
| [Изображения](docs/efficiency/images.md) | Требования и рекомендации |
| [Видео](docs/efficiency/video.md) | Видеодополнения |
| [Быстрые ссылки](docs/efficiency/quick-links.md) | Дополнительные ссылки в объявлении |
| [Карусель](docs/efficiency/carousel.md) | Несколько карточек в одном объявлении |
| [Турбо-страницы](docs/efficiency/turbo-pages.md) | Быстрые лендинги |

### Фиды

| Раздел | Описание |
|--------|----------|
| [О фидах](docs/feeds/about.md) | Обзор и назначение |
| [Типы фидов](docs/feeds/types.md) | Доступные форматы |
| [Требования](docs/feeds/requirements.md) | Технические требования |
| [YML формат](docs/feeds/requirements-yml.md) | Формат Яндекс Маркета |
| [Валидация](docs/feeds/validate.md) | Проверка фида |

### Статистика и отчёты

| Раздел | Описание |
|--------|----------|
| [Обзор статистики](docs/statistics/overview.md) | Основные метрики |
| [Мастер отчётов](docs/statistics/report-wizard.md) | Построение отчётов |
| [Поисковые запросы](docs/statistics/search-queries.md) | Анализ запросов |
| [Конверсии](docs/statistics/conversions.md) | Отслеживание целей |
| [UTM-метки](docs/statistics/url-tags.md) | Параметры URL |
| [Модели атрибуции](docs/statistics/attribution-model.md) | Определение источника конверсий |

### Оплата

| Раздел | Описание |
|--------|----------|
| [Способы оплаты](docs/payments/payment-methods.md) | Все способы пополнения |
| [Промокоды](docs/payments/promocode.md) | Активация промокодов |
| [Возврат средств](docs/payments/refund.md) | Процедура возврата |
| [Отсрочка платежа](docs/payments/deferred-payment.md) | Кредитная линия |
| [Общий счёт](docs/payments/shared-account.md) | Управление бюджетом нескольких кампаний |

### Модерация (60+ категорий)

| Раздел | Описание |
|--------|----------|
| [Правила размещения](docs/moderation/adv-rules.md) | Основные требования к рекламе |
| [Технические ограничения](docs/moderation/technical-restrictions.md) | Размеры, форматы, лимиты |
| [Возрастные ограничения](docs/moderation/age-alerts.md) | Маркировка контента |
| [Спецкатегории](docs/moderation/categories/) | 60+ категорий: финансы, медицина, алкоголь, недвижимость... |

### Технологии и сервисы

| Раздел | Описание |
|--------|----------|
| [VCG-аукцион](docs/technologies-and-services/vcg-auction.md) | Как работает аукцион Директа |
| [Антифрод](docs/technologies-and-services/antifraud.md) | Защита от мошенничества |
| [Крипта](docs/technologies-and-services/crypta.md) | Технология определения интересов |
| [Метрика в Директе](docs/technologies-and-services/metrika-in-direct.md) | Интеграция с Яндекс Метрикой |
| [ИИ-помощник](docs/technologies-and-services/ai-assistant.md) | Искусственный интеллект в Директе |
| [Маркировка рекламы](docs/technologies-and-services/ad-labelingl.md) | Требования по маркировке |

### Исследования эффективности

| Раздел | Описание |
|--------|----------|
| [Brand Lift](docs/brand-lift/about.md) | Оценка влияния на бренд |
| [Search Lift](docs/search-lift/about.md) | Влияние на поисковые запросы |
| [Visit Lift](docs/visit-lift/about.md) | Влияние на визиты |
| [Target Lift](docs/target-lift/about.md) | Влияние на целевые действия |

### Места размещения

| Раздел | Описание |
|--------|----------|
| [Поиск Яндекса](docs/general/positions.md) | Позиции на поиске |
| [РСЯ](docs/general/yan.md) | Рекламная сеть Яндекса |
| [Динамические места](docs/general/dynamic-places.md) | Автоматические размещения |
| [Галерея товаров](docs/product-gallery/about.md) | Товары в поисковой выдаче |

### Интерфейсы и API

| Раздел | Описание |
|--------|----------|
| [Новый интерфейс](docs/new-interface/guide.md) | Навигация и возможности |
| [API Директа](docs/alternative-interfaces/api.md) | Программный интерфейс |
| [Директ Коммандер](docs/alternative-interfaces/direct-commander.md) | Десктопное приложение |
| [XLS-интерфейс](docs/alternative-interfaces/xls-interface.md) | Работа через Excel |

### Прочее

| Раздел | Описание |
|--------|----------|
| [Для агентств](docs/agencies/interface-guide.md) | Управление клиентами |
| [Решение проблем](docs/troubleshooting/) | FAQ по показам, ставкам, модерации |
| [Глоссарий](docs/glossary.md) | Термины Яндекс Директа |
| [Социальная реклама](docs/social/products-social.md) | Некоммерческая реклама |

## Формат файлов

Каждый файл содержит YAML front matter с полем `source:` — ссылку на оригинальную страницу:

```markdown
---
source: https://yandex.ru/support/direct/ru/strategies/select-strategy
---

# Стратегии показов

Контент статьи...
```

Внутренние ссылки ведут на файлы внутри репозитория (относительные пути), а не на yandex.ru.

## Быстрый поиск

```bash
# Поиск по ключевому слову
grep -r "ретаргетинг" docs/ --include="*.md" -l

# Все файлы раздела
ls docs/strategies/

# Прочитать конкретную статью
cat docs/strategies/select-strategy.md
```

## Обновление

Для повторного скрапинга:
```bash
python3 scripts/scrape.py    # Скачать все страницы
python3 scripts/cleanup.py   # Удалить футеры и мусор
python3 scripts/cleanup2.py  # Вторая очистка
python3 scripts/fix_links.py # Исправить ссылки
```

## Agent Skill

Этот репозиторий содержит готовый **[Agent Skill](https://agentskills.io)** — файл [`SKILL.md`](SKILL.md), который можно подключить к любому AI-агенту (Claude Code, Cursor, Windsurf, Kimi и др.).

### Claude Chat (Web) — быстрый старт

Скачайте готовый пакет и загрузите в Claude Projects:

| Формат | Размер | Скачать | Для кого |
|--------|--------|---------|----------|
| **ZIP** | 220 KB | [yandex-direct-skill.zip](https://github.com/VKirill/yandex-direct-docs/releases/download/v1.0.0/yandex-direct-skill.zip) | Для загрузки нескольких файлов в Project |
| **MD** | 338 KB | [yandex-direct-skill.md](https://github.com/VKirill/yandex-direct-docs/releases/download/v1.0.0/yandex-direct-skill.md) | Один файл — проще всего |

**Инструкция:**
1. Скачайте **MD-файл** (или ZIP и распакуйте)
2. Откройте [claude.ai](https://claude.ai) → создайте новый **Project**
3. Скопируйте текст из [`claude-project-instructions.md`](claude-project-instructions.md) в поле **Project instructions** — это превратит Claude в эксперта по Яндекс Директу
4. В настройках Project нажмите **Add content** → загрузите скачанный файл(ы)
5. Задавайте вопросы о Яндекс Директе!

> **ZIP** содержит: SKILL.md (навигация) + 4 reference-гайда + 57 ключевых статей из всех разделов.
> **MD-файл** содержит всё то же самое в одном файле.
> **[claude-project-instructions.md](claude-project-instructions.md)** — системная инструкция для Project, делает Claude экспертом-консультантом по Директу.

**Если подключаете как GitHub-репозиторий** — Claude автоматически увидит `CLAUDE.md`, `.claude/agents/` и все 509 статей. Просто скопируйте инструкцию из [`claude-project-instructions.md`](claude-project-instructions.md) в поле Project instructions.

### Claude Code — установка скилла

```bash
# Глобально (для всех проектов)
mkdir -p ~/.claude/skills/yandex-direct
cp SKILL.md ~/.claude/skills/yandex-direct/SKILL.md

# Или для конкретного проекта
mkdir -p .claude/skills/yandex-direct
cp SKILL.md .claude/skills/yandex-direct/SKILL.md
```

### Cursor / Windsurf

Добавьте содержимое `SKILL.md` в файл правил проекта (`.cursorrules`, `.windsurfrules`).

### Context7 MCP

Используйте library ID для запросов к документации через MCP-сервер context7.

### Что умеет скилл

- Навигация по 509 статьям с таблицей всех разделов
- Quick-reference по стратегиям, таргетингам, кампаниям, модерации
- Агент-консультант для ответов на вопросы (`.claude/agents/`)
- Цитирование источников с ссылками на оригинал

## Telegram-канал

<div align="center">

[![Помогай Маркетинг](https://img.shields.io/badge/%D0%9F%D0%BE%D0%BC%D0%BE%D0%B3%D0%B0%D0%B9_%D0%9C%D0%B0%D1%80%D0%BA%D0%B5%D1%82%D0%B8%D0%BD%D0%B3-Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/pomogay_marketing)

**[@pomogay_marketing](https://t.me/pomogay_marketing)** — канал о маркетинге, рекламе и AI-автоматизации.
Подписывайтесь, чтобы быть в курсе обновлений документации и полезных материалов!

</div>

## Лицензия

Контент документации принадлежит Яндексу. Данный репозиторий создан для удобства доступа и использования в справочных целях.

---

<div align="center">

Дата скрапинга: 2026-02-11 | Источник: [yandex.ru/support/direct/ru/](https://yandex.ru/support/direct/ru/)

Сделано с помощью AI | **[@pomogay_marketing](https://t.me/pomogay_marketing)**

</div>
