Yandex Direct Skill
A skill for auditing and running Yandex Direct campaigns via API v5: 55 checks, an A-F grade, ad creation and reports
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- Can create and change campaigns, bids and ads in a real ad account
- Spends ad budget through the API, so an agent mistake causes real charges
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/yandex-direct-skillDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal in the project folder
npx skills add silverov/yandex-direct-skill --skill direct -a claude-code -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add silverov/yandex-direct-skill --skill direct -a cursor -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add silverov/yandex-direct-skill --skill direct -a github-copilot -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add silverov/yandex-direct-skill --skill direct -a codex -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add silverov/yandex-direct-skill --skill direct -a gemini-cli -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add silverov/yandex-direct-skill --skill direct -a cline -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add silverov/yandex-direct-skill --skill direct -a roo -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
A fork of Roo Code, same .roo folders.
Run in a terminal in the project folder
npx skills add silverov/yandex-direct-skill --skill direct -a opencode -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Clone the Silverov/yandex-direct-skill repository, copy the skill folder into ~/.claude/skills/, get a Direct OAuth token at oauth.yandex.ru and save it with client_id and client_secret into ~/.secrets/yandex-direct.json, then run /direct audit.
Other ways from the author
cp -r yandex-direct ~/.claude/skills/After cloning the repo, copy the skill folder into the Claude Code skills directory.
This is third-party code. Review the repository files before installing.
What it does
The skill gives an agent commands for Yandex Direct through the REST API v5: account audits, a campaign list, campaign creation with ad groups and ads, keyword and negative-keyword management, CTR, CPC and spend reports, optimization suggestions and budget analysis. The audit runs 55 checks across six categories (conversions and Metrika, wasted spend, account structure, keywords, ads, settings and targeting); a weighted score turns into an A-F grade. The kit includes reference docs with Russian market CTR, CPC and CVR benchmarks and a bidding-strategy decision table.
Who it is for. For PPC specialists and marketers running Yandex Direct campaigns who want to hand the routine work to an agent.
Good fit when
- You need a quick Yandex Direct account audit with a score and a list of issues
- You want an agent to create a campaign or ads without opening the Direct interface
- You need regular CTR, CPC and spend reports checked against market benchmarks
Not a fit when
- You need ads in Google Ads, VK or another system: the skill covers only Direct
- You have no Direct API access or OAuth token: the skill will not work without them
Example request
Audit my Yandex Direct account and show me what is wasting budgetLimitations
You need your own Direct API access and OAuth token, issued by Yandex on request. Credentials are stored in a plain JSON file on disk, and file permissions have to be restricted manually. The project is young and built around one agency's own case, with no formal releases or tests. The integration scripts are written in bash for a Unix environment.
How to disable. Delete the yandex-direct folder from your agent's skills directory, for example ~/.claude/skills/yandex-direct.
Security check
- Can create and change campaigns, bids and ads in a real ad account
- Spends ad budget through the API, so an agent mistake causes real charges
README in short
The README presents the skill as the first open source Yandex Direct tool for AI agents, built for OpenClaw and compatible with Claude Code. It lists eight commands, a 55-check audit structure across six weighted categories, Russian market CTR, CPC and CVR benchmarks, and setup steps: applying for API access, getting an OAuth token, saving credentials and copying the skill folder. The authors say they built it in one evening to set up their own campaigns and ran the audit on their own account. MIT license.
SKILL.md
--- name: direct description: > Yandex Direct (API v5) advertising audit, management, and optimization. Full account audits, campaign management, keyword operations, reporting, budget analysis, and optimization recommendations for Russian market PPC. Triggers on: "Яндекс Директ", "Yandex Direct", "директ", "РСЯ", "YAN", "direct audit", "direct campaigns", "direct report", "direct optimize". argument-hint: "audit | campaigns | create | keywords | report | optimize | budget | negative" allowed-tools: - Read - Grep - Glob - Bash - WebFetch --- # Yandex Direct — PPC Audit & Management (API v5) Full-cycle Yandex Direct management: account audits, campaign CRUD, keyword management, reporting, optimization, and budget analysis. ## Quick Reference | Command | What it does | |---------|-------------| | /direct audit | Full account audit (all campaigns), scoring 0-100 | | /direct campaigns | List campaigns with statuses and key metrics | | /direct create | Create campaign (Search/YAN) with ad groups, keywords, ads | | /direct keywords | Keyword management (list, add, update bids, pause) | | /direct report | Performance stats (CTR, CPC, conversions, spend) | | /direct optimize | Optimization recommendations (pause losers, adjust bids) | | /direct budget | Budget spend analysis and forecasting | | /direct negative | Negative keyword management (campaign & shared sets) |
FAQ
How many checks does the audit run?
55 weighted checks across six categories, with a 0-100 score turned into an A-F grade.
Where is the Direct token stored?
In ~/.secrets/yandex-direct.json along with client_id and client_secret; you have to restrict access to that file yourself.
Related
Official DataLens (Yandex) skills for Claude Code, Codex and OpenCode: SDK, HTML reports and RLS resolution
A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata
An open MCP server and agent skill set for SEO: keyword research, competitors, backlinks and site audits powered by DataForSEO
A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents