ecomkit

Безкоштовно · без реєстрації

Інструменти, які я надаю безкоштовно

Частина роботи, яку я роблю руками в клієнтських магазинах, однакова скрізь. Такі речі дешевше написати один раз і надати всім, ніж повторювати щомісяця. Тут вони й лежать: без оплати, без реєстрації, без «залиште пошту, щоб завантажити». Поки що один — список поповнюватиметься.

  • Без оплати
  • Без реєстрації
  • Працює на вашому комп'ютері
  • Відкритий код

Прийшли сюди за встановленням? Технічна частина — внизу сторінки.

Інструмент 1 · Хорошоп

Розмова з вашим магазином звичайною мовою

Ви пишете в чат зі ШІ-асистентом те, що зазвичай робите руками в адмінці. Він читає ваш магазин і, якщо дозволите, змінює його. Підключається офіційним способом, який передбачив сам Хорошоп — так само, як підключаються KeyCRM чи SalesDrive.

Замовлення

  • «Покажи замовлення за минулий тиждень, які ще в обробці»
  • «Познач ці 12 замовлень відправленими і додай номери ТТН Нової Пошти»
  • «Звідки прийшли замовлення минулого місяця — з реклами, з розсилки чи з пошуку»

Каталог

  • «Які товари в розділі "Аксесуари" стоять без опису для пошуку»
  • «Онови ціни на цих 200 артикулів — і покажи, на яких не вийшло»
  • «Знайди приховані товари, на яких ще висять залишки»
  • «Збери комплект "разом дешевше" з цих трьох товарів зі знижкою 15%»

Покупці й налаштування

  • «Скільки покупців зареєструвалось у серпні і скільки з них погодились на розсилку»
  • «Перевір, які способи доставки й оплати зараз увімкнені»
  • «Вивантаж базу покупців, які купували більше одного разу»

Чого він не робить

  • Не працює сам. Тільки те, що ви попросили, і тільки поки чат відкритий: розкладів і фонових завдань тут немає.
  • Не бачить нічого, чого немає у вашому Хорошопі — ні аналітики, ні рекламних кабінетів, ні CRM.
  • Не замінює адмінку. Масові й нудні речі — так, тонке налаштування — ні.
  • Працює тільки з Хорошопом. Для Prom, Rozetka чи WooCommerce такого поки немає.

Поки інструмент один. Якщо вам щодня бракує чогось конкретного — напишіть у Telegram: черга наступних формується саме з таких листів.

Доступи

Ваш логін нікуди не йде — і я його не бачу

Хорошоп не має окремих ключів для інтеграцій: будь-яке підключення працює через логін і пароль адміністратора. Так влаштована платформа, і я кажу це одразу, а не дрібним шрифтом після встановлення.

Інструмент повністю живе на вашому комп'ютері. Немає ні мого сервера, ні хмари, ні реєстрації: логін лишається у файлі налаштувань на вашій машині, а запити йдуть напряму з вашого комп'ютера у ваш магазин. Я не отримую ні доступів, ні даних, ні навіть повідомлення про те, що ви цим користуєтесь.

Заведіть для цього окремого адміністратора — Налаштування → Адміни у вашій адмінці. Тоді доступ вимикається одним рухом, не блокуючи вхід вам, а в журналі магазину видно, що робив саме він.

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

І ще одне чесно: масове оновлення товарів пише в живий магазин, і скасувати це неможливо. Перед тим як оновлювати двісті артикулів, перевірте на одному.

Кому це підходить

Чесно про те, кому не варто витрачати час

Вам це стане в пригоді, якщо

  • У вас магазин на Хорошопі й каталог більший, ніж поміщається в голові.
  • Ви або хтось у команді вже користуєтесь ШІ-асистентом щодня — не пробували раз, а користуєтесь.
  • Ви регулярно робите однакову ручну роботу: масові ціни, статуси, вивантаження, перевірки перед акцією.

Не витрачайте час, якщо

  • У вас не Хорошоп. Інструмент працює тільки з ним.
  • Ніхто в команді не працює зі ШІ-асистентами. Тоді спершу потрібен асистент, а не цей інструмент.
  • Ви шукаєте кнопку в адмінці магазину. Її не буде: у Хорошопа немає магазину додатків, і сторонню кнопку туди не поставити — це рішення платформи, не моє.
  • Вам треба, щоб щось відбувалося саме, за розкладом і без людини. Це інша задача, і вона платна.

Навіщо мені це

Чому це безкоштовно

Я роблю цю роботу в клієнтських магазинах щодня, і половина її однакова. Написати один раз дешевше, ніж повторювати руками. Код відкритий, бо закритий безкоштовний інструмент нікому не потрібен: ви маєте мати змогу подивитись, що саме він робить із вашим магазином, а не вірити мені на слово.

Що я з цього маю — чесно: частина людей, які ним скористаються, колись прийдуть по роботу, яку інструментом не закриєш. Це весь розрахунок, і він розтягнутий у часі. Тому тут немає ні форми, ні пошти, ні «залиште контакт, щоб завантажити» — і не буде. Ви можете поставити його, користуватись роками й ніколи мені не написати. Це нормальний результат.

Питання

Що питають першим

Це безпечно? Я ж надаю доступ до магазину.

Доступ ви надаєте не мені, а програмі на власному комп'ютері. Хорошоп не видає окремих ключів для інтеграцій — існує тільки логін адміністратора, тому інакше не буває ні в кого, хто підключається до платформи. Заведіть окремого адміна в розділі «Налаштування → Адміни»: його можна вимкнути одним рухом. Перший запуск робіть у режимі лише читання. Я не бачу ні ваших доступів, ні даних.

Я не програміст. Я зможу?

Якщо ви вже користуєтесь Claude або Cursor — так, хвилин за десять: вставляєте один абзац у чат, асистент питає домен, логін і пароль і робить решту сам. Якщо ні — надішліть посилання на цю сторінку тому, хто налаштовував вам сайт або CRM. Для нього це та сама десятихвилинна задача.

Скільки це коштує?

Нуль. Ні зараз, ні потім, ні за оновлення. Платите ви тільки за самого ШІ-асистента, якщо у вас платна підписка — але це ваша окрема підписка, не моя.

Чи можна цим зіпсувати магазин?

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

Це офіційний продукт Хорошопа?

Ні. Я не пов'язаний із Хорошопом, і вони до цього не причетні. Інструмент працює через їхній відкритий інтерфейс для інтеграцій, документація якого опублікована — той самий, яким користуються CRM і системи обліку.

А для Prom, Rozetka чи WooCommerce буде?

Поки ні. Цей зроблений тому, що більшість магазинів, з якими я працюю, — на Хорошопі. Якщо вам потрібен такий самий для іншої платформи, напишіть: це вплине на порядок.

Якщо руками все одно довго

Коли безкоштовного інструмента вже мало

Інструмент закриває разові й ручні речі — ті, які ви й так робите, тільки швидше. Коли треба, щоб процес працював сам без вас — замовлення з усіх каналів в одному вікні, ТТН і статуси без людини, описи на весь каталог — це вже налаштування, і воно платне: від 20 000 ₴. Що з цього вашому магазину справді потрібно, а що ні, видно з аудиту.

Технічна частина

Далі — для того, хто ставитиме

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

Що потрібно

  • Node.js 20 або новіший
  • Клієнт із підтримкою MCP: Claude Code, Claude Desktop, Cursor, Cline
  • Окремий адміністратор у магазині на Horoshop — логін і пароль. Ключів API платформа не видає.

Встановлення через самого асистента

Найшвидший шлях. Вставте це в Claude Code, Claude Desktop або Cursor — асистент прочитає інструкцію, спитає доступи, пропише конфіг у потрібний файл і перевірить зв'язок. Пароль він записує тільки в конфіг: не в чат і не в git.

Встанови мені MCP-сервер horoshop-mcp.
Інструкція для тебе:
https://github.com/ecomkit-com-ua/horoshop-mcp/blob/main/llms-install.md
Прочитай її й виконай: спитай у мене домен магазину, логін і пароль адміна, пропиши конфіг
для того клієнта, у якому ти зараз працюєш, залиш на перший раз режим лише-читання
і перевір, що сервер відповідає.

Встановлення руками

Один блок у файлі налаштувань MCP-клієнта: команда npx -y horoshop-mcp і три змінні — HOROSHOP_DOMAIN, HOROSHOP_LOGIN, HOROSHOP_PASSWORD. Точний блок для Claude Code, Claude Desktop, Cursor і Cline — у README, щоб на двох сторінках не розходились дві версії однієї правди. Там само HOROSHOP_READONLY=1 і решта змінних. Конфіг містить пароль відкритим текстом — тримайте його поза git.

Що всередині

14 інструментів поверх 21 функції офіційного API Horoshop: замовлення й статуси, вивантаження та імпорт товарів, розділи каталогу, покупці, комплекти «разом дешевше», вебхуки, довідники доставки, оплати, валют і рівнів цін B2B — плюс універсальний виклик будь-якої функції API за назвою з документації. Дві залежності в рантаймі. 37 тестів, які піднімають макет Horoshop на локальному порту й не звертаються до жодного справжнього магазину. Ліцензія MIT.

У режимі HOROSHOP_READONLY=1 сім інструментів запису не реєструються взагалі — вони не з'являються у списку доступного, тому модель не може їх викликати. Універсальний виклик у цьому режимі окремо обмежений списком дозволених функцій читання.

Обмеження, про які варто знати заздалегідь

  • catalog/export віддає максимум 500 товарів за раз — далі гортання через offset. Окремо працює межа розміру відповіді, тому підказка про наступну сторінку рахується від показаних записів, а не від запитаного limit.
  • Частина функцій потребує Horoshop 4.0+ або модуля B2B — інакше приходить UNDEFINED_FUNCTION.
  • API не вміє показати наявні підписки на вебхуки, і їх не більше 5 на подію. Id підписки треба зберігати одразу.
  • horoshop_products_import незворотний, а images, gallery_common і gallery_360 за замовчуванням мають override: true — тобто стирають поточну галерею.

Приватність

Телеметрії немає: інструмент не звертається до жодного мого сервера, бо їх у нього немає. Доступи лишаються у файлі налаштувань на вашій машині. Єдине, про що варто пам'ятати: дані, які асистент дістає з магазину, стають частиною вашої розмови з ним — і йдуть постачальнику вашого ШІ, а не мені. Повністю — у політиці приватності.

Версія 0.1.0, опублікована в npm 3 вересня 2026. Знайшли помилку: issue в репозиторії або напишіть мені в Telegram.

Безкоштовний аудит