SkillFoxx

VK Ads skill for agencies

claude-skill-vk-ads

A Claude Code skill for VK Ads built for agencies: bulk operations, hashed remarketing audiences, ad-marking compliance and Google Sheets reports

  • 2 ★ on the repository
  • Last commit
  • MIT
Skill

Broad access

Why this level

  • Creates, edits and bulk-stops clients' ad campaigns
  • Uploads personal data (phones, emails) for remarketing, even if hashed
  • Stores OAuth credentials for multiple client accounts
All reasons and checks
Russian stack

atomachinskiy/claude-skill-vk-adsAuthor:atomachinskiy

Install

Services

Manual install

git clone --depth 1 https://github.com/atomachinskiy/claude-skill-vk-ads.git ~/.claude/skills/vk-ads

The README's method; Claude Code picks up the skill automatically after cloning.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Creates, edits and bulk-stops clients' ad campaigns
  • Uploads personal data (phones, emails) for remarketing, even if hashed
  • Stores OAuth credentials for multiple client accounts

This is third-party code. Review the repository files before installing.

What it does

The skill turns Claude Code into a performance-marketer assistant on top of the VK Ads API: reads v2/v3 statistics, reach forecasts and audience insights, auto-fills monthly Google Sheets reports and exports leads from lead forms. It can create campaigns, ad groups and banners from templates, upload SHA-256 hashed phone/email remarketing audiences, build look-alike segments and run bulk operations up to 200 objects per request. A separate block handles Russia's mandatory ad-marking (ORD) for agency accounts, including reporting documents. Client credentials live outside the skill in a 700-permission folder and never enter git.

Who it is for. For agencies and freelancers running multiple VK Ads accounts who want to automate reporting and routine operations.

Good fit when

  • You run several client VK Ads accounts with separate credentials
  • You need automated ORD ad-marking for an agency account
  • You need look-alike and hashed remarketing audiences without manual uploads

Not a fit when

  • You only need to view statistics without campaign-editing rights
  • You have no VK Ads OAuth application and do not want to set one up for a single account

Example request

Build a March report for client acme: top ads by ROMI and where the lead-form leads went

Limitations

The skill needs Python 3.11+ and a working Claude Code install, and some reports require Google Sheets API credentials. The author notes that a few management methods' request bodies still need live API exploration. There are no releases or a changelog, just the main branch.

How to disable. Delete the ~/.claude/skills/vk-ads folder and client files under ~/.claude/secrets/vk-ads.

FAQ

How does the skill store data for different clients?

Each client is a separate env file under ~/.claude/secrets/vk-ads/clients with 600 permissions, and the secrets folder itself has 700 permissions.

Is Google Sheets required for the skill to work?

No, it is an optional part for auto-filling monthly reports; core analytics and campaign management work without it.

Discussion

No questions or reviews yet.

All VK tools
Russian stack

A Claude Code skill for the full VK Ads cycle: campaigns, ad groups, banners, statistics, remarketing and lead forms via bash scripts

SkillBroad access2
Russian stack

A skill that walks an agent through the full VK Ads campaign path: from competitors and audiences to banners and a paused account structure

SkillExtended access3
Russian stack

Claude Code skill: collects semantics for VK Ads from real Wordstat via browser, without Direct or paid APIs

SkillExtended access
Russian stack

A VK Ads MCP server with a turnkey installer: 136 tools, VK community research and a skill for several agents at once

MCP serverBroad access

BotHelp analytics skill

claude-skill-bothelp

Russian stack

A Claude Code skill for the BotHelp Open API: a bot map, step-by-step drop-off, subscriber export and limited management via the open API

SkillExtended access

Senler analytics skill

claude-skill-senler

Russian stack

A Claude Code skill for Senler: funnel and broadcast analytics for VK chat bots, tag-based subscriber segmentation by drop-off and churn

SkillExtended access1

README in short

The README positions the skill as covering much of a senior VK performance marketer's work: analytics, template-based campaign launches, bulk management and agency ad-marking. It separately shows installation by cloning into the skills folder, requirements (Python 3.11+, Claude Code, a VK Ads OAuth app), per-client secrets kept outside git, and a direct API call to verify the token.

README badge

Report a problem