# Модуль: IndexNow

[← К оглавлению](../README.md)

Мгновенное уведомление Яндекса и Bing об изменившихся страницах. Обычный путь в
индекс — обход по `sitemap.xml`, а это дни и недели. IndexNow сообщает об
изменении сразу, в момент публикации.

Для доски это важно вдвойне: **страниц объявлений в `sitemap.xml` нет вообще**
(карта сайта намеренно отдаёт только разделы, города, статьи, страницы и
профили). До IndexNow поисковик узнавал об объявлении, только набредя на ссылку
в ленте, — теперь получает адрес напрямую.

## Как устроено

```
сохранение модели ──► index_now_urls ──► indexnow:flush (раз в 10 мин) ──► api.indexnow.org
     (хук)              (очередь)              (пачкой до 10 000)
```

Отправляем на общий эндпоинт `api.indexnow.org/indexnow`: по протоколу он
раздаёт адреса всем участникам, отдельные запросы в Яндекс и Bing не нужны.

**Почему через очередь, а не сразу запросом.** Импорт YML заводит объявления
сотнями, а протокол отвечает `429` на слишком частые обращения и принимает до
10 000 адресов за раз. Плюс уникальный индекс по `url` схлопывает повторы:
объявление, отредактированное трижды за десять минут, уйдёт одним адресом.

## Что попадает в очередь

| Событие | Откуда |
|---|---|
| Статья опубликована или изменена | `Article::booted()` |
| Статья снята с публикации или удалена | там же |
| Контентная страница опубликована/изменена/снята | `Page::booted()` |
| Объявление стало активным или изменилось | `Ad::booted()` |
| Объявление ушло из выдачи (архив, блокировка, удаление) | там же |
| Объявления завершены по сроку | `ads:archive-expired` |

Снятые страницы отправляем намеренно: они начинают отдавать 404, и краулеру это
знать так же полезно, как и о новой публикации.

**Чего в очереди нет.** Черновики и объявления на модерации — их страницы
не публичны, гнать краулера на 404 незачем. Разделы и города тоже не шлём:
они меняются постоянно, а нового содержания в них при этом не появляется.

Два момента, которые легко сломать при правках:

- **Хук висит на `saved`, а не на `updated`.** Счётчик просмотров идёт через
  `increment()`, который поднимает `updated`, но не `saved`. Повесить на
  `updated` — значит гнать объявление в очередь при каждом заходе на страницу.
- **`ads:archive-expired` сообщает об адресах сам.** Он обновляет статусы одним
  массовым `update()`, а тот идёт мимо моделей и мимо их событий. Это основной
  путь, которым объявления покидают выдачу, — адреса там собираются до
  обновления, вручную.

## Ключ и файл с ключом

Протокол требует выложить в корень сайта файл `<ключ>.txt`, содержащий сам ключ.
Отдаём его маршрутом `indexnow.key` (`routes/web.php`), а не статикой: тогда
ключ живёт в `.env` в одном экземпляре и не может разойтись с тем, что уходит в
запросе. Любое другое имя — обычные 404.

Ключ **не секрет**: он публичен по смыслу протокола. В `.env` он лежит потому,
что должен различаться по окружениям:

```dotenv
INDEXNOW_KEY=…   # 8–128 символов из [A-Za-z0-9-]
```

**Нет ключа — отправка выключена целиком**: очередь не наполняется, запросы не
уходят, файл не отдаётся. Так и работает локальная разработка, специального
тумблера для этого не нужно.

Сгенерировать новый: `php -r 'echo bin2hex(random_bytes(16));'`

## Команда

```bash
php artisan indexnow:flush              # отправить накопленное
php artisan indexnow:flush --limit=50   # частями, для отладки
```

В расписании — каждые 10 минут (`routes/console.php`). Для индексации такая
задержка роли не играет, зато адреса уходят пачками.

**Что делает с пачкой в зависимости от ответа:**

| Ответ | Решение | Почему |
|---|---|---|
| `200`, `202` | удалить из очереди | приняли (202 — ключ ещё проверяют) |
| `400`, `422` | удалить + `Log::error` | кривой запрос или чужой хост: повтор не поможет, а пачка встанет колом |
| `403`, `429`, `5xx`, нет ответа | оставить + `Log::warning` | ключ, лимит или сеть — лечится повтором |

## Хост адресов

`IndexNow::normalize()` приводит каждый адрес к хосту из `APP_URL`. Ссылки
рождаются внутри запроса, а `route()` берёт хост из него же: стоит зайти на сайт
по другому имени или по `http` — и в очередь попадёт адрес с чужим хостом, на
который протокол ответит `422` **и отбросит всю пачку**, а не одну строку.

## Проверка на проде

```bash
curl -s https://placeo.ru/$INDEXNOW_KEY.txt     # должен вернуть сам ключ
php artisan indexnow:flush -v                   # ручной прогон
```

Строки в очереди: `select count(*) from index_now_urls;` — если число растёт и
не убывает, смотрите лог: скорее всего `403` (файл с ключом не отдаётся) либо
расписание не работает (см. [deploy-hestia.md](deploy-hestia.md), ловушка с
`pcntl_signal`).

См. также: [blog.md](blog.md), [ads.md](ads.md), [deploy-hestia.md](deploy-hestia.md).
