Specus
bergott-api-seo.md
Bergott: API, SEO и данные для агентов
Скачать .mdСкачать папку .zip

Bergott: API, SEO и данные для агентов

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

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

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 и BreadcrumbList в JSON-LD. Историческая цена не публикуется как действующий Offer; текущие остатки из активности карточки не выводятся;
  • видимые SKU, снимок цены, характеристики, источник покупки, ссылку на отзывы Ozon и дату проверки данных;
  • внутренние ссылки на связанные товары.

Цена, рейтинг и количество отзывов являются снимком данных. Наличие, доставка и условия покупки проверяются на 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, доставка, возвраты, остатки или юридическое лицо продавца. Существующие Google/Yandex фиды используют розничные снимки и выводят наличие из активности карточки. Это не проверка остатков. До подключения или повторной передачи в товарные программы им нужен источник актуальных коммерческих данных. Актуальные условия розничной покупки определяет Ozon.

Публичный слой для агентов / подготовлено 28 октября 2026

Изменения ниже проверены локально и пока не опубликованы. Передача исходников на сервер остановлена автоматической проверкой разрешений; действующий сайт сохраняет предыдущую версию.

  • /ai.txt — необязательный указатель на публичные источники. Не меняет robots.txt и права на обучение.
  • /ai.json — описание Specus, стадии проектов, контакты и машинные точки входа.
  • /mcp — публичный MCP Streamable HTTP на официальном SDK. Четыре действия только для чтения: get_project_overview, search_bergott_products, get_bergott_product, get_bergott_wholesale_offer. Подключение клиентом явное; публикация MCP не означает появления в поиске ChatGPT.
  • /{ru|en}/projects/bergott/wholesale/offer.json — ассортимент, характеристики, процесс, FAQ и шаблон обращения из того же источника, что HTML. Страница объявляет JSON через rel=alternate.
  • JSON каталога версии 2.1 и JSON товаров сохраняют прежние поля и добавляют происхождение API/резервного снимка и объяснения коммерческих данных. Отдельный agentRecord товара обозначает остатки как неизвестные.
  • sourceCheckedAt означает наблюдение источника, updatedAt — изменение записи. Ни запрос API, ни обновление кэша не подтверждают заново цены и остатки. Валидный пустой ответ API не заменяется старыми товарами из резервной копии.
  • JSON и MCP не принимают заказы, платежи и не отправляют сообщения. Приватные документы не подключены.

Проверка: production build, ESLint измененных файлов, node scripts/check-bergott-provenance.cjs, затем node scripts/check-public-agent-data.mjs http://127.0.0.1:3022 против запущенной сборки. Общий стандарт и матрица соответствия: docs/operations/llm-visibility-standard.md в корне Specus.

Оптовая страница / 28 октября 2026

  • RU: https://specus.space/ru/projects/bergott/wholesale.
  • EN: https://specus.space/en/projects/bergott/wholesale.
  • Отдельная CollectionPage, ItemList и BreadcrumbList; взаимные canonical/hreflang и записи sitemap.
  • Контакт — существующая публичная почта Specus, обычная mailto-ссылка с редактируемым шаблоном; автоматической отправки и новой формы нет.
  • AggregateRating из Ozon удален из товарной SEO-разметки. Видимые старые оценки заменены переходом к точной карточке Ozon. В JSON-снимках остаются исторические поля с датой источника; они не означают свежую проверку Ozon.
  • Коммерческие условия согласуются индивидуально. Цены, MOQ, сроки, наличие, доставка и продавец оптового направления из розничных снимков не выводятся.