методичка курсу

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

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

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

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

Ціль урокуЗрозуміти, що саме ти отримаєш наприкінці курсу, і налаштуватись на результат.

За цей курс ти крок за кроком збереш свою AI-систему продажів на OLX:

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

📌 Головний принцип курсуТи ніколи не пишеш код сам. Ти виконуєш покрокові інструкції та копіюєш готові команди. У кінці кожного уроку є розділ «Якщо не вийшло».
Чек-лист уроку
  • Я розумію, що збудую за курс
  • Я розумію, що програмувати не доведеться
  • Я готовий приділити курсу 2–3 тижні

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

Ціль урокуЗареєструвати акаунт, через який працюватиме твій AI.
  1. Відкрий сайт Claude

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

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

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

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

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

💡 ПорадаЗапиши пошту й пароль у надійне місце (менеджер паролів).
Чек-лист уроку
  • Акаунт на claude.ai створено
  • Я можу зайти й бачу вікно чату

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

Ціль урокуВстановити 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»). Введи:

    node -v

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

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

  1. Команда встановлення

    У терміналі:

    npm install -g @anthropic-ai/claude-code
  2. Запусти

    Введи claude. Першого разу авторизуйся в браузері акаунтом claude.ai.

  3. Перевір

    Напиши в терміналі: Привіт! Ти готовий допомагати? Відповів — усе працює. 🎉

⚠️ Якщо не вийшло«command not found: npm» → Node.js не встановився, повтори Крок А і перезапусти термінал. «permission denied» на Mac → додай попереду sudo.
Чек-лист уроку
  • node -v показує версію
  • Команда claude запускає Claude Code
  • Я отримав відповідь

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

Ціль урокуПерестати боятись «чорного вікна» й навчитись базовим діям.
  1. Створи робочу папку
    # створюємо папку на робочому столі
    cd Desktop
    mkdir olx-pomichnyk
    cd olx-pomichnyk
  2. Запусти тут Claude Code

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

💡 ПорадаКоманди можна копіювати з методички та вставляти в термінал (Ctrl+V, на Mac Cmd+V).
Чек-лист уроку
  • Я створив папку olx-pomichnyk
  • Я вмію заходити в папку через cd
  • Я запускаю claude усередині папки

0.5 Доступ до OLX API

Ціль урокуПодати заявку на офіційний OLX API — ключ, через який помічник сам читатиме чати й публікуватиме оголошення. І не марнувати час, поки чекаєш схвалення.

Для повної автоматизації OLX дає офіційний API. Доступ видають за заявкою — це звичайний робочий шлях, саме так працюють магазини. Подаємо заявку першим кроком, бо схвалення займає трохи часу.

  1. Май робочий акаунт продавця OLX

    Звичайний акаунт, з якого ти вже продаєш (або зареєструй його).

  2. Створи застосунок і подай заявку на API

    Зайди в кабінет розробника/партнера OLX, створи новий застосунок (проєкт), заповни дані про себе й магазин і надішли заявку на доступ до API. Це безкоштовно.

  3. Дочекайся схвалення й отримай ключі

    OLX перевіряє заявку — зазвичай 1–2 робочі дні. Після схвалення ти отримаєш client_id і client_secret. Далі один раз проходимо авторизацію: Claude Code відкриє тобі посилання OLX, ти увійдеш у свій акаунт і підтвердиш доступ застосунку — і отримаєш OLX_REFRESH_TOKEN (це «довгий» ключ автопілота). Збережи всі три значення — у Модулі 2 покладемо їх у .env.

  4. Поки чекаєш — не гай часу

    Доступ ще не прийшов? Працюй у напівавтоматі: AI вже зараз готує тобі заголовки, описи й відповіді (Модуль 1 і далі), а ти публікуєш вручну. Коли прийде API — увімкнеш повний автопілот.

📌 Чому саме такНа відміну від Prom і Rozetka (де токен береться в кабінеті за хвилину), OLX видає доступ за заявкою з модерацією. Це нормально — просто подай заявку заздалегідь. API — головний шлях; напівавтомат — щоб почати продавати вже сьогодні, не чекаючи.
Чек-лист модуля 0
  • Claude Code встановлено й запускається
  • Створено робочу папку магазину
  • Є робочий акаунт продавця OLX
  • Я розумію різницю між напівавтоматом і API-автопілотом

Модуль 1 — AI-оголошення, що потрапляють у топ

1.1 SEO-заголовок під пошук OLX

Ціль урокуНавчити AI писати заголовки, які OLX виводить угору пошуку.

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

[Бренд] + [Модель] + [Ключова характеристика] + [Стан/Розмір]

Промпт: заголовок OLX
Ти — SEO-копірайтер OLX.ua. Напиши 5 варіантів заголовка за формулою [Бренд]+[Модель]+[Ключова характеристика]+[Стан/Розмір]. Правила: довжина 16–70 символів; головний ключ — у перших 2–3 словах; БЕЗ слова «Продам»; без КАПСУ; без спецсимволів (*, ^, @); без телефону й ціни. Українською. Товар: «конструктор сумісний з Lego Technic, кран, 1078 деталей, новий».
💡 МікронішуванняЗамість широкого заголовка («Конструктор») роби вузький, точний («Конструктор сумісний з Lego Technic кран 1078 деталей новий») — так ти займаєш конкретні запити зі слабкою конкуренцією.
Чек-лист уроку
  • Заголовок 16–70 символів, ключ на початку
  • Без «Продам», КАПСУ, спецсимволів, телефону
  • Оновлено заголовок хоча б одного оголошення

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

Ціль урокуОтримати опис, який продає й не порушує правил OLX.

Робоча структура опису OLX (5 блоків), 300–1200 символів, звичайний текст:

  1. Суть + вигода — головний ключ у першому реченні (його видно в превʼю пошуку).
  2. Стан — детально: новий / б/в, дефекти.
  3. Характеристики — чіткий список через «•».
  4. Доставка — акцент на OLX Доставку (це важливо для рейтингу, див. Модуль 4).
  5. Заклик — «Пишіть у чат».
Промпт: опис OLX
Напиши опис оголошення для OLX.ua за структурою: 1) суть+вигода з головним ключем у першому реченні, 2) стан товару, 3) характеристики списком через «•», 4) умови доставки з акцентом на OLX Доставку, 5) заклик «Пишіть у чат». Звичайний текст, 300–1200 символів, українською. БЕЗ емодзі, БЕЗ телефону в тексті, без води. Одне чітке входження ключа (без спаму). Товар: [встав назву і факти].
⚠️ Комплаєнс OLX (інакше бан або зняття оголошення) • Заборонені слова: «копія», «репліка», «підробка», «fake» → OLX відхиляє. • Телефон у тексті заборонений (з вересня 2025) — лише в полі контактів. • Без емодзі в описі (через API це взагалі помилка). • «LEGO» та інші чужі бренди — лише як вторинний ключ («сумісний з LEGO»), не соло в заголовку.
Чек-лист уроку
  • Опис має всі 5 блоків, 300–1200 символів
  • Є акцент на OLX Доставку
  • Немає заборонених слів, телефону, емодзі

1.3 Параметри й фільтри — найважливіше на OLX

Ціль урокуЗаповнити ВСІ параметри оголошення — без цього товар не показується у фільтрах.
⚠️ КритичноЯкщо не заповнити параметри категорії (стан, розмір, бренд, тип тощо) — оголошення повністю випадає з видачі за фільтрами. Текст це не компенсує. Покупці фільтрують — і просто тебе не бачать.
  1. Подивись, які параметри є в категорії

    У формі створення оголошення OLX показує поля параметрів саме твоєї категорії.

  2. Попроси AI підказати значення
    Промпт: параметри
    Для цього товару на OLX заповни всі типові параметри категорії у форматі параметр: значення (стан, бренд, тип, розмір, матеріал, колір — що доречно). Якщо чогось не знаю — познач, що уточнити. Товар: [встав назву і факти].
💡 Фото вирішує CTRДодавай 5–8 реальних фото (не стокових). Перше фото (обкладинка) — яскраве, контрастне, товар крупно: саме воно вирішує, чи клікнуть на тебе в пошуку.
Чек-лист уроку
  • Усі доступні параметри категорії заповнені
  • 5–8 реальних фото, перше — контрастне
  • Оголошення зʼявляється у фільтрах

1.4 Масова генерація оголошень

Ціль урокуЗгенерувати оголошення одразу для багатьох товарів.
  1. Підготуй список товарів

    Файл tovary.txt: один товар на рядок (назва + факти).

  2. Доручи завдання Claude Code
    Завдання Claude Code
    Прочитай tovary.txt. Для кожного товару згенеруй заголовок (16–70 символів, ключ на початку, без «Продам») і опис (5 блоків, 300–1200 символів, без емодзі й телефону, з акцентом на OLX Доставку). Збережи у файл ogoloshennya.csv з колонками: назва, заголовок, опис.
  3. Публікуй

    Бери готові тексти з ogoloshennya.csv і створюй оголошення в кабінеті OLX (або через API, якщо є доступ).

Чек-лист модуля 1
  • Є робочі промпти для заголовка, опису, параметрів
  • Згенеровано тексти для списку товарів у ogoloshennya.csv
  • Хоча б 5 оголошень оновлено/опубліковано

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

2.1 Як влаштовані чати OLX

Ціль урокуЗрозуміти, як працює листування на OLX і чому швидкість відповіді — це гроші.
📌 Швидкість = позиція в пошукуOLX дає плашку «швидко відповідає» й піднімає в видачі тих, хто відповідає швидко. Орієнтир — відповідь протягом 15 хвилин. Тому навіть напівавтомат (AI готує — ти відправляєш) уже дає перевагу, а повний автопілот через API — максимум.

Якщо є доступ до OLX API, листування читається через «треди» (розмови):

# база OLX Partner API
https://www.olx.ua/api/partner

# список розмов із непрочитаними
GET  /threads        # дивимось unread_count > 0

# повідомлення в розмові
GET  /threads/{id}/messages   # type: received (від покупця) / sent (від нас)

# надіслати відповідь
POST /threads/{id}/messages   # тіло: {"text": "..."}
⚠️ Дві головні граблі OLX API1) До службових адрес OLX треба ходити із заголовком User-Agent: curl/7.88.1 — інакше захист OLX поверне 403. 2) Скрізь потрібен заголовок Version: 2.0. Якщо Claude Code отримує 403 — підкажи йому ці два правила.
Чек-лист уроку
  • Я розумію, що швидка відповідь дає буст у пошуку
  • Я знаю, що відповідаємо лише на повідомлення type = received
  • Я знаю про граблі User-Agent і Version: 2.0 (якщо є API)

2.2 Перший відповідач (напівавтомат і автопілот)

Ціль урокуЗібрати помічника, який готує (або сам надсилає) відповіді покупцям.

Без API (працює в усіх): Claude Code робить тобі «помічник чату» — ти копіюєш питання покупця, отримуєш готову відповідь і вставляєш у чат OLX за секунди. Цього достатньо, щоб ловити плашку «швидко відповідає».

З API (повний автопілот):

  1. Поклади ключі в .env
    Завдання Claude Code
    Створи .env і додай OLX_CLIENT_ID, OLX_CLIENT_SECRET, OLX_REFRESH_TOKEN. Додай .env у .gitignore. Поясни одним реченням, що зробив.

    Встав свої значення зі свого OLX-застосунку (Модуль 0, урок 0.5).

  2. Доручи Claude Code зібрати відповідача
    Завдання Claude Code
    Збери Python-скрипт для OLX Partner API (база https://www.olx.ua/api/partner). До всіх запитів додавай заголовки User-Agent: curl/7.88.1 і Version: 2.0. Логіка: кожні 2 хвилини GET /threads, для розмов з unread_count > 0 бери GET /threads/{id}/messages; якщо останнє повідомлення type = received — формуй відповідь і надсилай через POST /threads/{id}/messages з тілом {"text": ...}. Памʼятай, на що вже відповідав, щоб не дублювати. Поки що постав заглушку «Дякуємо за звернення!».
⚠️ Якщо не вийшло403 → немає заголовка User-Agent: curl/7.88.1 або Version: 2.0. Помилка авторизації → протух refresh-токен, треба переавторизуватись у OLX-застосунку. Встав текст помилки в Claude Code — він підкаже.
Чек-лист уроку
  • Працює щонайменше напівавтомат (AI готує відповіді)
  • Якщо є API — скрипт читає треди й відповідає
  • Бот не відповідає двічі на одне повідомлення

2.3 Системний промпт менеджера

Ціль урокуЗробити відповіді «людськими», ввічливими й безпечними.
Системний промпт менеджера (копіюй)
Ти — ввічливий продавець на OLX. Відповідай українською, тепло й коротко (2–3 речення). Правила: 1) не називай точну ціну/наявність, якщо не впевнений — напиши, що уточниш; 2) пропонуй OLX Доставку як зручний і безпечний варіант; 3) не вигадуй характеристики; 4) не залишай номер телефону в чаті (це порушує правила OLX); 5) завершуй доброзичливо. Без емодзі.
Завдання Claude Code
Заміни заглушку на справжню відповідь: текст останнього повідомлення покупця відправляй в AI (економну модель, наприклад Claude Haiku) разом із моїм системним промптом. Системний промпт винеси в окрему змінну зверху.
⚠️ Золоте правилоAI відповідає за стиль, ти — за факти. І жодних телефонів у чаті — за це OLX карає.
Чек-лист уроку
  • Відповіді ввічливі, українською, без емодзі й телефонів
  • Бот пропонує OLX Доставку
  • Складні питання — передає тобі

2.4 Тест і запуск

Ціль урокуБезпечно вивести відповідача «у бій».
  1. Режим чернетки

    Спочатку бот показує відповідь тобі (термінал/Telegram), ти підтверджуєш відправлення.

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

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

  3. Увімкни автопілот (якщо є API)

    Бот відповідає сам, перевіряє кожні 2 хвилини — і тримає плашку «швидко відповідає».

Чек-лист модуля 2
  • Відповідач протестований у режимі чернетки
  • Системний промпт відлагоджено
  • Відповіді швидкі, дублів немає

Модуль 3 — Власний AI-агент продажів

3.1 Ліди прямо в Telegram

Ціль урокуЩоб кожне звернення покупця миттєво прилітало тобі в Telegram.
  1. Створи Telegram-бота

    @BotFather/newbot → збережи токен бота. Свій chat_id дізнайся через @userinfobot.

  2. Доручи Claude Code
    Завдання Claude Code
    Додай сповіщення: коли в чаті OLX зʼявляється нове повідомлення від покупця (type = received), відправ мені в Telegram текст, назву оголошення й посилання на розмову. Токен бота і chat_id візьми з .env. Без API-доступу — зроби це для напівавтомату (нагадування перевірити чат).
Чек-лист уроку
  • Telegram-бот створено, ключі в .env
  • Нові звернення прилітають у Telegram
  • Без дублів

3.2 VAS-просування з розумом

Ціль урокуНавчитись користуватись платним просуванням OLX (Підняття, Топ) так, щоб воно окуповувалось.
📌 Принцип №0Платні послуги лише масштабують поточну якість. Якщо параметри не заповнені, заголовок слабкий чи фото погане — буст = гроші на вітер. Спочатку органіка (Модуль 1), потім VAS.

Що працює:

💡 Тайминг (товари, B2C)Будні 12:00–14:00 і 19:00–21:30; неділя ввечері — абсолютний пік. Запускай нові оголошення у четвер–пʼятницю ввечері, щоб до вихідних накопичити статистику. Пікові дні для бустів: неділя, Чорна пʼятниця, 6 і 25 грудня.

AI допомагає це спланувати:

Завдання Claude Code
З мого списку оголошень і статистики порадь: які 5 товарів просувати першими (добре продаються), у які дні й години вмикати Підняття/Топ за таймінгом для товарів B2C, і на які оголошення НЕ витрачати буст (слабка органіка). Дай конкретний план на тиждень.
⚠️ Найдорожча помилка на OLXНе редагуй картку часто! Кожне редагування → повторна модерація → тимчасове зниження в видачі → падіння замовлень. Якщо треба правити — зроби це рідко й за один прохід. (Платне просування вмикається в кабінеті OLX — через API його офіційно немає.)
Чек-лист уроку
  • Є список товарів для просування
  • Є план бустів за таймінгом
  • Я не редагую картки зайвий раз

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

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

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

Чек-лист модуля 3
  • Ліди прилітають у Telegram
  • Є план просування
  • Планувальник працює за розкладом

Модуль 4 — Рейтинг, OLX Доставка та аналітика

4.1 Рейтинг, OLX Доставка і «швидко відповідає»

Ціль урокуЗапустити три безкоштовні драйвери, які піднімають тебе в пошуку OLX і ростять конверсію.
📌 Звідки беруться зірки рейтингуРейтинг продавця (зірки) на OLX будується лише на верифікованих угодах через OLX Доставку. Тому: вмикай OLX Доставку всюди, став її умовою в описі й пропонуй у чаті. Більше угод через Доставку → більше зірок → вища конверсія й позиція.
Завдання Claude Code
Напиши 3 ввічливі шаблони українською: 1) як після угоди попросити покупця залишити відгук; 2) відповідь на позитивний відгук; 3) спокійна відповідь на негативний відгук із пропозицією вирішити питання.
Чек-лист уроку
  • OLX Доставка увімкнена й згадана в оголошеннях
  • Швидкі відповіді тримають плашку «швидко відповідає»
  • Є система збору відгуків

4.2 AI-аналітика

Ціль урокуПеретворити статистику оголошень на конкретні дії.
  1. Збери статистику

    З кабінету OLX вивантаж перегляди, контакти й продажі по оголошеннях.

  2. Дай Claude розбір
    Завдання Claude Code
    Проаналізуй статистику моїх оголошень OLX. Знайди: 1) оголошення з переглядами, але без звернень — що не так (ціна/опис/доставка); 2) оголошення без переглядів — переробити заголовок або перше фото; 3) топ-оголошення — їх масштабувати бустами. Дай 5 висновків і 3 дії на тиждень.
💡 Логіка циклуЄ перегляди, нема звернень → знизь ціну або перепиши опис. Нема переглядів → перероби заголовок / перше фото. Усе — за один прохід, не смикай картку щодня.
Чек-лист уроку
  • Є звіт по оголошеннях
  • Зрозуміло, що переробити, а що масштабувати
  • Є 3 дії на тиждень

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

Ціль урокуЗвести все докупи й переконатись, що твоя AI-система на OLX працює.
Фінальний чек-лист курсу
  • Claude Code встановлено й запускається (Модуль 0)
  • AI генерує заголовки (16–70 симв.), описи й параметри (Модуль 1)
  • Усі параметри заповнені — оголошення видно у фільтрах (Модуль 1)
  • Відповідач працює швидко, тримає плашку «швидко відповідає» (Модуль 2)
  • Ліди прилітають у Telegram (Модуль 3)
  • Є план VAS-просування за таймінгом (Модуль 3)
  • OLX Доставка увімкнена, рейтинг росте (Модуль 4)
  • Регулярна AI-аналітика (Модуль 4)
🎓 Ти зробив це!Ти власноруч (через AI) зібрав систему продажів на OLX: оголошення в топі, миттєві відповіді, рейтинг і просування за даними. Наступний крок — масштабувати підхід на Prom і Rozetka.
AI Cortex Academy · методичка курсу «ШІ для продавців OLX» · повний курс, Модулі 0–4