SkillFoxx

Начните вводить название, задачу или сервис

VK Ads MCP

MCP-сервер для VK Рекламы: кампании, группы объявлений, объявления, статистика и баланс кабинета

MCP-серверВысокий рискРоссийский стек

theyahia/vk-ads-mcpАвтор: theYahia

Установка

claude mcp add vk-ads -e VK_ADS_TOKEN=ваш_токен -- npx -y @theyahia/vk-ads-mcp

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер работает с VK Ads API v2 и дает агенту восемь инструментов. Агент может получить списки кампаний, групп объявлений с таргетингом и объявлений, создать кампанию или объявление, изменить бюджет, запустить, остановить или удалить кампанию. Статистика показов, кликов и расхода доступна по дням или суммарно, баланс читается из данных кабинета. Кабинет определяется токеном, поэтому агентство использует отдельный токен на каждого клиента.

Для кого. Таргетологам и маркетологам, которые ведут рекламу в VK Рекламе.

Подходит, если

  • Нужно узнать расход и остаток бюджета без выгрузок в таблицы
  • Нужно быстро остановить или запустить кампанию
  • Нужен отчет по кампании за период по дням

Не подходит, если

  • Нужны массовые действия, загрузка креативов или аудитории ретаргетинга
  • Нельзя давать агенту право создавать и удалять кампании

Пример запроса к агенту

Покажи статистику кампании 12345 за прошлую неделю по дням и остаток на балансе

Ограничения

Нужен OAuth-токен VK Ads, который живет около суток. Для автообновления нужно задать client id, client secret и refresh token. Баланс требует права read_payments. Часть деталей API, например единицы бюджета и поле баланса, автор пометил как требующие проверки на живом токене. Массовых действий, креативов и справочников таргетинга пока нет.

Как отключить. Удалите сервер командой claude mcp remove vk-ads или уберите блок vk-ads из конфигурации клиента.

MCP

Транспорт
stdio
Авторизация
OAuth
Переменные окружения
VK_ADS_TOKEN
обязательная, секрет		OAuth access_token VK Ads API
VK_ADS_CLIENT_ID
Для автообновления токена
VK_ADS_CLIENT_SECRET
секрет		Для автообновления токена
VK_ADS_REFRESH_TOKEN
секрет		Для автообновления токена

Проверка безопасности

  • Создает кампании и меняет бюджеты, что расходует деньги рекламного кабинета
  • Может останавливать и удалять кампании

Коротко о README

README на русском описывает модель данных VK Ads v2 и восемь инструментов с соответствующими методами API. Даны конфигурации для Claude Desktop и Claude Code, таблица переменных авторизации и примеры запросов. Отдельный раздел объясняет несовместимые изменения при переходе с версии 1.x, которая обращалась к устаревшему API. Сервер входит в серию WWmcp. Лицензия MIT.

Частые вопросы

Как выбрать кабинет клиента агентства?

Параметра account_id нет. Для каждого клиента нужен свой токен, выданный через agency_client_credentials.

Что делать, когда токен истек?

Задайте VK_ADS_CLIENT_ID, VK_ADS_CLIENT_SECRET и VK_ADS_REFRESH_TOKEN, тогда сервер обновит токен сам при ответе 401.

Выбор редакции

Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов

СкиллНизкий риск48,1 тыс.

Скиллы для контента: иллюстрации к статьям, обложки, инфографика, комиксы, перевод, конвертация URL в Markdown и публикация в соцсети

СкиллВысокий риск25,9 тыс.

Китайская версия скилла Humanizer: находит и убирает приметы AI-текста в материалах на китайском

СкиллНизкий риск17,3 тыс.