MCP-сервер VK Реклама, только чтение

vk-ads-mcp

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

  • 1 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Ходит в рекламный кабинет с деньгами клиента, хотя только читает данные
  • Токен приложения может иметь более широкие права, чем использует сервер
Все причины и проверки
Российский стек

sergeiteterin/vk-ads-mcp

Установка

Сервисы

Ручная установка

Текст для агента

Установи и запусти vk-ads-mcp с client_id и client_secret OAuth-приложения VK Реклама, подключи сервер к MCP-клиенту по stdio и используй промпт campaign_analysis для разбора кампаний.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Ходит в рекламный кабинет с деньгами клиента, хотя только читает данные
  • Токен приложения может иметь более широкие права, чем использует сервер

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

Что делает

Сервер отдает структуру рекламного кабинета VK Реклама (ads.vk.com): списки кампаний, групп объявлений и баннеров с фильтрами и пагинацией, дневную и сводную статистику за период, топ объектов по метрике вроде CTR, CPC, CPA или расхода. Сам разбивает период больше 92 дней и список больше 50 id на части, чтобы не упереться в лимиты API. Есть инструмент describe_fields, который на лету узнает у API допустимые поля для каждого типа объекта, ресурсы со справочником метрик и иерархией кампаний, и промпт campaign_analysis с готовым сценарием разбора на русском. Ничего не создает и не меняет.

Для кого. Для таргетологов, которым нужна только аналитика по своему кабинету VK Реклама без риска случайно что-то сломать.

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

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

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

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

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

Покажи топ-5 групп объявлений по CPA за последние две недели, от худшего к лучшему

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

client_id обязательная, секрет
Client ID OAuth-приложения VK Реклама.
client_secret обязательная, секрет
Client secret OAuth-приложения VK Реклама.

Ограничения

Сервер только читает данные, для запуска или остановки рекламы нужен другой инструмент. Нужны client_id и client_secret OAuth-приложения VK Реклама с доступом к своему кабинету. Проект небольшой, без готовых релизов на PyPI по данным репозитория.

Как отключить. Удалите сервер из конфигурации MCP-клиента и остановите процесс FastMCP.

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

Может ли сервер случайно изменить кампанию?

Нет, README прямо говорит: только чтение, сервер ничего не создает и не меняет.

Какой движок использует VK Реклама под капотом?

По словам автора, тот же, что и myTarget: ad_plans, ad_groups и banners это общий словарь объектов нового кабинета ads.vk.com.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

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

MCP-серверШирокий доступ13Звезды репозитория
Российский стек

MCP-сервер для VK Реклама с установщиком под ключ: 136 инструментов, поиск сообществ VK и навык для нескольких агентов сразу

MCP-серверШирокий доступ
Российский стек

MCP-сервер для VK Ads на базе myTarget API v2 с 49-55 инструментами: кампании, ремаркетинг, look-alike, товарные фиды и агентский доступ

MCP-серверШирокий доступ3Звезды репозитория
Российский стек

Hardened-форк MCP для VK Рекламы: read-only по умолчанию, мутации только через VK_ADS_ENABLE_WRITES, защита от SSRF при загрузке файлов

MCP-серверШирокий доступ
Российский стек

MCP-сервер VK API для бизнеса: магазин сообщества, посты, реклама, статистика, диалоги и лид-формы с подтверждением записи

MCP-серверШирокий доступ3Звезды репозитория
Российский стек

MCP-сервер для API ВКонтакте: профили, стены, сообщества, фото, лайки и статистика, публикация постов с подтверждением

MCP-серверШирокий доступ17Звезды репозитория

Сравнение с похожими

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

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
MCP-сервер VK Реклама, только чтение (эта карточка)нетAPI-ключ1
MCP VK Реклама, все в одномнетAPI-ключ0136 инструментов
Защищенный MCP для VK РекламынетAPI-ключ0read-only по умолчанию, защита от SSRF

Коротко о README

README описывает сервер как MCP-обертку над новым кабинетом ads.vk.com, только для чтения и своего кабинета. Перечислены восемь инструментов: списки кампаний, групп и баннеров, статистика с автоматическим разбиением больших периодов, топ объектов, описание полей, экспорт в CSV и остаток квоты API. Отдельно описаны ресурсы со справочником метрик и иерархией объектов, а также промпт campaign_analysis по схеме анализ, ранжирование, рекомендации.

Бейдж для README

Сообщить о проблеме