Agent skill
yandex-webmaster
Управление сайтами через Yandex Webmaster API: индексация, поисковые запросы, сайтмапы, переобход, ссылки, фиды, диагностика. Triggers: яндекс вебмастер, yandex webmaster, webmaster api, вебмастер индексация, вебмастер запросы, вебмастер переобход.
Stars
73
Forks
21
Install this agent skill to your Project
npx add-skill https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/yandex-webmaster/skills/yandex-webmaster
SKILL.md
yandex-webmaster
Работа с Yandex Webmaster API v4. Управление сайтами, анализ индексации, поисковые запросы, переобход страниц, ссылки, фиды.
Config
Требуется YANDEX_WEBMASTER_TOKEN в config/.env.
Scope: webmaster:hostinfo + webmaster:verify.
Инструкция: config/README.md.
Philosophy
- Cache-first — список сайтов, user_id кешируются надолго. Отчёты кешируются по ключу host+params. Диагностика, квоты, статусы — всегда live.
- Context window hygiene — stdout ограничен 30 строками. Полные данные в TSV/файл. Кеш доступен через grep/rg.
- Host resolution — все скрипты принимают
--host <domain>(поиск по кешу hosts.tsv) или--host-id <id>(прямой ID). Первый вызов hosts.sh автоматически кеширует список. - No destructive ops — скилл не удаляет сайты, сайтмапы и фиды. Только чтение и добавление.
Workflow
STOP! Перед любым анализом:
-
Получи список сайтов:
bashbash scripts/hosts.sh -
Спроси пользователя (если сайт не очевиден из контекста):
"О каком сайте идёт речь? Укажите домен или host_id из списка."Для поиска по кешу:
bashbash scripts/hosts.sh --search "example" -
Получи сводку по сайту:
bashbash scripts/summary.sh --host example.com -
Запускай нужные отчёты по задаче пользователя.
Scripts
Общий паттерн вызова:
bash
bash scripts/<script>.sh --host <domain> [--action <action>] [params...]
Управление сайтами
| Script | Description | Key params |
|---|---|---|
hosts.sh |
Список сайтов | --search "text", --no-cache |
host_info.sh |
Инфо о сайте + владельцы | — |
add_site.sh |
Добавить сайт | --url <url> |
verify.sh |
Верификация сайта | --action get|start, --method DNS|HTML_FILE|META_TAG |
Статистика сайта
| Script | Description | Key params |
|---|---|---|
summary.sh |
Сводка: SQI, страницы, проблемы | — |
sqi_history.sh |
История SQI | --date-from, --date-to |
diagnostics.sh |
Проблемы сайта (live) | — |
Поисковые запросы
| Script | Description | Key params |
|---|---|---|
popular_queries.sh |
Топ запросов | --order-by, --device, --limit |
queries_history.sh |
История запросов | --query-id (опц.), --device |
query_analytics.sh |
Расширенная аналитика (POST) | --text-indicator, --filter-*, --region-ids |
Индексация
| Script | Description | Key params |
|---|---|---|
indexing.sh |
История/сэмплы индексации | --action history|samples |
important_urls.sh |
Важные URL | --action list|history, --url |
archive_export.sh |
Экспорт всех страниц | --action start|status, --task-id |
Страницы в поиске
| Script | Description | Key params |
|---|---|---|
insearch.sh |
Страницы в выдаче | --action history|samples |
search_events.sh |
Появление/исчезновение | --action history|samples |
Переобход
| Script | Description | Key params |
|---|---|---|
recrawl.sh |
Переобход URL | --action submit|status|list|quota, --url, --task-id |
Ссылки
| Script | Description | Key params |
|---|---|---|
internal_links.sh |
Битые внутренние ссылки | --action samples|history, --indicator |
external_links.sh |
Внешние ссылки | --action samples|history |
Сайтмапы
| Script | Description | Key params |
|---|---|---|
sitemaps.sh |
Управление сайтмапами | --action list|user-list|info|add|recrawl-limit|recrawl |
Фиды и PRO
| Script | Description | Key params |
|---|---|---|
feeds.sh |
YML-фиды | --action list|add|change|add-status, --type, --region-ids |
search_export.sh |
PRO SERP экспорт | --action dates|limits|start|status |
regions.sh |
Справочник регионов | --filter "москва" |
Общие параметры
| Param | Description |
|---|---|
--host <domain> |
Домен/URL сайта (поиск по hosts.tsv) |
--host-id <id> |
Прямой host_id (формат: http:example.com:80) |
--action <act> |
Подкоманда скрипта |
--date-from |
Начало периода YYYY-MM-DD (history: default 90 дней назад) |
--date-to |
Конец периода YYYY-MM-DD |
--limit N |
Число записей |
--offset N |
Смещение |
--no-cache |
Пропустить кеш |
Кеш-стратегия
Кеш в cache/:
user_id.txt— ID пользователя (permanent)hosts.json+hosts.tsv— список сайтов (permanent, инвалидируется при add/verify)host_*/queries/*.tsv— результаты запросов (session, hash-keyed)host_*/indexing/*.tsv— данные индексации (session)host_*/insearch/*.tsv— данные о поиске (session)host_*/links/*.tsv— данные о ссылках (session)- Диагностика, квоты, статусы переобхода — не кешируются (always live)
Расширенные сценарии
- Добавление и верификация сайтов
- Поисковые запросы и аналитика
- Управление сайтмапами
- Статистика сайта и индексация
- Страницы в поиске
- Переобход страниц
- Битые внутренние ссылки
- Внешние ссылки
- YML-фиды
- PRO SERP экспорт
- Расписание врачей (спецификация)
Лимиты API
- Query Analytics: 10 000 запросов/час на домен
- Скрипты автоматически обрабатывают 429 (Retry-After ≤ 60s → retry, иначе fail)
- Лимит сайтов: 1703 на аккаунт
- Лимит фидов: 5000 на сайт, 50 в batch
- Лимит export: макс. 100 комбинаций дат+URL
Didn't find tool you were looking for?