Позиции в поиске (XMLRiver) — версия 58, большие семантики

SEOMaster не парсит выдачу сам: позиции берутся из платного API XMLRiver (Яндекс и Google). Хранится позиция, адрес найденной страницы и домены топ-10 по каждому запросу, 180 дней. Стоимость проверок определяет ваш тариф у сервиса; SEOMaster лишь ограничивает число запросов.

Подключение (/positions)

Ключ вводится в виде номер_пользователя:ключ. Проверка ключа — запрос баланса.

Масштаб

• До serp_max_keywords (2000) запросов на сайт и serp_user_max (5000) на пользователя. Оценка нагрузки «проверок в месяц» показана на странице сайта.
• Список запросов: поиск, фильтры (система, устройство, группа, корзина позиций, движение), сортировка, страницы по 50. Сводка по каждому запросу хранится в sp_kw, поэтому список не читает всю историю.
• Групповые действия: задать группу, частоту, приоритет, глубину, удалить — для отмеченных или для всех найденных по фильтру.

Параметры запроса

• Система: Яндекс (регион lr) или Google (локация loc); устройство: desktop или mobile.
• Глубина: 10 / 30 / 50 / 100 результатов (для запроса и по умолчанию).
• Частота: каждый день / раз в 3 дня / раз в неделю; приоритет: высокий / обычный / низкий. Проверяются те, кому пора по расписанию, сначала с высоким приоритетом и самые давние.
• Группа: произвольная метка (до 40 символов).

Импорт

Вставка списком или CSV (UTF-8 или Windows-1251). Колонки находятся по заголовку: запрос, система, регион, устройство, группа, частота, глубина, приоритет. Нет заголовка — каждая строка это запрос; недостающие значения берутся из полей формы. До 5000 строк за раз; повторы и превышение лимитов пропускаются с пояснением.

Проверка и бюджет

• bin/positions.php запускается по cron каждые 10 минут, работает отрезками (serp_cron_seconds, 240 с) и берёт не больше serp_daily_limit (1000) проверок на пользователя в сутки (считается по сохранённым результатам).
• Остановка прогона: бюджет шлюза провайдеров, пауза сервиса, время, фатальная ошибка (неверный ключ, закончились деньги). Ошибка одного запроса его пропускает.
• Кнопка «Проверить сейчас» на странице сайта — до 40 запросов за раз.

Показатели

• Динамика к прошлой проверке и за неделю; вылет из выдачи считается 101-м местом.
• Видимость, %: средний ожидаемый CTR по запросам относительно первого места; также по группам и во времени.
• Доля в выдаче (share of voice): вес позиций по домену среди конкурентов в топ-10.
• Смена посадочной страницы (URL flips) и волатильность позиции.
• События: serp-drop (запрос был в топ-10 и упал на 5+ мест или вылетел).

Диспетчерская

Задачи q:near (на границе топ-10), q:drop (упал), q:flip (сменилась страница), q:stale (давно не проверялся) попадают в «Сегодня» и в недельный план; позиции входят в хаб сайта и выгрузку positions-now.

Cron

*/10 * * * * php bin/positions.php (см. deploy/crontab.example)

Настройки (config.php / окружение)

serp_daily_limit (SEOMASTER_SERP_DAILY), serp_max_keywords (SEOMASTER_SERP_MAX), serp_user_max (SEOMASTER_SERP_USER_MAX), serp_cron_seconds (SEOMASTER_SERP_CRON_SEC).

Ограничения

Формат ответов XMLRiver, глубина 100 и параметр устройства mobile заданы по документации и проверены только на подставных ответах и на синтетической базе в 1500 запросов; цифры скорости получены в тестовой среде. Результаты Google зависят от локации.