Модуль генерирует SEO-метаданные и описания для товаров, категорий и страниц с помощью Claude AI. Работает в одно нажатие прямо на странице редактирования или автоматически через CRON.
Если у вас сотни или тысячи товаров без описаний и SEO-полей — этот модуль делает всю работу за вас. Никакого копирайтера, никакого ручного заполнения.
Как работает модуль
Модуль встраивается в страницы редактирования товаров, категорий и страниц CS-Cart — добавляет отдельную вкладку с кнопками генерации. Вы выбираете что генерировать (SEO или описание), при необходимости редактируете промпт, и нажимаете кнопку. Claude AI возвращает готовый результат, который сразу сохраняется в нужные поля.
Для каждого типа объекта (товар, категория, страница, блог) — отдельные промпты. Промпты можно редактировать прямо в интерфейсе.
В Общих настройках модуля можно генерировать блоги. Ставите на cron и генерируете контент для своего сайта ежедневно!
1. Основные настройки
Модули → IP5 Agency — AI Content Generator → Открыть
Рис. 1 — Основные настройки AI Content Generator
| Настройка | Описание |
|---|---|
| API Key (Claude) | Ваш секретный ключ Claude API. Получить: platform.claude.com/settings/keys |
| API Base URL | Endpoint Claude API. Не изменяйте без необходимости |
| AI Model | claude-sonnet-4-5 — оптимальный, claude-opus-4-5 — максимальное качество, claude-haiku-4-5 — быстро и дёшево |
| CRON Key | Ключ для запуска автоматической генерации через CRON. От 10 до 20 символов, латиница и цифры |
| Default topic | Тема магазина для подстановки в промпт через переменную {topic} при CRON-запуске |
| Maximum response tokens | Максимальная длина ответа AI. Рекомендуется 1000–2000. Больше значение — дороже запрос |
| API Request Timeout | Максимальное время ожидания ответа от AI в секундах. Рекомендуется 60 |
| Generated Page Status | Hidden — скрыта (проверить перед публикацией), Active — сразу опубликована |
Рис. 2 — Выбор промпта из библиотеки перед запуском генерации
Счётчик токенов показывает использование за текущий период. Input — токены отправленных промптов, Output — токены полученных ответов. Следите за лимитами вашего тарифа на platform.claude.com.
2. Библиотека промптов
IP5 Agency — AI Content Generator → Prompt Library
Рис. 3 — Библиотека промптов с активными шаблонами
Библиотека промптов — коллекция готовых шаблонов которые можно выбирать при генерации. Вместо одного фиксированного промпта у вас может быть несколько: для разных тонов, задач или типов контента.
- Нажмите Add Prompt чтобы создать новый шаблон
- Задайте Name — отображаемое название в выпадающем списке
- Заполните Prompt Template — текст промпта. Используйте переменную {topic} как плейсхолдер для темы магазина
- Установите Position — порядок в списке
- Активируйте Status чтобы промпт был доступен при генерации
Рис. 4 — Редактирование промпта с переменной {topic}
При генерации {topic} заменяется на значение поля «Default topic» из настроек модуля.
3. Генерация для товара
Каталог → Товары → Открыть товар → IP5 Agency — AI Content Generator
Рис. 5 — Вкладка AI Content Generator на странице товара
На странице редактирования каждого товара появляется новая вкладка модуля с двумя независимыми блоками генерации.
Блок SEO — генерирует сразу четыре поля:
- SEO name — slug страницы (URL-часть), латиница через дефис до 60 символов
- Page title — заголовок вкладки браузера до 60 символов
- Meta description — мета-описание до 160 символов
- Meta keywords — ключевые слова через запятую, 5–7 слов
Блок Description — генерирует полное описание товара в формате HTML, готового для вставки в редактор CS-Cart.
Промпты в блоках можно редактировать прямо на странице товара. Кнопка Reset to default возвращает стандартный промпт из настроек модуля.
Фотография товара в промпте
При генерации описания товара модуль автоматически включает главное фото товара в запрос к Claude AI. Изображение передаётся в формате base64 вместе с текстом промпта — Claude видит фотографию и использует её для генерации более точного и релевантного описания.
Если у товара есть фото, описание генерируется на основе реального визуального содержания — Claude видит цвет, форму, детали и особенности товара. Галлюцинации и выдуманные характеристики исключены.
На вкладке модуля в блоке «Данные товара» отображается миниатюра фото и статус ✅ участвует — это значит что изображение будет передано в запрос. Если фото у товара нет — блок с изображением не отображается, генерация идёт только по тексту.
Фото передаётся только при генерации описания. При генерации SEO-полей изображение не используется — для SEO достаточно названия и характеристик.
В промпте можно указать плейсхолдер {image} — тогда изображение будет вставлено точно в это место. Если плейсхолдер не указан, фото автоматически добавляется перед текстом промпта.
Данные товара в промпте
Кроме фото, в запрос к AI автоматически передаются:
- Название товара
- Описание (существующее, если есть — AI улучшает его, а не копирует)
- Характеристики из таблицы features CS-Cart — до 20 параметров (название характеристики и её значение)
Чем полнее заполнены характеристики товара, тем точнее и содержательнее будет сгенерированное описание.
4. Генерация для категории
Каталог → Категории → Открыть категорию → IP5 Agency — AI Content Generator
Рис. 6 — Вкладка AI Content Generator на странице категории
Аналогично товарам, на странице категории появляется вкладка с теми же двумя блоками — SEO и Description. Промпты автоматически подстраиваются под тип объекта. Блок с фотографией не отображается — для категорий передаётся только название и описание.
5. Генерация для страниц и блога
Веб-сайт → Страницы → Открыть страницу → IP5 Agency — AI Content Generator
Рис. 7 — Вкладка AI Content Generator на странице блога
Модуль работает также для статических страниц и записей блога. Для блога доступна генерация полного текста статьи — это особенно полезно для быстрого наполнения контентного раздела. Фото в промпт для страниц и блога не передаётся.
6. Автоматическая генерация через CRON
Рис. 8 — Запуск генерации и CRON-команда
CRON-режим позволяет генерировать контент для всего каталога автоматически без участия человека — модуль сам обходит товары, категории и страницы и заполняет пустые поля.
Команда для запуска по расписанию находится в верхней части главной страницы модуля:
0 3 * * * curl -s "https://yoursite.com/admin.php?dispatch=ip5_ai_generator.cron&cron_key=YOUR_KEY" > /dev/null 2>&1
- Модуль обрабатывает объекты у которых поля SEO или описание ещё не заполнены
- Уже заполненные поля не перезаписываются
- Страницы созданные через CRON получают статус из настройки Generated Page Status
- Кнопка Run Generation запускает CRON вручную — удобно для первого теста
Для первого запуска рекомендуем установить Generated Page Status = Hidden — так вы сможете проверить качество сгенерированного контента перед публикацией.
7. Защита от прямого записывания
После генерации SEO и описания пользователю дают право выбора, применить либо отменить изменения:
8. Мониторинг использования токенов
На главной странице модуля и на каждой вкладке товара/категории отображается счётчик токенов. Input — токены отправленных промптов, Output — токены полученных ответов. Обновляется автоматически.
Стоимость одного запроса зависит от выбранной модели и длины промпта + ответа. Для оптимизации расходов используйте claude-haiku-4-5 для массовой генерации простых описаний и claude-sonnet-4-5 для качественных текстов.
Передача фото товара увеличивает количество input-токенов на запрос — изображение кодируется в base64 и добавляется к промпту. Если нужно минимизировать расход токенов — используйте claude-haiku-4-5.
9. Журнал логов
Рис. 9 — Результаты генерации блогов, ошибки и успешные генерации
10. Совместимость с OpenRouter и другими провайдерами
Модуль поддерживает не только прямое подключение к Claude — через поле API Base URL можно подключить любой совместимый провайдер. Протестированный вариант — OpenRouter, который даёт доступ к десяткам моделей через один ключ: DeepSeek, Gemini, Llama, Mistral и другие.
Настройки для подключения OpenRouter:
| Поле | Значение |
|---|---|
| API Base URL | https://openrouter.ai/api/v1/messages |
| API Key | Ваш ключ от OpenRouter — получить на openrouter.ai/settings/keys |
| AI Model | Любая модель из каталога OpenRouter, например:anthropic/claude-sonnet-4-5deepseek/deepseek-chatgoogle/gemini-pro |
| Maximum response tokens | Рекомендуется 1000–1500 при использовании OpenRouter |
Важно: при использовании OpenRouter уменьшите Maximum response tokens до 1000–1500. Если на балансе аккаунта недостаточно кредитов для запрошенного количества токенов — OpenRouter вернёт ошибку 402. Пополнить баланс можно на openrouter.ai/settings/credits.
Передача фото через OpenRouter: изображения поддерживаются только если выбранная модель поддерживает vision (например, anthropic/claude-sonnet-4-5, google/gemini-pro-vision). Текстовые модели (DeepSeek, Llama) проигнорируют фото и сгенерируют описание только по тексту.
Через OpenRouter удобно сравнивать качество генерации разных моделей на своём каталоге и выбирать оптимальное соотношение цены и качества для конкретной задачи.