Wordstat Skill — AI-Powered Yandex SEO for Claude Code & GPT

Here's a thing that shouldn't surprise anyone: there are hundreds of Claude Code skills for writing React components. There are approximately zero for Russian-language SEO research.

Wordstat Skill is a Claude Code slash command that gives your AI agent access to live Yandex Wordstat data. You type /wordstat, and your agent runs keyword research against the real Russian search market — not generic advice from training data.

The problem with Russian SEO + AI

Ask Claude or GPT "what keywords should I target for my Russian website" and it will give you… something. Educated guesses. Semantic neighborhood. What sounds reasonable.

But it won't tell you that "заказать сайт" gets searched 94,765 times a month, while "разработка сайтов для бизнеса" gets 207. It won't tell you that people in Nizhny Novgorod search for "цемент" 2.3× more than the national average. It won't tell you that demand for your category peaks in March and dies in December.

Training data doesn't know this. Live Yandex Wordstat does.

How the skill works

You: /wordstat

Claude: [reads your project, detects Payload CMS, pulls category titles]

[runs them through Yandex Cloud Search API v2]

[returns: search volumes, trends, regional data, SEO placement guide]

[optionally: writes seoTitle + seoDescription back to your CMS via REST API]

One slash command. Your agent becomes an SEO analyst with access to live Russian search data.

What the agent gets back

Real example from my own site

I ran it on devclicks.ru. The agent pulled keywords relevant to a web development portfolio serving Russian clients. In 30 seconds it surfaced:

• "создание сайтов" at 115,421/mo — my homepage title didn't mention it at all
• "заказать сайт" at 94,765/mo — nowhere in my CTAs
• "фрилансер веб-разработчик" — zero volume, people don't search for this

I was optimizing for phrases nobody types and ignoring the ones with 115K monthly searches. The agent told me exactly what to change. Five minutes of editing later, the metadata was fixed.

Why this matters for AI-assisted SEO

The pattern is: agent as operator, live API as ground truth.

Claude is great at writing copy and structuring arguments. But it can't know your market's search volumes unless you give it a live data source. This skill connects the two — the agent plans and writes, Wordstat provides the numbers that make the plan correct.

Making it a skill (not just a script)

The key design decision was packaging it as a SKILL.md — a markdown file that tells any Claude Code instance how to use the tool. No special install. Drop it in .claude/commands/ and /wordstat just works.

The instructions handle:

• Detecting your CMS type (Payload, database, manual keywords)
• Picking the right API endpoints based on what you need
• Interpreting results in context (not just dumping raw data)
• Writing changes back to your CMS only when you confirm

It's the difference between "here's a CSV of keyword data, good luck" and "here's exactly what to change on which page, with the data to back it up."

Installation

# 1. Clone the repo

git clone https://github.com/salahamran/wordstat-cli

# 2. Copy the skill to your Claude Code project

cp wordstat-cli/SKILL.md ~/your-project/.claude/commands/wordstat.md

# 3. Add your Yandex Cloud credentials to .env

# (free tier: 1,000 requests/month)

# 4. Type /wordstat in Claude Code

That's it. Your agent now speaks Yandex Wordstat.