{"id":50884781,"url":"https://github.com/vkirill/yandex-direct-docs","last_synced_at":"2026-06-15T16:03:58.631Z","repository":{"id":337804787,"uuid":"1155288107","full_name":"VKirill/yandex-direct-docs","owner":"VKirill","description":"Полная документация Яндекс Директа в Markdown (509 страниц). Стратегии, таргетинги, кампании, модерация, оплата, API. Complete Yandex Direct documentation in Markdown.","archived":false,"fork":false,"pushed_at":"2026-02-11T13:31:28.000Z","size":2198,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-11T19:39:50.452Z","etag":null,"topics":["advertising","contextual-advertising","cpc","cpm","digital-marketing","docs","documentation","markdown","ppc","retargeting","russian","sem","yandex","yandex-direct","yandex-direct-api"],"latest_commit_sha":null,"homepage":"https://yandex.ru/support/direct/ru/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VKirill.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-11T10:43:09.000Z","updated_at":"2026-02-11T13:31:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/VKirill/yandex-direct-docs","commit_stats":null,"previous_names":["vkirill/yandex-direct-docs"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/VKirill/yandex-direct-docs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VKirill%2Fyandex-direct-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VKirill%2Fyandex-direct-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VKirill%2Fyandex-direct-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VKirill%2Fyandex-direct-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VKirill","download_url":"https://codeload.github.com/VKirill/yandex-direct-docs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VKirill%2Fyandex-direct-docs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34369850,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["advertising","contextual-advertising","cpc","cpm","digital-marketing","docs","documentation","markdown","ppc","retargeting","russian","sem","yandex","yandex-direct","yandex-direct-api"],"created_at":"2026-06-15T16:03:51.028Z","updated_at":"2026-06-15T16:03:58.626Z","avatar_url":"https://github.com/VKirill.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Документация Яндекс Директ (Markdown)\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n\r\n\u003cpicture\u003e\r\n  \u003csource 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\u0026logo=yandex\u0026logoColor=black\"\u003e\r\n  \u003cimg 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\u0026logo=yandex\u0026logoColor=black\"\u003e\r\n\u003c/picture\u003e\r\n\r\n[![Страниц](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\u0026color=brightgreen)](https://github.com/VKirill/yandex-direct-docs/releases/latest)\r\n\r\n[![Скачать 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)\r\n\r\n[![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\u0026logo=telegram\u0026logoColor=white)](https://t.me/pomogay_marketing)\r\n\r\n\u003c/div\u003e\r\n\r\n---\r\n\r\nПолная документация **Яндекс Директа** на русском языке в формате Markdown. Автоматически получена с [yandex.ru/support/direct/ru/](https://yandex.ru/support/direct/ru/) по официальному sitemap.xml.\r\n\r\n**509 статей** с внутренними ссылками, структурированные по разделам. Подходит для:\r\n- Справочника по контекстной рекламе Яндекса\r\n- Базы знаний для AI-агентов и чат-ботов (Claude Code, Cursor, Windsurf, Kimi и др.)\r\n- Интеграции с [context7](https://context7.com) и другими инструментами документации\r\n- [Agent Skill](https://agentskills.io) — готовый скилл `SKILL.md` для подключения к любому AI-агенту\r\n- Обучения и быстрого поиска информации\r\n\r\n## Навигация по разделам\r\n\r\n### Кампании и инструменты\r\n\r\n| Раздел | Описание |\r\n|--------|----------|\r\n| [Единая перфоманс-кампания](docs/unified-performance-campaign/about.md) | Основной тип для performance-задач — настройка, каталоги, нейро-объявления |\r\n| [Мастер кампаний](docs/campaign-master/about.md) | Упрощённый интерфейс создания кампаний — сайт, товары, Telegram, маркетплейсы |\r\n| [Товарная кампания](docs/product-campaign/create.md) | Продвижение товаров из каталога через фиды |\r\n| [Продвижение приложений](docs/products-mobile-apps-ads/about.md) | Мобильная реклама iOS/Android — создание, трекеры, кросс-платформа |\r\n| [Продвижение организаций](docs/company-ads/create.md) | Карточки компаний в Картах и поиске |\r\n| [Реклама в Telegram](docs/telegram-ads/create.md) | Размещение объявлений в телеграм-каналах партнёров РСЯ |\r\n| [DOOH](docs/dooh/) | Цифровая наружная реклама |\r\n\r\n### Охватная и медийная реклама\r\n\r\n| Раздел | Описание |\r\n|--------|----------|\r\n| [Медийные кампании (CPM)](docs/products-cpm-campaign/about.md) | Оплата за показы, жанры и тематики, ретаргетинг |\r\n| [Видеообъявления](docs/products-cpm-campaign-video/about.md) | Видеореклама — создание, карусель, ретаргетинг |\r\n| [Видеобаннеры](docs/products-cpm-campaign-videobanner/about.md) | Баннеры с видео — конструктор, форматы |\r\n| [Реклама на главной Яндекса](docs/products-cpm-campaign-frontpage/about.md) | Баннеры на ya.ru |\r\n| [Connected TV](docs/products-cpm-campaign-connected-tv/about.md) | Реклама на Smart TV |\r\n| [Фиксированные CPM-размещения](docs/fixed-cpm-campaigns/products-fixed-cpm.md) | Премиальные баннеры, брендинг, billboard |\r\n\r\n### Стратегии показов\r\n\r\n| Стратегия | Описание |\r\n|-----------|----------|\r\n| [Выбор стратегии](docs/strategies/select-strategy.md) | Обзор всех стратегий и рекомендации по выбору |\r\n| [Максимум конверсий](docs/strategies/average-cpa.md) | Оптимизация по CPA — целевая цена конверсии |\r\n| [Максимум кликов](docs/strategies/average-cpc.md) | Оптимизация по CPC — максимум трафика |\r\n| [Максимум прибыли](docs/strategies/maximum-profit.md) | Оптимизация рентабельности (ROAS) |\r\n| [Ручное управление](docs/strategies/manual-strategy.md) | Назначение ставок вручную |\r\n| [Портфельные стратегии](docs/strategies/portfolio-strategy.md) | Управление группой кампаний |\r\n| [Приоритетные цели](docs/strategies/priority-goals.md) | Настройка целей для оптимизации |\r\n| [Бюджеты в стратегиях](docs/strategies/budgets-in-strategies.md) | Работа с бюджетами |\r\n\r\n### Таргетинги и ключевые фразы\r\n\r\n| Раздел | Описание |\r\n|--------|----------|\r\n| [Ключевые фразы](docs/keywords/keywords.md) | Основы подбора ключевых фраз |\r\n| [Минус-фразы](docs/keywords/negative-keywords.md) | Исключение нецелевых запросов |\r\n| [Операторы и символы](docs/keywords/symbols-and-operators.md) | Специальные операторы для точного соответствия |\r\n| [Вордстат](docs/keywords/wordstat.md) | Инструмент подбора слов |\r\n| [Автотаргетинг](docs/impression-criteria/autotargeting.md) | Автоматический подбор аудитории |\r\n| [Ретаргетинг](docs/impression-criteria/retargeting-lists.md) | Возврат посетителей сайта |\r\n| [Офферный ретаргетинг](docs/impression-criteria/offer-retargeting.md) | Ретаргетинг по товарам из фида |\r\n| [Геотаргетинг](docs/efficiency/geotargeting.md) | География показов |\r\n| [Временной таргетинг](docs/efficiency/timetargeting.md) | Расписание показов |\r\n\r\n### Эффективность объявлений\r\n\r\n| Раздел | Описание |\r\n|--------|----------|\r\n| [Как улучшить объявления](docs/efficiency/improve-your-ads.md) | Общие рекомендации |\r\n| [Тексты и заголовки](docs/efficiency/text-and-title.md) | Написание эффективных объявлений |\r\n| [Изображения](docs/efficiency/images.md) | Требования и рекомендации |\r\n| [Видео](docs/efficiency/video.md) | Видеодополнения |\r\n| [Быстрые ссылки](docs/efficiency/quick-links.md) | Дополнительные ссылки в объявлении |\r\n| [Карусель](docs/efficiency/carousel.md) | Несколько карточек в одном объявлении |\r\n| [Турбо-страницы](docs/efficiency/turbo-pages.md) | Быстрые лендинги |\r\n\r\n### Фиды\r\n\r\n| Раздел | Описание |\r\n|--------|----------|\r\n| [О фидах](docs/feeds/about.md) | Обзор и назначение |\r\n| [Типы фидов](docs/feeds/types.md) | Доступные форматы |\r\n| [Требования](docs/feeds/requirements.md) | Технические требования |\r\n| [YML формат](docs/feeds/requirements-yml.md) | Формат Яндекс Маркета |\r\n| [Валидация](docs/feeds/validate.md) | Проверка фида |\r\n\r\n### Статистика и отчёты\r\n\r\n| Раздел | Описание |\r\n|--------|----------|\r\n| [Обзор статистики](docs/statistics/overview.md) | Основные метрики |\r\n| [Мастер отчётов](docs/statistics/report-wizard.md) | Построение отчётов |\r\n| [Поисковые запросы](docs/statistics/search-queries.md) | Анализ запросов |\r\n| [Конверсии](docs/statistics/conversions.md) | Отслеживание целей |\r\n| [UTM-метки](docs/statistics/url-tags.md) | Параметры URL |\r\n| [Модели атрибуции](docs/statistics/attribution-model.md) | Определение источника конверсий |\r\n\r\n### Оплата\r\n\r\n| Раздел | Описание |\r\n|--------|----------|\r\n| [Способы оплаты](docs/payments/payment-methods.md) | Все способы пополнения |\r\n| [Промокоды](docs/payments/promocode.md) | Активация промокодов |\r\n| [Возврат средств](docs/payments/refund.md) | Процедура возврата |\r\n| [Отсрочка платежа](docs/payments/deferred-payment.md) | Кредитная линия |\r\n| [Общий счёт](docs/payments/shared-account.md) | Управление бюджетом нескольких кампаний |\r\n\r\n### Модерация (60+ категорий)\r\n\r\n| Раздел | Описание |\r\n|--------|----------|\r\n| [Правила размещения](docs/moderation/adv-rules.md) | Основные требования к рекламе |\r\n| [Технические ограничения](docs/moderation/technical-restrictions.md) | Размеры, форматы, лимиты |\r\n| [Возрастные ограничения](docs/moderation/age-alerts.md) | Маркировка контента |\r\n| [Спецкатегории](docs/moderation/categories/) | 60+ категорий: финансы, медицина, алкоголь, недвижимость... |\r\n\r\n### Технологии и сервисы\r\n\r\n| Раздел | Описание |\r\n|--------|----------|\r\n| [VCG-аукцион](docs/technologies-and-services/vcg-auction.md) | Как работает аукцион Директа |\r\n| [Антифрод](docs/technologies-and-services/antifraud.md) | Защита от мошенничества |\r\n| [Крипта](docs/technologies-and-services/crypta.md) | Технология определения интересов |\r\n| [Метрика в Директе](docs/technologies-and-services/metrika-in-direct.md) | Интеграция с Яндекс Метрикой |\r\n| [ИИ-помощник](docs/technologies-and-services/ai-assistant.md) | Искусственный интеллект в Директе |\r\n| [Маркировка рекламы](docs/technologies-and-services/ad-labelingl.md) | Требования по маркировке |\r\n\r\n### Исследования эффективности\r\n\r\n| Раздел | Описание |\r\n|--------|----------|\r\n| [Brand Lift](docs/brand-lift/about.md) | Оценка влияния на бренд |\r\n| [Search Lift](docs/search-lift/about.md) | Влияние на поисковые запросы |\r\n| [Visit Lift](docs/visit-lift/about.md) | Влияние на визиты |\r\n| [Target Lift](docs/target-lift/about.md) | Влияние на целевые действия |\r\n\r\n### Места размещения\r\n\r\n| Раздел | Описание |\r\n|--------|----------|\r\n| [Поиск Яндекса](docs/general/positions.md) | Позиции на поиске |\r\n| [РСЯ](docs/general/yan.md) | Рекламная сеть Яндекса |\r\n| [Динамические места](docs/general/dynamic-places.md) | Автоматические размещения |\r\n| [Галерея товаров](docs/product-gallery/about.md) | Товары в поисковой выдаче |\r\n\r\n### Интерфейсы и API\r\n\r\n| Раздел | Описание |\r\n|--------|----------|\r\n| [Новый интерфейс](docs/new-interface/guide.md) | Навигация и возможности |\r\n| [API Директа](docs/alternative-interfaces/api.md) | Программный интерфейс |\r\n| [Директ Коммандер](docs/alternative-interfaces/direct-commander.md) | Десктопное приложение |\r\n| [XLS-интерфейс](docs/alternative-interfaces/xls-interface.md) | Работа через Excel |\r\n\r\n### Прочее\r\n\r\n| Раздел | Описание |\r\n|--------|----------|\r\n| [Для агентств](docs/agencies/interface-guide.md) | Управление клиентами |\r\n| [Решение проблем](docs/troubleshooting/) | FAQ по показам, ставкам, модерации |\r\n| [Глоссарий](docs/glossary.md) | Термины Яндекс Директа |\r\n| [Социальная реклама](docs/social/products-social.md) | Некоммерческая реклама |\r\n\r\n## Формат файлов\r\n\r\nКаждый файл содержит YAML front matter с полем `source:` — ссылку на оригинальную страницу:\r\n\r\n```markdown\r\n---\r\nsource: https://yandex.ru/support/direct/ru/strategies/select-strategy\r\n---\r\n\r\n# Стратегии показов\r\n\r\nКонтент статьи...\r\n```\r\n\r\nВнутренние ссылки ведут на файлы внутри репозитория (относительные пути), а не на yandex.ru.\r\n\r\n## Быстрый поиск\r\n\r\n```bash\r\n# Поиск по ключевому слову\r\ngrep -r \"ретаргетинг\" docs/ --include=\"*.md\" -l\r\n\r\n# Все файлы раздела\r\nls docs/strategies/\r\n\r\n# Прочитать конкретную статью\r\ncat docs/strategies/select-strategy.md\r\n```\r\n\r\n## Обновление\r\n\r\nДля повторного скрапинга:\r\n```bash\r\npython3 scripts/scrape.py    # Скачать все страницы\r\npython3 scripts/cleanup.py   # Удалить футеры и мусор\r\npython3 scripts/cleanup2.py  # Вторая очистка\r\npython3 scripts/fix_links.py # Исправить ссылки\r\n```\r\n\r\n## Agent Skill\r\n\r\nЭтот репозиторий содержит готовый **[Agent Skill](https://agentskills.io)** — файл [`SKILL.md`](SKILL.md), который можно подключить к любому AI-агенту (Claude Code, Cursor, Windsurf, Kimi и др.).\r\n\r\n### Claude Chat (Web) — быстрый старт\r\n\r\nСкачайте готовый пакет и загрузите в Claude Projects:\r\n\r\n| Формат | Размер | Скачать | Для кого |\r\n|--------|--------|---------|----------|\r\n| **ZIP** | 220 KB | [yandex-direct-skill.zip](https://github.com/VKirill/yandex-direct-docs/releases/download/v1.0.0/yandex-direct-skill.zip) | Для загрузки нескольких файлов в Project |\r\n| **MD** | 338 KB | [yandex-direct-skill.md](https://github.com/VKirill/yandex-direct-docs/releases/download/v1.0.0/yandex-direct-skill.md) | Один файл — проще всего |\r\n\r\n**Инструкция:**\r\n1. Скачайте **MD-файл** (или ZIP и распакуйте)\r\n2. Откройте [claude.ai](https://claude.ai) → создайте новый **Project**\r\n3. Скопируйте текст из [`claude-project-instructions.md`](claude-project-instructions.md) в поле **Project instructions** — это превратит Claude в эксперта по Яндекс Директу\r\n4. В настройках Project нажмите **Add content** → загрузите скачанный файл(ы)\r\n5. Задавайте вопросы о Яндекс Директе!\r\n\r\n\u003e **ZIP** содержит: SKILL.md (навигация) + 4 reference-гайда + 57 ключевых статей из всех разделов.\r\n\u003e **MD-файл** содержит всё то же самое в одном файле.\r\n\u003e **[claude-project-instructions.md](claude-project-instructions.md)** — системная инструкция для Project, делает Claude экспертом-консультантом по Директу.\r\n\r\n**Если подключаете как GitHub-репозиторий** — Claude автоматически увидит `CLAUDE.md`, `.claude/agents/` и все 509 статей. Просто скопируйте инструкцию из [`claude-project-instructions.md`](claude-project-instructions.md) в поле Project instructions.\r\n\r\n### Claude Code — установка скилла\r\n\r\n```bash\r\n# Глобально (для всех проектов)\r\nmkdir -p ~/.claude/skills/yandex-direct\r\ncp SKILL.md ~/.claude/skills/yandex-direct/SKILL.md\r\n\r\n# Или для конкретного проекта\r\nmkdir -p .claude/skills/yandex-direct\r\ncp SKILL.md .claude/skills/yandex-direct/SKILL.md\r\n```\r\n\r\n### Cursor / Windsurf\r\n\r\nДобавьте содержимое `SKILL.md` в файл правил проекта (`.cursorrules`, `.windsurfrules`).\r\n\r\n### Context7 MCP\r\n\r\nИспользуйте library ID для запросов к документации через MCP-сервер context7.\r\n\r\n### Что умеет скилл\r\n\r\n- Навигация по 509 статьям с таблицей всех разделов\r\n- Quick-reference по стратегиям, таргетингам, кампаниям, модерации\r\n- Агент-консультант для ответов на вопросы (`.claude/agents/`)\r\n- Цитирование источников с ссылками на оригинал\r\n\r\n## Telegram-канал\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n\r\n[![Помогай Маркетинг](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\u0026logo=telegram\u0026logoColor=white)](https://t.me/pomogay_marketing)\r\n\r\n**[@pomogay_marketing](https://t.me/pomogay_marketing)** — канал о маркетинге, рекламе и AI-автоматизации.\r\nПодписывайтесь, чтобы быть в курсе обновлений документации и полезных материалов!\r\n\r\n\u003c/div\u003e\r\n\r\n## Лицензия\r\n\r\nКонтент документации принадлежит Яндексу. Данный репозиторий создан для удобства доступа и использования в справочных целях.\r\n\r\n---\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n\r\nДата скрапинга: 2026-02-11 | Источник: [yandex.ru/support/direct/ru/](https://yandex.ru/support/direct/ru/)\r\n\r\nСделано с помощью AI | **[@pomogay_marketing](https://t.me/pomogay_marketing)**\r\n\r\n\u003c/div\u003e\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvkirill%2Fyandex-direct-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvkirill%2Fyandex-direct-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvkirill%2Fyandex-direct-docs/lists"}