ШІ для продавців Rozetka

Модуль 0 — Підготовка робочого місця

0.1 Що ми побудуємо

За цей курс ти крок за кроком збереш трьох AI-помічників для свого магазину на Rozetka:

• Генератор карток — пише продаючі заголовки, описи й характеристики під правила Rozetka за хвилини, а не години.
• Чат-відповідач — ввічливо відповідає покупцям у чатах Rozetka українською, навіть коли ти спиш.
• Агент магазину — надсилає тобі нові замовлення в Telegram і синхронізує залишки, щоб не продати того, чого немає.

Усе це працює на Claude Code — інструменті, який пише код замість тебе. Програмістом бути не треба: ти описуєш завдання звичайними словами, а Claude робить.

0.2 Створюємо акаунт Claude

1. Відкрий сайт Claude

   Перейди на claude.ai та натисни Sign up.

2. Зареєструйся через Google або пошту

   Найшвидше — кнопка Continue with Google. Або введи email і підтверди код із листа.

3. Підтверди акаунт

   Введи імʼя, підтверди, що тобі є 18, — готово. Це твій безкоштовний акаунт Claude.

0.3 Встановлюємо Claude Code

Claude Code працює в «терміналі». Спершу поставимо те, без чого він не запуститься — програму Node.js, а потім сам Claude Code.

Крок А. Встановлюємо Node.js

1. Завантаж Node.js

   Відкрий nodejs.org і натисни велику зелену кнопку LTS (рекомендована версія). Завантажиться файл-інсталятор.

2. Встанови

   Запусти завантажений файл. І на Windows, і на Mac це звичайний інсталятор: тисни Продовжити → Прийняти умови → Встановити → Готово (нічого не змінюй). На Mac може спитати пароль від компʼютера — це нормально.

3. Перевір, що встановилось

   Відкрий термінал (на Windows — застосунок «PowerShell», на Mac — «Terminal» через пошук Spotlight). Введи команду й натисни Enter:

   node -v

   Якщо зʼявилось щось на кшталт v22.3.0 — Node.js встановлено. ✅

Крок Б. Встановлюємо Claude Code

1. Введи команду встановлення

   У тому ж терміналі встав і натисни Enter:

   npm install -g @anthropic-ai/claude-code

   Зачекай 1–2 хвилини, поки все завантажиться. Побіжать рядки — це нормально.

2. Запусти Claude Code

   Введи коротку команду:

   claude

   Першого разу він попросить увійти — відкриється браузер, авторизуйся акаунтом claude.ai (тим самим із уроку 0.2).

3. Перевір, що працює

   Коли побачиш привітання Claude Code в терміналі — напиши йому: Привіт! Ти готовий допомагати з моїм магазином? Якщо відповів — усе працює. 🎉

0.4 Термінал за 10 хвилин

Термінал — це просто спосіб давати компʼютеру команди текстом. Тобі знадобиться лише кілька:

• cd назва_папки — зайти в папку
• cd .. — піднятись на папку вище
• ls (Mac) або dir (Windows) — показати, що в папці
• claude — запустити нашого помічника в цій папці

1. Створи робочу папку для магазину

   Зробимо окрему папку, де житимуть усі файли помічника. Введи по черзі:

   # створюємо папку на робочому столі
   cd Desktop
   mkdir rozetka-pomichnyk
   cd rozetka-pomichnyk

   Тепер ти «всередині» папки rozetka-pomichnyk.

2. Запусти тут Claude Code

   Просто введи claude — і помічник працюватиме саме в цій папці.

0.5 Отримуємо API-токен Rozetka

API-токен — це таємний ключ, що дозволяє помічнику безпечно працювати з твоїм магазином через офіційний кабінет продавця Rozetka.

1. Зайди в кабінет продавця Rozetka

   Відкрий seller.rozetka.com.ua і увійди у свій магазин.

2. Відкрий розділ API-токенів

   Перейди: Налаштування → Безпека → API-токени і натисни «Створити токен».

3. Створи токен із роллю «Адміністратор»

   Дай токену зрозумілу назву (наприклад ai-pomichnyk) і обери роль Адміністратор — щоб помічник міг працювати з картками, замовленнями й чатами.

4. Скопіюй і збережи токен

   Зʼявиться довгий рядок, що починається на gapi_…. Скопіюй його та збережи в надійному місці — він показується лише раз.

Модуль 1 — AI-картки товарів, що продають

1.1 SEO-заголовок, який виводить у топ

Заголовок — найважливіше для пошуку. Робоча формула:

[Тип товару] + [Бренд/Модель] + [Ключова характеристика] + [Для кого/Призначення]

1. Відкрий Claude Code у своїй папці

   У терміналі: claude.

2. Дай йому промпт-заготовку

   Скопіюй цей промпт і встав, підставивши свій товар:

   Промпт: заголовок

   Ти — SEO-копірайтер маркетплейсу Rozetka. Напиши 5 варіантів заголовка товару за формулою: [Тип] + [Бренд/Модель] + [Ключова характеристика] + [Призначення]. Без КАПСУ, українською, по суті. Товар: «конструктор сумісний з Lego, Технік, тягач, 1200 деталей, для дітей 8+».
3. Обери найкращий і встав у Rozetka

   Claude видасть 5 варіантів — обери найточніший і встав у поле назви товару в кабінеті Rozetka.

1.2 Продаючий опис за структурою

Робоча структура опису (5 блоків): чіпляючий перший рядок → 3–5 вигод → характеристики → зняття заперечень → заклик до дії.

1. Дай Claude промпт опису
   Промпт: опис

   Напиши опис товару для картки Rozetka за структурою: 1) чіпляючий перший рядок, 2) 4 вигоди списком, 3) ключові характеристики, 4) зняття 2 типових заперечень, 5) заклик до дії. Тон — дружній, без води. Мова — українська. Обсяг 600–900 символів. Товар: [встав назву і 3-4 факти].
2. Перевір факти

   AI може «додумати» деталі. Звір характеристики зі своїми реальними — виправ, якщо треба.

3. Встав опис у картку

   Скопіюй у поле «Опис» товару в кабінеті Rozetka.

1.3 Характеристики та ключові слова

1. Попроси AI скласти характеристики

   Промпт: «Склади перелік характеристик для цього товару у форматі параметр: значення — максимально повно для картки Rozetka». Заповнені характеристики = вище в пошуку й фільтрах.

2. Збери ключові слова

   Промпт: «Дай 15 пошукових запитів українською, за якими покупці шукають цей товар на Rozetka». Вплети найкращі в заголовок і перший абзац опису.

1.4 Масова генерація карток

1. Підготуй список товарів

   Зроби простий файл tovary.txt у папці магазину: один товар на рядок (назва + кілька фактів).

2. Доручи завдання Claude Code
   Завдання Claude Code

   Прочитай файл tovary.txt. Для кожного товару згенеруй заголовок та опис (5 блоків) українською за моїми правилами SEO для Rozetka. Збережи результат у файл kartky.csv з колонками: назва, заголовок, опис.

   Claude сам створить файл kartky.csv з готовими картками для всіх товарів.

3. Перенеси в Rozetka

   Відкрий kartky.csv, перевір — і перенось у картки (вручну або через імпорт/шаблон товарів Rozetka).

Модуль 2 — AI авто-відповіді в чатах Rozetka

2.1 Як влаштований чат Rozetka і API повідомлень

Повідомлення покупців можна отримувати не лише в кабінеті, а й через офіційний API продавця Rozetka — тим самим токеном із Модуля 0. Помічник: кожні 2 хвилини читає нові повідомлення, ввічливо відповідає українською й позначає чат прочитаним.

Технічно це кілька адрес API (Claude Code використає їх сам):

# база API Rozetka (УВАГА: через дефіс, не крапку!)
https://api-seller.rozetka.com.ua

# список чатів із новими повідомленнями
GET  /messages/search?is_read=false

# один чат з усіма повідомленнями
GET  /messages/{id}?expand=messages

# надіслати відповідь покупцю
POST /messages/create

# позначити чат прочитаним
PUT  /messages/{id}

2.2 Claude Code збирає твій перший скрипт-відповідач

1. Поклади токен у файл .env
   Завдання Claude Code

   Створи файл .env і додай рядок ROZETKA_TOKEN=сюди_мій_токен. Додай .env у .gitignore. Поясни одним реченням, що ти зробив.

   Встав свій токен gapi_… замість сюди_мій_токен і збережи.

2. Доручи Claude Code зібрати відповідача
   Завдання Claude Code

   Збери Python-скрипт chat_bot.py для магазину на Rozetka. База API: https://api-seller.rozetka.com.ua (через дефіс, без /v1/). Він має: 1) брати токен із .env (ROZETKA_TOKEN), авторизація Authorization: Bearer токен; 2) кожні 2 хвилини робити GET /messages/search?is_read=false; 3) для кожного чату брати повідомлення (GET /messages/{id}?expand=messages) і, якщо останнє від покупця (sender = 3), формувати відповідь; 4) надсилати через POST /messages/create; 5) позначати чат прочитаним через PUT /messages/{id}. Поки що постав заглушку «Дякуємо за звернення!». Поясни, як запустити.
3. Запусти й перевір

   Claude Code підкаже команду (зазвичай python chat_bot.py). Напиши собі в чат магазину з іншого акаунта й переконайся, що приходить відповідь-заглушка.

2.3 Системний промпт менеджера: тон і правила

Візьми цю заготовку, підстав назву магазину й підправ під себе:

1. Встав промпт у скрипт
   Завдання Claude Code

   У chat_bot.py заміни заглушку на справжню відповідь: бери текст останнього повідомлення покупця і відправляй в AI (економну модель) разом із моїм системним промптом. Відповідь надсилай покупцю. Промпт винеси в окрему змінну зверху файлу.

2.4 Тест на справжніх повідомленнях і запуск

1. Режим чернетки

   Попроси Claude Code зробити «режим чернетки»: бот показує відповідь тобі (у термінал або Telegram), а ти вирішуєш, відправляти чи ні.

2. Перевір на 10–15 діалогах

   Підправ системний промпт, де відповіді не ідеальні.

3. Увімкни автопілот

   Коли якість влаштовує — бот відповідає сам, перевіряє чат кожні 2 хвилини.

Модуль 3 — Власний AI-агент магазину

3.1 Нові замовлення прямо в Telegram

1. Створи свого Telegram-бота

   У Telegram знайди @BotFather → /newbot → придумай імʼя. Збережи токен бота.

2. Дізнайся свій chat_id

   Напиши боту @userinfobot — він покаже твій chat_id.

3. Доручи Claude Code зібрати сповіщення
   Завдання Claude Code

   Додай сповіщення про замовлення Rozetka. Кожні 5 хвилин роби GET https://api-seller.rozetka.com.ua/orders/search із моїм токеном. Для кожного нового замовлення відправ мені в Telegram: номер, товари, суму, імʼя й телефон покупця. Токен бота і chat_id візьми з .env. Запамʼятовуй надіслані замовлення, щоб не дублювати.

3.2 Синхронізація залишків

Rozetka дозволяє масово оновлювати залишки через API. Якщо ведеш облік у таблиці — помічник зводитиме її з магазином.

1. Підготуй джерело залишків

   Google Таблиця або файл: колонки «артикул» і «кількість».

2. Доручи Claude Code синхронізацію
   Завдання Claude Code

   Збери синхронізацію залишків для Rozetka. Читай мої товари через GET /items/search (база https://api-seller.rozetka.com.ua, без /v1/), порівнюй кількість із моєю таблицею і онови різницю через PUT /items/mass-update. Оновлюй пакетами по 50 товарів. Спершу зроби «сухий прогін» — лише покажи, що змінив би. Я перевірю й дозволю реальне оновлення.

3.3 Планувальник: агент на автопілоті

1. Обʼєднай задачі в одному агенті
   Завдання Claude Code

   Зроби єдиний планувальник: відповіді в чатах — кожні 2 хвилини, нові замовлення — кожні 5 хвилин, синхронізація залишків — раз на годину. Додай простий лог. Поясни, як запустити однією командою.
2. Хай працює завжди

   Поки скрипт запущений — агент працює. Для 24/7 без ноутбука його ставлять на недорогий сервер (VPS). Це показуємо на живих заняттях.

Модуль 4 — Просування та аналітика з AI

4.1 Просування на Rozetka з AI

1. Вивантаж дані про товари й продажі

   З кабінету Rozetka вивантаж список товарів і статистику продажів.

2. Дай Claude проаналізувати
   Завдання Claude Code

   Проаналізуй мій експорт товарів і продажів Rozetka. Визнач: 1) товари-локомотиви (добре продаються, гарна маржа) — просувати першими; 2) товари з показами без продажів — що не так (ціна, картка, фото); 3) що просувати не варто. Дай конкретні рекомендації по бюджету просування.

4.2 AI-аналітика магазину

1. Збери дані

   Вивантаж замовлення за 1–3 місяці з кабінету Rozetka.

2. Попроси Claude зробити розбір
   Завдання Claude Code

   Зроби аналіз моїх замовлень Rozetka: топ-10 за виручкою, топ за кількістю, «мертві» позиції, середній чек, динаміка по тижнях. Дай 5 простих висновків і 3 конкретні дії на наступний місяць.

4.3 Фінальний проєкт і чек-лист запуску

Вітаю — якщо ти дійшов сюди, в тебе вже не «папка з уроками», а робоча система. Перевір себе: