IndexNow для Bing и Яндекса в Next.js: ключ, отправка URL и почему Google не в списке
Что делает IndexNow и чего не делает
IndexNow — открытый протокол, через который сайт сообщает поисковым системам: «эти адреса добавлены, изменены или удалены». Поддерживают его Bing, Яндекс и ещё несколько поисковиков; уведомление, отправленное одному участнику, передаётся остальным.
Чего протокол не делает:
- Не гарантирует индексацию. Поисковик узнаёт о странице быстрее, но решение индексировать и время появления в выдаче остаются за ним.
- Не работает для Google. Google не участвует в IndexNow. Для него основные сигналы — sitemap с корректной датой
lastmodи внутренние ссылки. Indexing API Google предназначен только для страниц с вакансиями и трансляциями, использовать его для статей нельзя.
Ключ
Ключ — строка от 8 до 128 символов из латинских букв, цифр и дефисов. Сгенерируйте его один раз:
node -e "console.log(crypto.randomUUID().replaceAll('-', ''))"Поисковик проверяет, что ключ принадлежит сайту, загружая файл с ключом. Самый простой вариант — файл public/<ключ>.txt, содержимое которого — тот же ключ. Он будет доступен по адресу https://example.com/<ключ>.txt.
Ключ не является секретом: он по определению лежит в публичном файле, поэтому хранить его в репозитории нормально. Подтверждение владения обеспечивает не тайна ключа, а то, что файл с ним может разместить только владелец домена.
Файл можно положить и в другое место, указав его в параметре keyLocation. Учтите ограничение протокола: расположение файла задаёт область действия ключа. Ключ из https://example.com/blog/<ключ>.txt подтверждает только адреса, начинающиеся с https://example.com/blog/. Чтобы покрыть весь сайт, файл должен лежать в корне.
Проверьте после деплоя:
curl -i https://example.com/$INDEXNOW_KEY.txt # HTTP/2 200, тело — ровно ключ, без редиректов
Отправка
// lib/indexnow.ts
const ENDPOINT = "https://api.indexnow.org/indexnow";
export async function submitToIndexNow(urls: string[]) {
if (urls.length === 0) return;
const host = new URL(urls[0]).host;
for (let i = 0; i < urls.length; i += 10_000) {
const batch = urls.slice(i, i + 10_000);
const res = await fetch(ENDPOINT, {
method: "POST",
headers: { "Content-Type": "application/json; charset=utf-8" },
body: JSON.stringify({
host,
key: process.env.INDEXNOW_KEY,
keyLocation: `https://${host}/${process.env.INDEXNOW_KEY}.txt`,
urlList: batch,
}),
});
if (res.status !== 200 && res.status !== 202) {
throw new Error(`IndexNow ${res.status}: ${await res.text()}`);
}
}
}Все URL в одном запросе должны принадлежать хосту из поля host. Вместо общего адреса api.indexnow.org можно отправлять напрямую в https://www.bing.com/indexnow или https://yandex.com/indexnow — результат распространяется между участниками в любом случае, поэтому отправлять в несколько точек одновременно не нужно.
Коды ответа
| Код | Значение | Что делать | |---|---|---| | 200 | Принято | Ничего | | 202 | Принято, ключ ещё проверяется | Ничего, проверка асинхронная | | 400 | Неверный формат | Проверить JSON и заголовок Content-Type | | 403 | Ключ не подтверждён | Открыть файл ключа в браузере, сверить содержимое | | 422 | URL не относятся к host или ключ не совпадает | Проверить домен, www и протокол | | 429 | Слишком много запросов | Реже отправлять, группировать URL |
Когда вызывать
Отправляйте уведомление в момент публикации или существенного изменения страницы, а не по расписанию для всего сайта:
// app/admin/actions.ts
"use server";
import { revalidatePath } from "next/cache";
import { after } from "next/server";
import { submitToIndexNow } from "@/lib/indexnow";
export async function publishPost(slug: string) {
await db.post.update({ where: { slug }, data: { status: "published", publishedAt: new Date() } });
revalidatePath(`/blog/${slug}`);
after(() => submitToIndexNow([`https://example.com/blog/${slug}`]).catch(console.error));
}after из next/server (стабилен с Next.js 15.1) выполняет отправку после ответа пользователю, поэтому сбой IndexNow не мешает публикации. Порядок важен: сначала страница должна стать доступной и отдавать 200, потом уведомление. Если поисковик придёт раньше, чем закончится ревалидация, он увидит старую версию.
Типовые ошибки
- Отправка всех URL сайта при каждом деплое. Протокол рассчитан на изменения; массовые повторные отправки неизменённых страниц не ускоряют индексацию и могут привести к ограничениям.
- Ключ в
public, но сайт отдаёт его с редиректом сexample.comнаwww.example.com, аhostуказан безwww. - Уведомление о странице с
noindexили с canonical на другой адрес — поисковик придёт и не проиндексирует. - Ожидание, что после IndexNow страница появится в Google.
Что сделать для Google параллельно
Убедитесь, что sitemap.xml перечисляет только канонические индексируемые адреса, а lastmod меняется только при реальном изменении содержимого, а не при каждой сборке. Отправьте sitemap в Search Console. Для новых важных страниц можно вручную запросить индексацию через проверку URL — это ручной инструмент, а не API для массового использования.
Когда IndexNow не даст эффекта
Если сайт публикует несколько статей в месяц и Bing с Яндексом и так обходят его регулярно, разница будет незаметна. Протокол полезнее для сайтов с частыми изменениями: новостей, каталогов с меняющимися ценами и наличием, форумов.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.