Community Скиллы Российские сервисы

Скилл VK Рекламы

Claude Code

Установка

git clone (см. README)

Описание

vk-ads-skill — скилл ведения рекламы ВКонтакте для Claude Code: кампании и группы — создание и структура, баннеры — подготовка креативов под требования площадки, статистика — выгрузка и чтение показателей, ремаркетинг и лид-формы — настройка возврата аудитории и сбора заявок. Для таргетологов, ведущих VK Рекламу через агента вместо ручного кабинета.

Что умеет:
— создавать кампании и группы;
— готовить баннеры под требования;
— выгружать статистику;
— настраивать ремаркетинг и лид-формы.

Полная документация ниже — автоматически из репозитория bugzbunnyviber/vk-ads-skill (ветка main). Оригинальные материалы проекта распространяются на условиях его лицензии.

VK Ads Skill for Claude Code

A Claude Code skill for working with the VK Ads API (VK Рекламы) — campaign management, ad groups, banners, statistics, remarketing, lead forms, and more.

Installation

npx skills add BugzBunnyViber/vk-ads-skill

Or add manually:

git clone https://github.com/BugzBunnyViber/vk-ads-skill.git ~/.claude/skills/vk-ads

Setup

Go to VK Ads settings and create an API application.
Get your OAuth token:

bash ~/.claude/skills/vk-ads/scripts/get_token.sh --client-id YOUR_ID --client-secret YOUR_SECRET

Verify connection:

bash ~/.claude/skills/vk-ads/scripts/check_connection.sh

What’s Included

Scripts

Script	Purpose
`check_connection.sh`	Verify API token and show account info
`campaigns.sh`	List, get, create, update, start, stop, delete campaigns
`ad_groups.sh`	List, get, create, update, start, stop, delete ad groups
`banners.sh`	List, get, update, start, stop, delete, remoderate banners
`statistics.sh`	Pull day-by-day or summary statistics
`remarketing.sh`	Manage segments, users lists, counters
`lead_forms.sh`	Manage lead forms, surveys, export leads
`get_token.sh`	Get or refresh OAuth token

Campaign Management

bash scripts/campaigns.sh --action list --status active
bash scripts/campaigns.sh --action stop --ids 12345

Statistics

bash scripts/statistics.sh --ids 12345 \
  --date-from 2026-03-01 --date-to 2026-03-20 \
  --metrics base,uniques

Remarketing

bash scripts/remarketing.sh --action segments
bash scripts/remarketing.sh --action users-lists

API Coverage

Covers all VK Ads API v1/v2/v3 endpoints:

Campaign Management: AdPlans, AdGroups, Banners, mass actions
Statistics: 11 metric groups (base, events, uniques, video, carousel, romi, etc.)
Remarketing: Segments, Users Lists, Counters, Goals, Offline Goals, Local Geo
Lead Forms & Surveys: Create, manage, export leads/respondents
Content: Image, video, HTML5 upload
Agency: Client management, billing, transactions
Targeting: Packages, interests tree, regions, search phrases, projection
Other: User info, URLs, webhooks, ORD, product feeds

See references/ for detailed API documentation:

campaigns.md — AdPlans, AdGroups, Banners, Content
statistics.md — Metric groups, parameters, format
remarketing.md — Segments, Users Lists, Counters
targeting.md — Packages, Targetings, Regions, Phrases
other-services.md — Agency, Billing, Lead Forms, ORD
use-cases.md — Complete bash script examples

Requirements

curl and jq (for formatted output and JSON processing)
VK Ads OAuth token (client_credentials or authorization_code grant)

Features

Three OAuth2 grant types (client_credentials, agency_client_credentials, authorization_code)
Automatic token refresh via refresh_token
Paginated data fetching (vk_ads_get_all)
Rate limit monitoring
Agency account support
File upload (images, videos, HTML5)

Triggers

This skill activates on: VK Ads, VK Рекламы, ВК Реклама, VK advertising, ads.vk.com, рекламный кабинет VK, баннеры VK, таргетинг VK, VK campaign, VK статистика рекламы, VK remarketing, VK лид-формы.

License

MIT