# Hobbyka: нижний текст теговых страниц без установки

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

Codex создаёт только отдельный черновик поля `DETAIL_TEXT` элемента инфоблока тегов №22, которое на странице выводится блоком `tag_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. Определи точную теговую страницу

Используй полный URL пользователя или точный код после `/tags/`. Например, для `https://hobbyka.ru/tags/skameyki_vokrug_dereva/` код равен `skameyki_vokrug_dereva`. API сам проверит, что такой активный или неактивный элемент существует в инфоблоке тегов №22. Не подставляй адрес раздела `/catalog/` и не угадывай похожий тег по названию.

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

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

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

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

В `tag` допустим полный URL, код или числовой ID. Поле `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 шестнадцатеричных символов;
- правильные `tag_id`, `tag_code`, `tag_name` и `tag_url`;
- `preview_url` с `/ai/tag-page-preview/?draft=...`;
- `applied_at=null`;
- неизменившуюся публичную теговую страницу до ручного подтверждения.

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

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

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

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

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

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

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