Руководство по API-запросам IndexNow описывает технический протокол, с помощью которого владельцы сайтов могут мгновенно сообщать поисковым системам, таким как Яндекс, о создании, обновлении или удалении страниц. Отправляя простой HTTP-запрос с адресом страницы и уникальным ключом, вы направляете поисковых роботов на обработку свежих изменений без ожидания стандартного цикла обхода. Такой подход снижает нагрузку на сервер и ускоряет индексацию актуальной информации в сети.
Что такое API IndexNow и почему это важно?
Традиционный краулинг опирается на то, что поисковые системы обнаруживают ссылки или проверяют файлы sitemap в своем собственном темпе. Это часто приводит к разрыву между публикацией и индексацией. IndexNow меняет это, возвращая контроль владельцу веб-сайта. Вы сообщаете поисковой системе, что страница готова, и она отвечает планированием визита.
Протокол особенно полезен для сайтов, которые ежедневно публикуют множество страниц. Например, новостному порталу или крупному розничному сайту необходимо, чтобы их самые свежие данные появлялись в результатах поиска как можно быстрее. Без этого API новой статье может потребоваться ждать часы или дни, чтобы ее обнаружил стандартный краулер.
Как структурировать корректный запрос к API IndexNow?
Стандартный запрос требует трех основных элементов: хоста, списка URL-адресов и ключа. Хост — это доменное имя, на котором произошли изменения. Список URL-адресов может содержать до 10 000 ссылок за один запрос, хотя одиночные обновления являются обычным делом. Ключ — это строка, которая доказывает, что вы владеете доменом. Обратите внимание, что ключ должен размещаться на вашем сервере для прохождения верификации.
- Эндпоинт API, такой как yandex.com/indexnow.
- Заголовок content-type должен быть установлен в application/json.
- Тело JSON, содержащее хост, ключ и список URL-адресов.
- keyLocation, который указывает путь к вашему файлу верификации.
Запрос может быть отправлен как POST или GET. Метод POST является предпочтительным для пакетной обработки нескольких URL-адресов. При использовании POST тело запроса содержит данные в структурированном формате. Метод GET проще, но поддерживает только один URL-адрес за раз. Большинство разработчиков выбирают POST из-за его эффективности.
Мы замечаем, что многие разработчики забывают точно сопоставить ключ между телом API и текстовым файлом. Разница всего в один символ или лишний пробел приведет к тому, что верификация сразу же завершится с ошибкой.
Команда SEO Alien Road
Каковы ключевые компоненты для валидации?
Безопасность обеспечивается с помощью текстового файла, размещенного в корневом каталоге. Этот файл содержит ту же строку ключа, которая используется при вызове API. Поисковые системы проверяют запрос, запрашивая этот файл с вашего сервера. Если ключ в запросе совпадает с ключом в файле на вашем сервере, запрос проходит аутентификацию.
Сам ключ должен состоять не менее чем из 8 символов, но использование 32-символьной буквенно-цифровой строки является более надежным стандартом. Вы должны назвать текстовый файл в честь ключа. Например, если ваш ключ — ‘abc123’, ваш файл должен называться ‘abc123.txt’. Это позволяет поисковой системе найти его без догадок.
Как обрабатывать распространенные ошибки ответа API?
Подобно ошибкам RSS-лент, упомянутым в технической документации, запросы IndexNow завершаются ошибкой, если синтаксис неверчен. Ошибка 400 Bad Request обычно означает, что формат JSON недействителен или отсутствует обязательное поле. Ошибка 403 Forbidden предполагает, что ключ неверчен или краулер не может получить доступ к файлу ключа. Обратите внимание, что техническая гигиена жизненно важна для успеха.
- 400: Неверный синтаксис. Проверьте JSON на наличие пропущенных кавычек или запятых.
- 403: Проверка ключа не удалась. Убедитесь, что файл находится в корневом каталоге.
- 422: URL-адрес не принадлежит хосту, указанному в запросе.
- 429: Слишком много запросов. Снизьте частоту вызовов API.
Если вы видите ошибку 403, проверьте, не блокирует ли ваш сервер пользовательский агент поисковой системы. Иногда брандмауэры мешают краулеру получить файл ключа. Вы должны разрешить доступ к конкретному URL-адресу верификации, чтобы поддерживать бесперебойную связь между вашим сайтом и поисковой системой.
Как Alien Road применяет справочник запросов API indexnow
В Alien Road мы интегрируем API IndexNow в рабочий процесс CMS для наших клиентов. Для типичного сайта электронной коммерции с тысячами товаров ручная индексация невозможна. Мы настраиваем автоматический триггер, который срабатывает каждый раз, когда меняется цена товара или добавляется новый элемент. Это гарантирует, что поисковая система получает самые актуальные данные без задержки.
В рамках типичного проекта мы сначала генерируем уникальный ключ и размещаем его в корне сервера клиента. Затем мы настраиваем их бэкенд для пакетной обработки URL-адресов и отправки их на эндпоинт Yandex каждый час. Это предотвращает перегрузку сервера и в то же время гарантирует, что снижение цен или обновление запасов появятся в результатах поиска в течение нескольких минут. Для магазина на Shopify, продающего товары для дома, этот процесс поддерживает точность данных об их инвентаре для потенциальных клиентов.
Использование IndexNow для масштабных миграций — сильная стратегия. Вместо того чтобы ждать недели, пока перенос сайта будет распознан, мы отправляем новые URL-адреса напрямую, что помогает поддерживать стабильность трафика во время перехода.
Команда SEO Alien Road
Технические характеристики и ограничения
Хотя API мощный, у него есть ограничения, которые вы должны соблюдать. Вы не можете отправить более 10 000 URL-адресов в одном запросе POST. Кроме того, все URL-адреса должны принадлежать одному и тому же хосту. Если вы управляете несколькими поддоменами, для каждого из них требуется свой собственный ключ и свой собственный вызов API для корректной обработки.
Форматирование полезной нагрузки JSON строгое. Подобно требованиям к новостным лентам, URL-адреса в IndexNow должны быть абсолютными и полностью определенными. Они должны использовать правильный протокол, либо HTTP, либо HTTPS. Специальные символы должны быть должным образом экранированы с использованием кодировки UTF-8. Лишняя кавычка или неправильно закрытый атрибут остановят индексацию всего пакета.
Сравнение IndexNow с XML Sitemap
XML-карты сайта — это пассивные файлы, которые поисковые системы проверяют время от времени. IndexNow — это система активных уведомлений. Хотя вам по-прежнему следует поддерживать карту сайта для полной видимости структуры сайта, API является лучшим выбором для обновлений, чувствительных ко времени. Использование обоих методов вместе обеспечивает полноценную стратегию индексации.
Карты сайта иногда могут становиться очень большими, что приводит к замедлению времени обработки. IndexNow избегает этого, сосредотачиваясь только на том, что изменилось недавно. Такой целенаправленный подход более эффективен как для вашего сервера, так и для ресурсов поисковой системы. Он снижает необходимость для краулера неоднократно посещать неизмененные страницы.
С чего начать на этой неделе
Начните с проверки того, есть ли у вашей CMS встроенный плагин IndexNow. Если нет, сгенерируйте 32-символьный ключ и загрузите его в корень вашего сервера в виде файла .txt. Проверьте один URL-адрес с помощью простого инструмента командной строки, чтобы убедиться, что вы получаете ответ 200 OK. После проверки соединения автоматизируйте процесс для всех обновлений нового контента, чтобы ваше присутствие в поиске оставалось актуальным.
Следите за логами вашего сервера на предмет визита поисковой системы после отправки запроса. Это подтверждает, что система работает. Если вы заметили ошибки, обратитесь к списку кодов ошибок и проверьте синтаксис JSON на наличие распространенных ошибок, таких как неэкранированные символы или пропущенные фигурные скобки.