Manage Yandex Webmaster Site Data

This skill manages websites through the Yandex Webmaster API v4, covering site management and verification, indexing analysis, search query performance, page recrawl requests, internal/external link auditing, sitemap management, and YML feed handling. Like its Wordstat and Metrika counterparts, it follows a cache-first philosophy for context-window hygiene: the site list and user ID are cached long-term, reports are cached by host and parameter combination, but diagnostics, quota status, and recrawl status are always fetched live since those change too frequently to cache safely. Full report data goes to TSV files rather than flooding stdout (capped at 30 lines), with the cache searchable via grep/rg.

Every script accepts a site either by --host <domain> (resolved via a cached hosts lookup) or a direct --host-id, and the skill is explicitly non-destructive - it never deletes sites, sitemaps, or feeds, only reads and adds. Its mandatory workflow before any analysis: list available sites, ask the user which site is in question if not obvious from context (searchable by domain text), and pull a site summary (SQI score, page counts, known issues) before running task-specific reports. Its script families cover: site management (hosts.sh, host_info.sh, add_site.sh, verify.sh with DNS/HTML-file/meta-tag verification methods); site statistics (summary.sh, sqi_history.sh, live diagnostics.sh); search queries (popular_queries.sh, queries_history.sh, and a POST-based query_analytics.sh for advanced filtered analytics); indexing (indexing.sh for history/samples, important_urls.sh, an archive_export.sh for exporting all pages); pages in search results (insearch.sh, search_events.sh for appearance/disappearance tracking); recrawl (recrawl.sh supporting submit/status/list/quota actions); links (internal_links.sh for broken internal links, external_links.sh); sitemaps (sitemaps.sh with list/info/add/recrawl actions); and feeds/PRO features (feeds.sh for YML feeds, search_export.sh for PRO SERP export, regions.sh as a region reference).

Use this skill when managing a site's presence in Yandex search - checking indexing status, analyzing search query performance, requesting recrawls of updated pages, auditing internal or external links, managing sitemaps, or working with YML product feeds for a site verified in Yandex Webmaster.

It requires a YANDEX_WEBMASTER_TOKEN with webmaster:hostinfo and webmaster:verify scopes configured in config/.env, and operates under hard account limits: 10,000 query-analytics requests per hour per domain, a maximum of 1,703 sites per account, 5,000 feeds per site (50 per batch), and export limited to 100 date+URL combinations - the scripts handle 429 rate-limit responses automatically. It cannot delete sites, sitemaps, or feeds by design, so it's not the tool for cleanup or removal tasks - only for adding, reading, and monitoring.

Input is a site identified by domain or host ID, plus the specific report or action requested - indexing history, query analytics, recrawl submission, link audit, sitemap/feed management. Output is the corresponding report data, summarized to stdout or exported to TSV for larger results, or a confirmation/status for action-based operations like recrawl submission or site verification.

bash scripts/recrawl.sh --action submit --url https://example.com/page

Built on the Yandex Webmaster API v4, with a local cache directory (cache/host_*/) storing site lists, query/indexing/insearch/link report data, searchable via standard grep/rg tooling, and reference guides for site management, sitemaps, feeds, and PRO SERP export.

SEO specialists and site owners managing a domain's presence in Yandex search who need indexing, query performance, recrawl, link, and feed management without repeatedly re-resolving site identity or flooding their session with raw report data.