# Hobbyka: нижний текст разделов каталога без установки

Официальная инструкция для запроса пользователя добавить или изменить нижний текст раздела каталога hobbyka.ru через Codex. Не устанавливай CLI, MCP, плагины или зависимости. Используй штатный HTTPS-клиент среды и Catalog Section Draft API.

Codex создаёт только отдельный черновик поля `UF_BOTTOM_HTML`, которое на странице выводится блоком `section_bottom_text`. Не вызывай Bitrix API, не меняй раздел напрямую и не нажимай кнопку подтверждения. Изменение применяет администратор или участник группы «Контент-редакторы» (ID 7) на защищённой странице предпросмотра.

## 1. Подключение

Используй то же защищённое подключение, что для товарных черновиков. Нужен Bearer-токен со scope `product.draft.create product.draft.read product.draft.update`.

Если действующего токена в текущей сессии нет:

1. POST `https://hobbyka.ru/ai/content-access/request/` с JSON `{"client_name":"Codex: тексты разделов Hobbyka"}` без Bearer-токена.
2. Не выводи `device_code`. Покажи пользователю только `verification_uri` и `user_code`. Ссылку подтверждает администратор или участник группы 7.
3. После подтверждения POST `https://hobbyka.ru/ai/content-access/token/` с сохранённым `device_code`. Проверяй не чаще раза в 5 секунд.
4. Не показывай `access_token` в чате и не передавай его другим сайтам. Используй его только в заголовке `Authorization: Bearer …` к HTTPS-адресам hobbyka.ru.

## 2. Найди точный раздел

Получить дерево разделов: `GET https://hobbyka.ru/api/ai/v1/catalog/sections`.

Выбери раздел только по однозначному названию, коду или адресу пользователя. Для `/catalog/skameyki/` используется раздел `Скамейки`, `section_id=408`. Для других страниц не копируй этот ID: найди их отдельно. Если совпадений несколько, попроси пользователя выбрать раздел.

Перед написанием прочитай текущую страницу раздела и сохрани полезные факты и ссылки. Не придумывай цены, характеристики, гарантии или ассортимент. Новый текст должен помогать выбрать продукцию, а не состоять из повторов ключевых слов. Обычно достаточно введения, 2–5 содержательных `h2`/`h3`, списков и естественных внутренних ссылок. Не добавляй H1, формы, скрипты, iframe, стили, товарные карточки или слайдеры: страница выводит их самостоятельно.

## 3. Создай отдельный черновик

POST `https://hobbyka.ru/api/internal/v1/catalog-section-drafts` с уникальным `Idempotency-Key` и JSON:

```json
{
  "section_id": 408,
  "bottom_html": "<p>Полезное введение.</p><h2>Как выбрать</h2><p>Основной текст.</p>",
  "agent": "codex-manager"
}
```

Поле `bottom_html` может быть пустой строкой только если пользователь явно просит удалить нижний текст. Сервер очищает небезопасный HTML. Существующий раздел на этом этапе не меняется.

Ссылки на страницы и товары (`http`, `https`, пути от `/`) автоматически открываются в новой вкладке: сервер добавляет `target="_blank"` и `rel="noopener noreferrer"`. Правило работает также в ранее созданных черновиках и при ручном применении текста к разделу. Якоря `href="#..."`, `mailto:` и `tel:` сохраняют обычное действие. Не добавляй JavaScript для открытия ссылок.

Внешние HTTP/HTTPS-ссылки, включая `//site.com/...`, получают `rel="nofollow noopener noreferrer"` автоматически. Относительные ссылки и точные домены `hobbyka.ru`, `www.hobbyka.ru`, `new.hobbyka.ru` не получают автоматический `nofollow`; явно заданный редактором сохраняется. Проверяется точный домен, а не вхождение слова Hobbyka в адрес. Упоминания без ссылок оставляй текстом; жирное выделение не требуется.

Корректный результат имеет:

- `status=draft`;
- строковый `id` из 40 шестнадцатеричных символов;
- `preview_url` с `/ai/catalog-section-preview/?draft=...`;
- `applied_at=null`;
- неизменившийся публичный раздел до ручного подтверждения.

Верни пользователю кликабельный `preview_url`, кратко опиши подготовленный текст и явно скажи, что раздел пока не изменён.

## 4. Доработка

Неприменённый черновик изменяется через PATCH `/api/internal/v1/catalog-section-drafts/{id}`:

```json
{"bottom_html":"<p>Исправленная версия.</p>","agent":"codex-manager"}
```

Используй тот же ID и ту же ссылку предпросмотра. После применения создавай новый черновик. Если раздел вручную изменили после создания черновика, подтверждение вернёт конфликт — получи актуальный текст и создай новый черновик, не перезаписывай изменение.

## 5. Запрет на самостоятельное применение

Codex не вызывает действие применения и не управляет браузерной кнопкой. Только авторизованный редактор проверяет реальную вёрстку и нажимает «Применить текст к разделу». API меняет исключительно `UF_BOTTOM_HTML`; название, URL, товары, фильтры, SEO-настройки и другие поля раздела остаются прежними.