Читайте поисковые запросы Яндекс Вебмастера по URL для подтверждённого вами хоста и храните строки рядом со сканированием. Только чтение, с OAuth-токеном, бесплатно в пределах квоты Webmaster API.
webmaster-url-queries возвращает поисковые запросы для одной точной страницы (--url) или для группы страниц (--url-contains). Строки по URL и по запросам остаются раздельными. CTR и средняя позиция не суммируются по страницам.
Нужны ID хоста, подтверждённого в вашем аккаунте Яндекс Вебмастера, и OAuth-токен для этого аккаунта. Токен задаётся в YANDEX_WEBMASTER_TOKEN или в файле токена. SpiderHead не создаёт аккаунты и не входит в них за вас. provider-discover может показать хосты, которые видит токен.
sources-sync может сохранять ежедневные данные Вебмастера в локальную историю SQLite, так что данных накапливается больше, чем отдаёт API за один раз. evidence-join прикрепляет строки, привязанные к URL, к сканированию и выводит кандидатов в страницы-сироты для проверки. Ни один из этих шагов не меняет сканирование.
Команде нужны ID хоста в Яндекс Вебмастере для сайта, права на который вы подтвердили, и OAuth-токен, настроенный локально. Без ID хоста она не запускается.
Запросите одну точную страницу через --url или группу через --url-contains. Лимиты задаются явно: --max-urls и --max-queries-per-url, при необходимости с --start-date и --end-date.
Строки по URL и по запросам держите раздельно. Шаг evidence-join прикрепляет строки, привязанные к URL, к сканированию и выводит кандидатов в страницы-сироты для проверки, не меняя сканирование.
seohead webmaster-url-queries --url https://example.com/Сначала установите: руководство по установке. Каждая команда работает и как MCP-инструмент для ИИ-агентов.