Пакет для ВК Реклама

vk-ads-manager — скилл для подготовки и ведения кампаний в новом кабинете ВК Рекламы. ИИ-агент собирает бриф, исследует конкурентов, проектирует аудитории, готовит прогноз и креативы, создаёт структуру кампании и загружает её в кабинет.

Первичная загрузка выполняется на паузе. Кампанию проверяет и активирует человек.

Что делает пакет

У пакета два режима:

  • подготовка кампании с нуля — от продукта и брифа до структуры, креативов, прогноза и загрузки;
  • работа с активной кампанией — статистика, бюджеты, статусы, аудитории, креативы и недельная оптимизация.

Работа идёт на русском языке. Агент запускает скрипты, сохраняет результаты в файлы и показывает их в диалоге. На важных развилках он ждёт подтверждения.

Подготовка кампании

  1. Бриф. Продукт, цена, тип спроса, целевой CPL и его предел, бюджет, срок теста, цель кампании и состояние пикселя.
  2. Материалы бренда. Логотип, цвета, изображения продукта, скриншоты, готовые видео и список недостающих материалов.
  3. Поиск конкурентов. Прямые и непрямые конкуренты, заменители и сценарий «ничего не делать». Список подтверждается до глубокого разбора.
  4. Разбор конкурентов. Оферы, УТП, цены, подача, сообщества и рекламные форматы.
  5. Позиционирование и УТП. Отдельное сообщение для каждого сегмента и сценария сравнения.
  6. Портреты и матрица аудиторий. 3–5 портретов, их поведение в ВК и матрица «горячие / тёплые / холодные».
  7. Креативы конкурентов и пиксель. Разбор примеров, код пикселя и перечень событий для сайта.
  8. Рабочие приёмы. Повторяющиеся формулы оферов, заголовков, композиций и призывов к действию.
  9. Посадочная страница и прогноз. Проверка лендинга и прогноз по трём сценариям. Охваты и клики берутся из кабинета; лиды и CPL включаются в стратегию только после согласования.
  10. Креативы. По 3–5 вариантов для ключевых связок «гипотеза → аудитория → посадочная страница».

После подготовки пакет может создать:

  • изображения;
  • короткие видео;
  • PDF-лид-магниты;
  • таблицу объявлений;
  • отчёт-стратегию;
  • структуру кампании в кабинете;
  • инструкцию для ручной загрузки, если API недоступен.

Загрузка выполняется через MCP-сервер, встроенный REST-клиент или вручную по готовой инструкции. Объекты первичной загрузки создаются на паузе.

Работа с активной кампанией

Пакет содержит 13 готовых сценариев:

  • сводка за период и ежедневная проверка;
  • изменение бюджета;
  • пауза и запуск;
  • добавление аудиторий;
  • загрузка клиентской базы;
  • замена креативов и таргетинга;
  • недельный разбор и список изменений;
  • смена стратегии ставок;
  • копирование кампании.

Перед изменением агент показывает план и ждёт подтверждения. После изменения перечитывает объект и записывает операцию в журнал.

Что входит в пакет

Подготовка и отчёты

Скрипт Назначение
forecast.py прогноз по трём сценариям с пометкой источника каждой цифры
generate_ads_xlsx.py таблица объявлений и проверка ограничений
generate_media_plan.py единый документ по материалам кампании
generate_strategy_report.py отчёт-стратегия для команды или клиента
vk_pixel_helper.py код пикселя и перечень событий

Генерация материалов

Модуль Результат Ограничение
Изображения PNG для объявлений и лид-магнитов снимки интерфейса продукта лучше брать у клиента
Видео короткие MP4 и склейка сегментов звук и титры добавляются отдельно; для склейки нужен FFmpeg
PDF лид-магниты из Markdown отправку пользователю настраивает клиент

Генерация изображений использует OpenAI Images API. Для видео доступны Runway, Kling, Veo и Replicate; конкретный сервис и модель выбирает человек.

Загрузка

Скрипт Назначение
deploy_campaign.py загрузка медиа и создание кампании, групп и объявлений
vk_ads_api.py работа с API ВК Рекламы и предстартовая проверка маркировки
generate_launch_guide.py инструкция для ручной загрузки
setup_vk_ads_mcp.py подключение совместимого MCP-сервера

Для работы через MCP используйте публичный сервер ai-hub-open/vk-ads-mcp.

Справочники

В references/ лежат методики по конкурентам, портретам покупателей, аудиториям, объявлениям, прогнозированию, посадочным страницам, изображениям, видео, PDF, API, модерации, маркировке рекламы, лид-формам, каталогам, приложениям и медийным форматам.

Терминология API

В интерфейсе и API одни и те же уровни называются по-разному:

В интерфейсе ВК Рекламы В API
Кампания ad_plan
Группа объявлений campaign
Объявление banner

Группа campaign без ad_plan_id становится «сиротой» и не видна в новом кабинете. Пакет создаёт кампанию сразу со связанными группами и объявлениями.

Что делает агент, а что остаётся человеку

Агент:

  • ведёт маршрут и запускает скрипты;
  • исследует конкурентов и готовит портреты покупателей;
  • проектирует аудитории и креативы;
  • считает прогноз и собирает отчёты;
  • создаёт структуру в кабинете;
  • проверяет ограничения текстов и ведёт журнал изменений.

Человек:

  • подтверждает конкурентов, позиционирование, аудитории и прогноз;
  • проверяет изображения, видео и PDF;
  • передаёт реквизиты для маркировки рекламы;
  • устанавливает пиксель на сайт;
  • предоставляет реальные снимки интерфейса и видео с людьми;
  • проверяет и активирует кампанию.

Ограничения

  • Пакет не расходует бюджет без явного запуска человеком.
  • При ведении он не удаляет сущности, а ставит их на паузу.
  • Данные без источника не выдаются за факт; лиды и CPL не попадают в стратегию без согласования.
  • Пиксель и события устанавливаются на сайте вручную.
  • Собственный REST-клиент не создаёт похожие аудитории и не загружает базу CRM при первой загрузке.
  • Пакет работает только с новым кабинетом ВК Рекламы.
  • Прохождение модерации и присвоение ERID зависят от платформы.
  • Реальные снимки интерфейса продукта и готовые ролики с людьми предоставляет клиент.

Требования

  • Python 3.9 или новее;
  • доступ к ВК Рекламе;
  • токен ВК Рекламы или настроенный MCP-сервер;
  • реквизиты рекламодателя для маркировки;
  • API-ключи сервисов, которые вы используете для генерации изображений или видео.

Установка

Из исходников

Скачайте репозиторий, откройте его папку и запустите:

python install.py

Скрипт установит зависимости, создаст локальное хранилище ключей и проверит основные модули.

Готовый файл скилла

Файл dist/vk-ads-manager.skill можно загрузить в среду, которая поддерживает установку скиллов, либо распаковать вручную.

После установки напишите агенту:

Хочу подготовить кампанию в ВК Рекламе для [продукт], бюджет [сумма], срок теста [период].

Доступы

Ключи хранятся в ~/.vk-ads-manager/credentials.json. На Unix файл получает права 600.

Сохраняйте ключи через скрытый интерактивный ввод, чтобы они не попадали в историю команд:

python -m scripts.manage_credentials set vk_ads
python -m scripts.manage_credentials set openai

Посмотреть сохранённые сервисы:

python -m scripts.manage_credentials list

Удалить ключ:

python -m scripts.manage_credentials delete openai

Не передавайте секреты в открытом виде в README, задачах, журналах и файлах кампаний.

Безопасность

  • ключи хранятся отдельно от папки скилла и рабочих файлов;
  • рабочие папки кампаний не входят в пакет;
  • первичная загрузка создаёт объекты на паузе;
  • перед изменением активной кампании агент должен показать план и дождаться подтверждения;
  • перед запуском проверьте маркировку, бюджет, ссылки, пиксель и события;
  • перед важной загрузкой проверьте имена полей API на тестовом объекте.

Структура

vk-ads-manager/
├── SKILL.md
├── README.md
├── requirements.txt
├── install.py
├── references/
├── scripts/
├── dist/
└── package.sh

Рабочие файлы кампании создаются отдельно от папки скилла.

Упаковка

./package.sh

Или:

python scripts/package_skill.py

Команда создаёт файл .skill без рабочих папок, кэшей, тестовых данных и каталога .git.