yandex-webmaster

Apps & Automation

Управление сайтами через Yandex Webmaster API: индексация, поисковые запросы, сайтмапы, переобход, ссылки, фиды, диагностика. Плюс scraping раздела Alice / Share of Voice (нет публичного API). Triggers: яндекс вебмастер, yandex webmaster, webmaster api, вебмастер индексация, вебмастер запросы, вебмастер переобход, share of voice, sov, алиса, alice efficiency, конкуренты в алисе.

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/artwist-polyakov/polyakov-claude-skills/blob/HEAD/plugins/yandex-webmaster/skills/yandex-webmaster/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/yandex-webmaster, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

yandex-webmaster

Работа с Yandex Webmaster API v4. Управление сайтами, анализ индексации, поисковые запросы, переобход страниц, ссылки, фиды.

Config

Требуется YANDEX_WEBMASTER_TOKEN в config/.env. Scope: webmaster:hostinfo + webmaster:verify. Инструкция: config/README.md.

Для alice.sh (Share of Voice, без публичного API) дополнительно нужен SESSION_ID — cookie из браузера. Подробности в config/README.md и references/ALICE_EFFICIENCY.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! Перед любым анализом:

Получи список сайтов:
```
bash scripts/hosts.sh
```

Спроси пользователя (если сайт не очевиден из контекста):

"О каком сайте идёт речь?
Укажите домен или host_id из списка."

Для поиска по кешу:

bash scripts/hosts.sh --search "example"

Получи сводку по сайту:

bash scripts/summary.sh --host example.com

Запускай нужные отчёты по задаче пользователя.

Scripts

Общий паттерн вызова:

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`

Alice / Share of Voice (SSR scraping)

Script	Description	Key params
`alice.sh`	Эффективность в Алисе: SoV timeline, конкуренты, запросы где сайт есть/нет	`--action summary\|sov\|competitors\|with-site\|without-site\|fetch`, `--no-cache`

⚠ Нет публичного API — данные парсятся из window._initData HTML-страницы. Требует SESSION_ID cookie в config/.env. См. references/ALICE_EFFICIENCY.md.

Фиды и 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)
host_*/alice/init.json — распарсенный alice объект, переиспользуется всеми action'ами alice.sh (refresh: --no-cache или --action fetch)
Диагностика, квоты, статусы переобхода — не кешируются (always live)

Расширенные сценарии

Лимиты API

Query Analytics: 10 000 запросов/час на домен
Скрипты автоматически обрабатывают 429 (Retry-After ≤ 60s → retry, иначе fail)
Лимит сайтов: 1703 на аккаунт
Лимит фидов: 5000 на сайт, 50 в batch
Лимит export: макс. 100 комбинаций дат+URL