Prom AI Boost — генерация описаний товаров Prom.ua через OpenAI

Prom AI Boost

CLI-инструмент для автоматической генерации контента карточек товаров Prom.ua с использованием OpenAI API.

Основные возможности

* Импорт товаров из Excel (.xlsx)
* Проверка дублей по SKU
* Генерация описаний на украинском и русском языках
* Генерация HTML-описаний для Prom.ua
* Генерация SEO-тегов
* Поддержка OpenAI GPT-4o-mini
* Строгий JSON-ответ от OpenAI
* Логирование обработки
* Статистика выполнения
* Версионирование выходных файлов
* Экспорт ошибок в отдельный Excel-файл
* Подсчёт использованных токенов OpenAI
* Расчёт примерной стоимости обработки каждой карточки товара
* Подготовленная архитектура для интеграции:

* Google Search API
* Serper API
* Tavily API
* Prom API

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

Excel → Source Facts (JSON) → OpenAI → JSON Response → HTML Formatter → Output.xlsx

## Дополнительные возможности

* Source Facts Layer (антигаллюцинационная архитектура)
* Контроль дублей товаров
* Export Errors Report
* OpenAI Cost Tracking
* Processing Statistics
* Logging System

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

* processed
* duplicate
* skipped
* error
* no_data

Технологии

* Python 3.10
* OpenAI API
* Pandas
* OpenPyXL
* Python Dotenv

Пример результатов

Для каждой карточки автоматически сохраняются:

* description_ua
* description_ru
* html_description
* seo_tags
* source_facts
* tokens_used
* estimated_cost_usd
* processed_at

Архитектура

Excel → Source Facts (JSON) → OpenAI → JSON Response → HTML Formatter → Output.xlsx

Технологии

Python 3.10, OpenAI API, Pandas, OpenPyXL, Python Dotenv