Wordstat Skill — AI-навык для Яндекс SEO в Claude Code и GPT

Ситуация, которая никого не должна удивлять: существуют сотни Claude Code skills для написания React-компонентов. И примерно ноль — для русскоязычных SEO-исследований.

Пришлось сделать свой.

Wordstat Skill — это слеш-команда Claude Code, которая даёт вашему AI-агенту доступ к живым данным Яндекс Wordstat. Вы пишете /wordstat, и агент проводит исследование ключевых слов по реальному российскому поисковому рынку — а не выдаёт общие советы из тренировочных данных.

Проблема русского SEO + AI

Спросите Клода или GPT: «какие ключевые слова использовать для моего сайта на русском», и он выдаст… что-то. Образованные догадки. Семантическое окружение. То, что звучит разумно.

Но он не скажет вам, что «заказать сайт» ищут 94 765 раз в месяц, а «разработка сайтов для бизнеса» — 207. Не скажет, что в Нижнем Новгороде «цемент» ищут в 2,3 раза чаще среднего по стране. Не скажет, что спрос на вашу категорию взлетает в марте и падает в декабре.

Тренировочные данные этого не знают. Живой Яндекс Wordstat — знает.

Как работает навык

Вы: /wordstat
Клод: [читает ваш проект, определяет Payload CMS, загружает названия категорий]
[прогоняет их через Yandex Cloud Search API v2]
[возвращает: поисковые запросы, динамику, регионы, руководство по размещению]
[опционально: записывает seoTitle + seoDescription обратно в CMS через REST API]

Одна слеш-команда. Ваш агент превращается в SEO-аналитика с доступом к живым данным российского поиска.

Что получает агент

Реальный пример с моего сайта

Я запустил навык на devclicks.ru. Агент взял ключевые слова, релевантные портфолио веб-разработчика для российских клиентов. За 30 секунд он показал:

• «создание сайтов» — 115 421 показов/мес, а в моём заголовке этого не было вообще
• «заказать сайт» — 94 765 показов/мес, нигде в CTA не упоминалось
• «фрилансер веб-разработчик» — ноль запросов, люди это не ищут

Я оптимизировал страницы под фразы, которые никто не вводит, и игнорировал те, у которых 115 тысяч показов в месяц. Агент сказал мне, что именно менять. Через пять минут правок метаданные были исправлены.

Почему это важно для AI-ассистированного SEO

Паттерн такой: агент как исполнитель, живой API как источник истины.

Клод отлично пишет тексты и выстраивает аргументацию. Но он не знает поисковые объёмы вашего рынка, пока вы не дадите ему источник живых данных. Этот навык соединяет и то, и другое — агент планирует и пишет, Wordstat даёт цифры, делающие план верным.

Сделано как навык (не просто скрипт)

Ключевое решение — упаковать это как SKILL.md: markdown-файл, который объясняет любому экземпляру Claude Code, как использовать инструмент. Никакой специальной установки. Положите в .claude/commands/, и /wordstat просто работает.

Инструкции обрабатывают:

• Определение типа CMS (Payload, база данных, ручные ключевые слова)
• Выбор правильных эндпоинтов API в зависимости от задачи
• Интерпретацию результатов в контексте (а не просто выгрузку сырых данных)
• Запись изменений обратно в CMS только после вашего подтверждения

Разница между «вот CSV с данными, удачи» и «вот что именно изменить на какой странице, с цифрами в подтверждение».

Установка

# 1. Клонируйте репозиторий
git clone https://github.com/salahamran/wordstat-cli

# 2. Скопируйте навык в проект Claude Code
cp wordstat-cli/SKILL.md ~/ваш-проект/.claude/commands/wordstat.md

# 3. Добавьте учётные данные Яндекс Cloud в .env
# (бесплатный тариф: 1 000 запросов/мес)

# 4. Напишите /wordstat в Claude Code

Всё. Ваш агент теперь говорит на языке Яндекс Wordstat.