MCP «ВК Реклама»
MCP-сервер на Bun и TypeScript, который даёт ИИ-агенту прямой доступ к API ВК Рекламы (myTarget API v2).
Что это
Из диалога с вами агент читает состояние аккаунта и вносит изменения через API: смотрит кампании, группы и объявления, выгружает статистику со срезами, создаёт и правит сущности, загружает креативы, собирает аудитории для ремаркетинга, отправляет объявления на модерацию, запускает и останавливает показы.
Стратегию и тексты объявлений сервер не придумывает — он исполняет решения, которые принимаете вы вместе с агентом. В наборе 48 инструментов.
Как проходит работа
- Подключение и доступ. Вы выбираете готовый токен ВК Рекламы, OAuth-приложение или подключение через Click.ru. Проверить связь можно инструментом
auth_check. Сервер работает локально через стандартный ввод-вывод или по HTTP, в том числе с несколькими аккаунтами.
- Чтение состояния. Перед изменением агент получает кампании, группы, объявления, справочники и текущую статистику.
- Изменение. Агент создаёт и правит сущности, загружает изображения и видео, собирает аудитории и списки клиентов, отправляет объявления на модерацию и меняет статусы.
- Проверка. После изменения агент снова читает состояние и статистику.
Сервер не запускает кампании самостоятельно. Показ включается только отдельной явной сменой статуса.
Инструменты
| Область | Что позволяет сделать |
|---|
| Авторизация и аккаунт | Проверить доступ, получить данные аккаунта и отозвать лишние OAuth-токены |
Кампании — API ad_plans | Создавать и вести кампании верхнего уровня, задавать сроки и ограничения бюджета |
Группы объявлений — API campaigns | Создавать группы с целью, бюджетом и таргетингом, запускать и останавливать показы |
Дополнительные группы — API ad_groups | Группировать объявления по таргетингу |
Объявления — API banners | Создавать и править объявления, привязывать креативы и отправлять на модерацию |
| Контент | Загружать изображения и видео из локального файла или по URL |
| Статистика | Получать данные по дням, итоги за период, срезы и большие асинхронные отчёты |
| Ремаркетинг | Работать с сегментами, пикселями и списками пользователей |
| Агентство | Получать список клиентов и создавать клиентов агентского аккаунта |
| Справочники | Искать регионы, пакеты форматов, интер |