Источник данных

Основной источник каталога:

https://api.specus.space/api/bergott/products/

Фронт запрашивает активные товары через lib/bergott.ts и обновляет кэш раз в час. Если API недоступен во время сборки или повторной проверки кэша, используется public/data/bergott-products.json.

Переменная окружения:

SPECUS_API_URL=https://api.specus.space

Публичные маршруты

каталог: https://specus.space/ru/projects/bergott;
товар: https://specus.space/ru/projects/bergott/{slug};
каталог JSON: https://specus.space/ru/projects/bergott/catalog.json;
товар JSON: https://specus.space/ru/projects/bergott/{slug}/product.json;
Yandex YML: https://specus.space/feeds/bergott-yandex.yml;
Google Merchant RSS: https://specus.space/feeds/bergott-google.xml;
OpenAPI 3.1: https://api.specus.space/api/bergott/schema/?format=json;
документация API: https://api.specus.space/api/bergott/docs/;
краткая карта для агентов: https://specus.space/llms.txt;
полная карта для агентов: https://specus.space/llms-full.txt;
sitemap: https://specus.space/sitemap.xml.

JSON-маршруты доступны для чтения и получают X-Robots-Tag: noindex, follow, чтобы поисковая выдача вела на HTML-страницы.

SEO карточки

Каждая карточка формирует:

уникальные title и description;
canonical URL;
альтернативное представление application/json;
Open Graph и Twitter metadata;
Product, Offer, AggregateRating и BreadcrumbList в JSON-LD;
видимые SKU, цену, рейтинг, характеристики, источник покупки и дату проверки данных;
внутренние ссылки на связанные товары.

Цена, рейтинг и количество отзывов являются снимком данных. Наличие, доставка и условия покупки проверяются на Ozon по точной ссылке из записи товара.

Изображения

Рекомендуемый путь:

public/img/projects/bergott/{sku}.webp

Для фидов, которые принимают только JPEG или PNG, рядом хранится версия:

public/img/projects/bergott/{sku}.jpg

После загрузки файла нужно записать в поле image_path соответствующего товара:

/img/projects/bergott/{sku}.webp

Фронт автоматически добавит изображение в Open Graph, Twitter metadata и Product.image после обновления часового кэша. До появления файла поле image_path должно оставаться пустым.

Индексация

В sitemap включены русская страница коллекции и все активные товары. lastmod берется из API. После заметного обновления каталога sitemap следует повторно отправить в Google Search Console и другие используемые панели вебмастеров.

Yandex YML передается в Яндекс Вебмастере как товарный фид. IndexNow сообщает Яндексу и другим участникам протокола об измененных HTML-страницах и машинных маршрутах, но не заменяет добавление сайта, sitemap и фида в кабинетах платформ.

Границы данных

В разметку и фиды не добавляются неподтвержденные GTIN, условия доставки, сроки возврата, остатки или юридическое лицо продавца. Наличие в текущих фидах означает, что карточка активна в каталоге и на момент проверки имела действующую ссылку Ozon. Актуальные условия покупки определяет Ozon.