🧰 Інструменти MCP-сервера

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

ℹ️ Дані Rozetka й SellerIQ нижче — це завжди тільки читання: змінити акаунт, налаштування сканерів чи підписку через AI-асистента не можна. Виняток — розділ 📗 Google Таблиці: там асистент може й писати, але лише в таблиці, які ви самі розшарили.

🖼 Картка товару

Інструмент	Що робить	Приклад запиту
`get_product_info` Інформація про товар	Актуальна, щойно завантажена картка товару Rozetka за посиланням чи ID (не зі збереженого кешу — завжди свіжий запит): ціна (базова, зі знижкою, промо), категорія, бренд, опис, фото, відео, відгуки, рейтинг, вішлист, статус продажу. За потреби може підтягнути й розширені дані — технічні характеристики, пропозиції інших продавців на цю саму картку, варіації товару.	«Що зараз коштує товар за цим посиланням і скільки в нього відгуків?»
`get_product_images` Фото товару	Показує саме зображення товару (не тільки посилання на нього) — асистент буквально «бачить» фото, а не просто читає про нього. Можна обрати конкретне фото за порядковим номером і розмір зображення.	«Покажи, як виглядає цей товар»
`get_product_comments` Відгуки на товар	Дослівний текст відгуків (автор, оцінка, плюси/мінуси, фото, кількість голосів «корисно»), актуальні на момент запиту — не зі збереженого кешу. Можна сортувати (за датою, з фото, за корисністю) і гортати сторінками. Якщо Rozetka вже згенерувала AI-підсумок відгуків за аспектами (що подобається/не подобається покупцям, з цитатами) — асистент отримає і його.	«Що найчастіше пишуть у відгуках на цей товар — які є скарги?»

🔍 Пошук і порівняння

Інструмент	Що робить	Приклад запиту
`search_products` Пошук товарів	Шукає товари в обраних категоріях — за точною назвою або за змістом запиту (знаходить товари навіть без збігу слів). Фільтри: ціна, продажі й виручка за 30 днів, кількість відгуків і рейтинг, тип продавця, наявність, бренд.	«Знайди навушники до 1000 грн з рейтингом від 4.5»
`get_similar_products` Схожі товари	Знаходить товари, схожі на конкретний товар, у тій самій категорії, відсортовані за відсотком схожості; можна фільтрувати за ціною і наявністю.	«Знайди товари, схожі на цей»
`compare_products` Порівняння товарів	Зводить до 20 товарів в одну таблицю одразу — ціна, наявність, відгуки, продажі за 30 днів тощо — не треба відкривати кожен товар окремо.	«Порівняй ці три товари за ціною і продажами»
`compare_characteristics` Порівняння характеристик	Порівнює технічні характеристики 2–25 товарів однієї категорії — які характеристики збігаються в усіх, які відрізняються, і точне значення кожної в кожного товару.	«Чим відрізняються характеристики цих моделей?»

📈 Позиції та ринок

Інструмент	Що робить	Приклад запиту
`get_position_by_keyword` Позиція за ключовим словом	Перевіряє прямо зараз, а не за розкладом, на якому місці товар у пошуку Rozetka за конкретним запитом — окремо органічна й рекламна позиція, перші дві сторінки видачі (до ~150 товарів). Без вказаного товару поверне список топ-N товарів за цим запитом. Завжди додає загальну картину першої сторінки — мінімальну, максимальну й середню ціну, знижку і вішлист серед конкурентів.	«На якому місці мій товар у пошуку за запитом …?»
`list_categories` Категорії	Повний перелік категорій Rozetka (~3000) з кількістю відстежуваних товарів у кожній — потрібен, щоб знайти правильну категорію для пошуку ніш чи товарів. Використовується асистентом здебільшого «за лаштунками».	«Які підкатегорії є в категорії …?»
`get_market_volume` Обсяг ринку	Рахує сумарні продажі, виручку й орієнтовний прибуток по категорії чи групі товарів за останні 30 днів, потижнево — те саме, що обсяг ринку у Black Box. Це частина ринку — тільки товари, які реально відстежуються (Rozetka і Фулфілмент), не весь ринок цілком.	«Наскільки велика ніша навколо цього товару?»
`find_opportunities` Пошук вигідних ніш	Шукає товари-кандидати в обраних категоріях за критеріями вигідності — те саме, що пошук ніш у Black Box: ціна, продажі, виручка, відгуки, тип продавця, наявність.	«Знайди вигідні товари в категорії … з не більш як 5 конкурентами»

💰 Ціна та прибутковість

Інструмент	Що робить	Приклад запиту
`get_price_trend` Динаміка ціни	Показує, як змінювалась ціна і продажі товару за останні 30 днів — напрямок (росте / падає / стабільна), відсоток зміни, мінімальну й максимальну ціну за період, сумарні продажі. Можна перевірити кілька товарів за один запит.	«Як змінювалась ціна цього товару за останній місяць?»
`get_commission` Комісія Rozetka	Розмір комісії Rozetka для категорії, ціни й бренду товару — тарифи різняться за ціновими діапазонами, і для деяких брендів є окремі умови.	«Яка комісія Rozetka на цю категорію при такій ціні?»
`estimate_margin` Оцінка маржі	Рахує орієнтовний прибуток і маржинальність товару за вказаною вами ціною закупівлі — ціну продажу й комісію бере прямо з картки товару. Без доставки й мита.	«Яка буде маржа, якщо закупити цей товар за … грн?»

🏭 Постачальники

Інструмент	Що робить	Приклад запиту
`find_suppliers` Пошук постачальника	Шукає постачальників на Alibaba за фото товару з Rozetka (за замовчуванням — головне фото картки), з фільтрами самої Alibaba (ціна, мінімальна партія, сертифікати, роки на платформі тощо) і орієнтовним прибутком/маржею з урахуванням комісії Rozetka — той самий пошук постачальника, що й у Black Box.	«Знайди постачальників цього товару на Alibaba»

📩 Telegram

Інструмент	Що робить	Приклад запиту
`list_telegram_chats` Список Telegram-чатів	Показує всі ваші підключені у SellerIQ Telegram-чати (особисті та групи) з їхніми категоріями — щоб асистент міг обрати потрібний чат для надсилання.	«У які чати можна надіслати повідомлення?»
`send_telegram_message` Надсилання в Telegram	Надсилає повідомлення чи файл (наприклад, готовий звіт чи таблицю) у ваш Telegram. Якщо не вказати конкретний чат — повідомлення піде у ваш системний чат; якщо підключено декілька чатів, можна попросити асистента надіслати в конкретний (наприклад, «у групу для команди»).	«Надішли мені цей звіт у Telegram»
`create_telegram_file_upload_url` Завантаження файлу для Telegram	Службовий інструмент — асистент використовує його «за лаштунками» разом з попереднім, щоб коректно надіслати великі файли звітів у Telegram. Викликати його окремо самостійно не потрібно.	—

📗 Google Таблиці

Потребує окремого, одноразового розшарювання конкретної таблиці на SellerIQ: 📗 Підключення Google Таблиць.

ℹ️ На відміну від решти інструментів вище, ці можуть і писати, а не тільки читати — але лише в тих таблицях, які ви самі розшарили.

Інструмент	Що робить	Приклад запиту
`list_sheet_tabs` Список листів	Показує назви всіх листів (вкладок) у таблиці.	«Які листи є в цій таблиці?»
`get_spreadsheet_info` Інформація про таблицю	Назва таблиці й параметри кожного листа — кількість рядків і стовпців.	«Скільки рядків у листі “Звіт”?»
`get_sheet_data` Читання даних	Читає значення клітинок — весь лист або конкретний діапазон.	«Прочитай дані з листа “Звіт”»
`update_sheet_cells` Запис у клітинки	Перезаписує значення в одному діапазоні клітинок.	«Встав ці дані в A1:C10»
`batch_update_sheet_cells` Пакетний запис	Перезаписує декілька різних діапазонів одного листа за один раз.	«Онови ці три блоки клітинок одночасно»
`add_sheet_rows` Додавання рядків	Вставляє порожні рядки в потрібному місці листа.	«Додай 5 порожніх рядків зверху»
`add_sheet_columns` Додавання стовпців	Вставляє порожні стовпці в потрібному місці листа.	«Додай два стовпці перед колонкою “Ціна”»
`add_sheet_tab` Новий лист	Додає новий лист у вже існуючу таблицю.	«Створи новий лист “Серпень”»
`rename_sheet_tab` Перейменування листа	Перейменовує існуючий лист.	«Перейменуй лист “Sheet1” на “Звіт”»
`copy_sheet_tab` Копіювання листа	Копіює лист — в ту саму таблицю або в іншу.	«Скопіюй лист “Липень” в цю ж таблицю»
`share_spreadsheet` Розшарювання таблиці	Відкриває доступ до таблиці іншим людям (читач, коментатор чи редактор) і надсилає їм лист-сповіщення.	«Розшар цю таблицю на colleague@gmail.com як читача»

📖 📗 Як розшарити таблицю на SellerIQ

📚 Бібліотека готових скілів

Крім даних, разом з MCP-сервером підключається і бібліотека готових, перевірених скілів SellerIQ — асистент застосовує потрібний сам, коли доречно, замість того, щоб винаходити підхід заново щоразу.

Інструмент	Що робить
`list_skills` Каталог скілів	Перелік готових скілів у бібліотеці.
`get_skill` Завантаження скіла	Підвантажує інструкції конкретного скіла зі списку.

📖 📚 Які скіли є в бібліотеці