Перейти до вмісту
Torhy

Як працюють інструменти Torhy

Перелік MCP-інструментів Torhy: що робить кожен, основні параметри, ліміти та приклади запитів.

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

Асистент обирає інструменти сам, але знання їхніх можливостей допомагає формулювати точніші запити. Інструменти читання позначені readOnlyHint, інструменти зміни даних — окремі (створення, оновлення, видалення). Великі відповіді поділені на сторінки: у відповіді є next_cursor, який асистент передає, щоб отримати наступну сторінку.

Пошук і перегляд тендерів Prozorro

search_tenders — пошук тендерів

Шукає закупівлі в базі Torhy (оновлюється кожні 5 хвилин). За замовчуванням — лише відкриті тендери (статуси «Період уточнень» і «Подання пропозицій»), сортування за релевантністю.

Основні параметри: query (ключові слова; "точна фраза", OR, -виключення), cpv (коди або префікси ДК 021, напр. 45 чи 45261910-6), regions (назви або slug регіонів), statuses, methods, category (goods/services/works), value_min/value_max (грн), buyer_edrpou, published_from/published_to, deadline_from/deadline_to, profile_id (застосувати профіль компанії), sort (relevance, deadline, newest, value_desc, value_asc), limit (до 50), cursor.

Кожен результат: номер UA-…, назва, замовник, регіон, очікувана вартість, дедлайн, статус, основний код ДК 021, посилання на Prozorro і короткий фрагмент тексту. Ліміт: Пошуки.

get_tender — картка тендера

Повна інформація про закупівлю за номером UA-2026-…, внутрішнім ідентифікатором або посиланням на prozorro.gov.ua: предмет і позиції, лоти, строки, умови оплати, кваліфікаційні критерії, запитання та відповіді, перелік документів, учасники та їхні ціни (після аукціону), переможці й договори. Ліміт: Перегляди тендерів.

get_tender_documents — текст тендерної документації

Без document_ids повертає перелік документів закупівлі (назва, тип, формат, дата) — це безкоштовно. З document_ids (до 3 за раз) завантажує файли та повертає текст сторінками приблизно по 12 тис. символів (page). Підтримує PDF, DOCX, DOC, XLSX, XLS, ODT, RTF, HTML, TXT, ZIP і підписані КЕП файли (.p7s) — з підписаного файлу витягається вміст та дані підписанта. Скани без текстового шару позначаються needs_ocr. Ліміт: Документи — 1 одиниця за кожен документ, відкритий уперше за 30 днів.

Тендери ЄС (TED)

search_ted — пошук оголошень TED

Параметри: query, countries (ISO-коди, напр. POL, DEU, або назви), cpv, published_from, deadline_from, only_open (за замовчуванням лише з дедлайном у майбутньому), limit, cursor. Повертає англійську назву, назву мовою оригіналу, замовника, країну, коди CPV, дату публікації, дедлайн, очікувану вартість і посилання. Ліміт: Пошуки.

get_ted_notice — оголошення TED

Деталі за номером публікації (напр. 712345-2026): опис, лоти, посилання на документи закупівлі, контакти замовника, PDF оголошення. Ліміт: Перегляди тендерів.

Аналітика

find_awards — завершені закупівлі та переможці

Фільтри як у пошуку (ключові слова, ДК 021, регіони, замовник), плюс supplier_edrpou і період. Для кожного рішення: переможець, очікувана й договірна вартість, знижка у %, кількість учасників. Ліміт: Аналітика.

get_price_benchmark — ціни за одиницю

Для коду ДК 021 (і, за бажанням, одиниці виміру й ключових слів) рахує розподіл цін за одиницю з однопозиційних лотів: кількість спостережень, мінімум, 25-й процентиль, медіану, 75-й процентиль, максимум. Явні викиди (помилки введення кількості) відкидаються, їхня кількість показується. Якщо цін за одиницю немає — повертає розподіл загальних сум. Ліміт: Аналітика.

get_buyer_profile — профіль замовника

За кодом ЄДРПОУ: кількість і сума закупівель, частка скасованих і тих, що не відбулися, типові процедури, топ категорій ДК 021, найчастіші переможці, середня знижка, відкриті зараз тендери. Ліміт: Аналітика.

get_supplier_profile — профіль постачальника

За кодом ЄДРПОУ (або РНОКПП ФОП): кількість перемог і сума договорів, головні замовники, категорії, участь проти перемог там, де пропозиції вже розкрито. Ліміт: Аналітика.

Довідники та облік

  • lookup_cpv — пошук кодів ДК 021 / CPV за словами українською чи англійською або за кодом; показує батьківські розділи. Безкоштовно.
  • get_usage — ваш план, використання лімітів цього місяця та кількість збережених об'єктів.

Профіль компанії, сповіщення та відстеження

  • save_company_profile / get_company_profile — профіль компанії: назва, ЄДРПОУ, коди ДК 021, регіони, ключові слова, діапазон сум, опис можливостей.
  • create_alert, update_alert, list_alerts, delete_alert — збережені пошуки, що надсилають нові тендери на пошту або в Telegram (щодня, щотижня або одразу — залежно від плану).
  • list_alert_matches — тендери, знайдені вашими сповіщеннями.
  • watch_tender, list_watched_tenders, unwatch_tender — відстеження змін у конкретних тендерах: дедлайни, нові документи, запитання, скарги, рішення щодо переможця, договори.

Помилки

Кожна помилка містить код і пояснення, що робити далі, наприклад quota_exceeded (вичерпано місячний ліміт — з посиланням на зміну тарифу), limit_reached (досягнуто максимальної кількості сповіщень чи відстежуваних тендерів), not_found (тендер не знайдено — перевірте номер), invalid_input.