Умные SEO описания: настройка и генерация

Версия и границы проверки

Руководство сверено 5 октября 2026 года с исходниками globalit.autoseodesc 0.0.2. Скриншоты иллюстрируют ранее подготовленный сценарий; установленный сайт, выдача доступов и внешняя генерация в рамках этой сверки не проверялись.

Возможности модуля Умные SEO описания.

Глобал АйТи. Умные SEO описания — решение для 1С-Битрикс, которое помогает создавать SEO-описания разделов каталога с учетом ассортимента, региона, старого текста и дополнительных требований к стилю.

В административной части 1С-Битрикс решение отображается под названием Глобал АйТи. Умные SEO описания. ID модуля — globalit.autoseodesc.

Модуль решает несколько задач:

ускоряет подготовку описаний для разделов каталога;
передает сервису контекст раздела и пожелания к тексту;
автоматически записывает полученный HTML в описание раздела;
хранит историю запросов и статус обработки;
показывает баланс, резерв и расход токенов.

Решение подходит интернет-магазинам, маркетологам, SEO-специалистам и контент-менеджерам, которые регулярно работают с большим количеством разделов каталога и хотят быстрее готовить тексты в едином стиле.

Как работает решение

Получите Client ID и API-ключ у поставщика AI-сервиса и укажите их в настройках модуля.
Выберите инфоблок и раздел в административной странице модуля.
Проверьте контекст, выберите регион и при необходимости заполните дополнительные требования.
Модуль отправит запрос во внешний AI-сервис и сохранит его в локальной очереди.
Открытая страница и фоновый агент проверяют состояние запроса.
После успешной обработки полученный HTML автоматически заменяет описание раздела.

Генерация выполняется асинхронно: результат приходит позже отправки запроса.

Описание заменяется автоматически

Успешная обработка записывает результат в DESCRIPTION раздела с типом html. Отдельного утверждения перед записью нет. Заранее сохраните исходное описание и сначала проверьте генерацию на копии сайта. Если сайт выводит это поле, новый текст может сразу появиться на публичной странице. Не редактируйте описание, пока запрос обрабатывается: результат заменит текущее содержимое без проверки конфликтов.

Требования

PHP 8.1 или новее; для обработки длины текста используется расширение mbstring.
Главный модуль 1С-Битрикс main не ниже 14.00.00 — это порог, проверяемый установщиком. Совместимость конкретной версии ядра проверьте на копии сайта.
Установленный модуль iblock и инфоблок с разделами.
Доступ к настройкам модуля; право модуля R для просмотра и W для генерации, сохранения описания и отмены запросов.
Соединение сервера сайта с https://aiwordstat.gl-it.ru и действующие данные подключения.
Работа агентов 1С-Битрикс. Установщик регистрирует агент обработки очереди с интервалом 60 секунд; фактическое расписание зависит от настройки агентов на сайте.

Что получает клиент после покупки

Для работы требуются Client ID и API-ключ внешнего сервиса. Порядок их выдачи и условия предоставления токенов уточните у поставщика: сам модуль не создает учетную запись сервиса и не выпускает ключи.

Если данных подключения нет, обратитесь на info@gl-it.ru и укажите номер заказа.

Настройка модуля

Откройте административную часть сайта 1С-Битрикс.

Перейдите в настройки модуля:

Настройки → Настройки модулей → Глобал АйТи. Умные SEO описания

Рисунок 1 - Переход в настройки модуля

Укажите обязательные данные подключения:

Адрес API — https://aiwordstat.gl-it.ru. В версии 0.0.2 разрешен только этот HTTPS-адрес, без дополнительного пути, параметров и якоря; подключение к произвольному API не поддерживается;
Client ID — идентификатор клиента, предоставленный поставщиком сервиса;
API-ключ — ключ доступа к сервису.

Рисунок 2 - Форма настроек подключения

Сохраните настройки.

Если одно из полей не заполнено, модуль покажет предупреждение и подскажет, какие параметры нужно указать.

Не размещайте API-ключ в текстах разделов и дополнительных требованиях. Храните его в предназначенном для этого поле настроек.

Проверка подключения

После ввода данных подключения модуль проверяет связь с AI-сервисом через запрос баланса.

Возможные состояния:

Подключение настроено — поля заполнены корректно, AI-сервис отвечает, баланс доступен;
Настройки подключения заполнены не полностью — не заполнен Адрес API, Client ID или API-ключ;
Не удалось подтвердить подключение — поля заполнены, но AI-сервис не подтвердил доступ.

При ошибке проверьте, что Client ID и API-ключ скопированы полностью, без лишних пробелов и переносов строк, а сервер может обратиться к разрешенному API. Проверка подключения использует данные баланса; ее результат кэшируется на 60 секунд.

Рисунок 3 - Проверка подключения

Генерация SEO-описания

Откройте раздел модуля Сервисы → Умные SEO описания → SEO настройки. Выберите инфоблок, перейдите к нужному разделу каталога и откройте редактирование раздела через строку списка или контекстное меню.

На форме отображаются ID и название выбранного раздела. Название категории, путь раздела, названия активных подразделов и активных товаров модуль собирает самостоятельно; товары включаются и из вложенных разделов.

Заполните или проверьте:

Текущее описание раздела (будет использовано как контекст для генерации) — текст для контекста. Если оставить поле пустым, модуль возьмет сохраненное описание раздела. Очистка поля не исключает существующее описание из запроса;
Регион — значение из предложенного списка или Без региона;
Дополнительные требования (до 1000 символов) — необязательное пожелание к результату. Отдельных полей для ручного списка товаров или брендов нет; нужные акценты можно описать здесь.

Нажмите Сгенерировать описание. Для одного раздела нельзя отправить еще один запрос, пока предыдущий имеет статус обработки. Изменение текста контекста перед генерацией само по себе не сохраняет его в разделе. Для ручного сохранения описания используются Сохранить или Применить.

Дополнительные требования можно использовать как пользовательское задание к генерации. Это поле необязательное: если оставить его пустым, модуль не будет отправлять дополнительный prompt в AI-сервис. Например:

Обычный текст

Сделай текст экспертным, спокойным и без агрессивных продаж. Не используй слово "лучший".

Ограничение для дополнительных требований — до 1000 символов. Модуль обрезает пробелы по краям, а пустое значение не отправляет. Контекст текущего описания перед отправкой ограничивается 20 000 символами.

Рисунок 4 - Форма генерации SEO-описания

Что учитывается при генерации

Модуль передает сервису:

название категории и путь от инфоблока до раздела;
выбранный регион, если он указан;
названия активных подразделов;
названия активных элементов выбранного раздела и его подразделов;
текущее описание как контекст;
дополнительные требования, если они заполнены.

Отдельная выгрузка свойств товаров, цен и брендов в запросе не предусмотрена. Как внешний сервис собирает поисковые данные и какую модель использует, определяется самим сервисом; клиентский модуль не подтверждает использование Wordstat или Yandex ML.

Полученный текст проходит обработку допустимого HTML, затем записывается в описание раздела и в историю запроса. Фактический вывод на странице зависит от шаблона сайта.

Рисунок 5 - Успешная генерация

Рисунок 6 - Готовое описание раздела

Статусы обработки

В интерфейсе модуля используются следующие пользовательские статусы обработки:

Запрос обрабатывается — запрос создан и ожидает обработки или уже обрабатывается AI-сервисом;
Запрос выполнен — результат получен, сохранен в истории и записан в описание раздела;
Запрос отменен — пользователь отменил незавершенный запрос;
Ошибка генерации — запрос завершился неуспешно, причина отображается на странице и в истории.

После отправки формы модуль показывает уведомление Запрос на генерацию добавлен в очередь. Это подтверждение отправки, а не отдельный статус обработки.

Модуль сразу проверяет состояние нового запроса. Пока генерация выполняется, открытая страница автоматически повторяет проверку примерно раз в минуту. Дополнительно незавершенные запросы проверяет фоновый агент с заданным интервалом 60 секунд; фактическое время запуска зависит от настроек сайта. После успешного завершения статус на странице обновляется, сгенерированный текст появляется во вкладке История и записывается в описание раздела.

Отмена переводит незавершенный запрос в локальный статус Запрос отменен: модуль перестает обрабатывать его результат. Обращения к API для отмены внешней генерации здесь нет, поэтому эта операция не гарантирует остановку работы сервиса или возврат токенов.

Рисунок 7 - Статус обработки запроса

Баланс токенов

Баланс ведется внешним AI-сервисом. Модуль запрашивает его и показывает возвращенные значения; самостоятельно не начисляет токены и не определяет правила резервирования, списания или возврата.

В интерфейсе модуля могут отображаться:

текущий баланс;
доступный баланс;
зарезервированные токены;
задолженность, если она возникла;
история операций.

Рисунок 8 - Баланс токенов

История операций

История операций помогает понять, как менялся баланс.

В ней могут быть операции:

Пополнение;
Резервирование;
Разблокировка;
Списание.

Эти записи приходят из API, а не создаются модулем по событию покупки. Страница Сервисы → Умные SEO описания → Баланс токенов запрашивает до 50 операций. Баланс и список кэшируются на 60 секунд; ссылка Обновить баланс позволяет запросить актуальные данные.

Это удобно для контроля расходов и разбора спорных ситуаций.

Рисунок 9 - История операций по токенам

Ограничения

Модуль не заменяет SEO-стратегию и редакторскую проверку.
Результат автоматически сохраняется в разделе. Для проверки до публичного размещения запускайте генерацию на копии сайта или на разделе, который сайт не публикует.
Качество результата зависит от входных данных.
Дополнительные требования ограничены 1000 символами.
При недоступности внешних сервисов генерация может временно завершиться ошибкой.

Частые вопросы

Можно ли использовать модуль без старого описания?

Да, если сохраненное описание раздела пусто. Пустое поле формы при наличии сохраненного текста не исключает этот текст: модуль использует его как контекст. В запрос также передаются данные категории, товаров и выбранного региона.

Зачем нужны дополнительные требования?

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

Что делать, если генерация завершилась ошибкой?

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

Проверьте сообщение на странице генерации и повторите запрос позже, если ошибка временная. Если проблема сохраняется, обратитесь в поддержку и передайте идентификатор запроса или номер заказа.

Списываются ли токены при ошибке?

Правила списания и освобождения резерва определяет внешний сервис. Модуль отображает баланс и операции из API; статус ошибки или локальная отмена сами по себе не подтверждают возврат токенов.

Можно ли получить новый API-ключ?

Уточните порядок замены ключа у поставщика сервиса. В самом модуле функций выпуска и отзыва ключей нет; полученный новый ключ указывается в настройках.

Результат внедрения

После настройки модуль позволяет быстро создавать SEO-описания для разделов каталога, просматривать баланс сервиса и автоматически записывать готовое HTML-описание в раздел. Это снижает ручную нагрузку на контент-команду и помогает поддерживать описания категорий в едином стиле.

Описание раздела на странице фильтра

Если описание подготовлено для подборки умного фильтра или поиска, следующий шаг — привязать существующую страницу к SEO-разделу. Генерация текста сама по себе не настраивает эту привязку. В руководстве SimpleSFS также описана проверка вывода описания через шаблон сайта.