一个 MCP 服务器,通过 48 个工具让 AI 代理直接访问 VK Ads API(myTarget v2),用于读取账户状态、管理广告系列、广告、统计信息等。

Stars

6

7 天增长

暂无数据

Fork 数

0

开放 Issue

0

开源协议

Apache-2.0

最近更新

2026-07-27

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它将 AI 代理(如 Claude)与 VK Ads 广告平台连接起来,通过自然语言控制广告操作,无需手动调用 API。支持 OAuth/Click.ru 认证,多账户支持,涵盖广告系列生命周期的完整工具集。

适合谁使用

  • 构建广告管理助手的 AI 开发者
  • 使用 AI 代理管理 VK Ads 的数字营销人员
  • 自动化 VK Ads 工作流程的广告代理
  • 将 MCP 与 VK Ads 集成的开发者

典型使用场景

  • 通过聊天自动创建和优化广告系列
  • 生成并下载效果报告和统计数据
  • 管理再营销受众和像素片段
  • 启动和停止广告系列,提交广告进行审核

项目优势

  • 48 个工具覆盖从预算到审核的完整广告系列生命周期
  • 支持多种认证方式(Click.ru、OAuth、直接令牌)
  • HTTP 和 stdio 模式,通过请求头支持多账户
  • 包含自动化测试(54 个测试)和实时 API 检查脚本

使用前须知

  • 不生成广告策略或创意内容
  • 没有 lead 表单创建功能,无法列出之前上传的图片/视频
  • 广告系列可软删除,但片段和像素的删除不可逆

README 快速开始

MCP «ВК Реклама»

MCP-сервер на Bun и TypeScript, который даёт ИИ-агенту прямой доступ к API ВК Рекламы (myTarget API v2).

Что это

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

Стратегию и тексты объявлений сервер не придумывает — он исполняет решения, которые принимаете вы вместе с агентом. В наборе 48 инструментов.

Как проходит работа

  1. Подключение и доступ. Вы выбираете готовый токен ВК Рекламы, OAuth-приложение или подключение через Click.ru. Проверить связь можно инструментом auth_check. Сервер работает локально через стандартный ввод-вывод или по HTTP, в том числе с несколькими аккаунтами.
  2. Чтение состояния. Перед изменением агент получает кампании, группы, объявления, справочники и текущую статистику.
  3. Изменение. Агент создаёт и правит сущности, загружает изображения и видео, собирает аудитории и списки клиентов, отправляет объявления на модерацию и меняет статусы.
  4. Проверка. После изменения агент снова читает состояние и статистику.

Сервер не запускает кампании самостоятельно. Показ включается только отдельной явной сменой статуса.

Инструменты

ОбластьЧто позволяет сделать
Авторизация и аккаунтПроверить доступ, получить данные аккаунта и отозвать лишние OAuth-токены
Кампании — API ad_plansСоздавать и вести кампании верхнего уровня, задавать сроки и ограничения бюджета
Группы объявлений — API campaignsСоздавать группы с целью, бюджетом и таргетингом, запускать и останавливать показы
Дополнительные группы — API ad_groupsГруппировать объявления по таргетингу
Объявления — API bannersСоздавать и править объявления, привязывать креативы и отправлять на модерацию
КонтентЗагружать изображения и видео из локального файла или по URL
СтатистикаПолучать данные по дням, итоги за период, срезы и большие асинхронные отчёты
РемаркетингРаботать с сегментами, пикселями и списками пользователей
АгентствоПолучать список клиентов и создавать клиентов агентского аккаунта
СправочникиИскать регионы, пакеты форматов, интер

项目描述

MCP server for VK Ads API: campaigns, audiences, budgets, stats. Click.ru proxy, static token or OAuth. Docs in Russian.

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

OneInterface
精选
OneInterface GitHub avatar

stormy-cookbook

Stormy Cookbook provides copy-pasteable recipes for using the Stormy Social Data API and MCP server, which offers a unified REST API and MCP tools to search profiles, posts, and emails across TikTok, YouTube, Instagram, LinkedIn, X, and Reddit through a single HTTP contract.

AI 与机器学习大语言模型
72
0xwilliamortiz
精选
0xwilliamortiz GitHub avatar

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI 与机器学习大语言模型
577
S40911120
精选
S40911120 GitHub avatar

recensa

Recensa is a self-hosted web viewer that indexes Claude Code session transcripts into a local SQLite database, enabling full-text search, replay, and audit of all past agent conversations without uploading data anywhere.

AI 与机器学习大语言模型
67