https://github.com/vkirill/yandex-direct-docs
Полная документация Яндекс Директа в Markdown (509 страниц). Стратегии, таргетинги, кампании, модерация, оплата, API. Complete Yandex Direct documentation in Markdown.
https://github.com/vkirill/yandex-direct-docs
advertising contextual-advertising cpc cpm digital-marketing docs documentation markdown ppc retargeting russian sem yandex yandex-direct yandex-direct-api
Last synced: 13 days ago
JSON representation
Полная документация Яндекс Директа в Markdown (509 страниц). Стратегии, таргетинги, кампании, модерация, оплата, API. Complete Yandex Direct documentation in Markdown.
- Host: GitHub
- URL: https://github.com/vkirill/yandex-direct-docs
- Owner: VKirill
- Created: 2026-02-11T10:43:09.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-11T13:31:28.000Z (5 months ago)
- Last Synced: 2026-02-11T19:39:50.452Z (5 months ago)
- Topics: advertising, contextual-advertising, cpc, cpm, digital-marketing, docs, documentation, markdown, ppc, retargeting, russian, sem, yandex, yandex-direct, yandex-direct-api
- Language: Python
- Homepage: https://yandex.ru/support/direct/ru/
- Size: 2.1 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Документация Яндекс Директ (Markdown)
[]() []() []() [](SKILL.md) [](https://github.com/VKirill/yandex-direct-docs/releases/latest)
[](https://github.com/VKirill/yandex-direct-docs/releases/download/v1.0.0/yandex-direct-skill.zip) [](https://github.com/VKirill/yandex-direct-docs/releases/download/v1.0.0/yandex-direct-skill.md)
[](https://t.me/pomogay_marketing)
---
Полная документация **Яндекс Директа** на русском языке в формате 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-канал
[](https://t.me/pomogay_marketing)
**[@pomogay_marketing](https://t.me/pomogay_marketing)** — канал о маркетинге, рекламе и AI-автоматизации.
Подписывайтесь, чтобы быть в курсе обновлений документации и полезных материалов!
## Лицензия
Контент документации принадлежит Яндексу. Данный репозиторий создан для удобства доступа и использования в справочных целях.
---
Дата скрапинга: 2026-02-11 | Источник: [yandex.ru/support/direct/ru/](https://yandex.ru/support/direct/ru/)
Сделано с помощью AI | **[@pomogay_marketing](https://t.me/pomogay_marketing)**