# Нагодуйка (nahoduika.com.ua)

> Український інтернет-магазин Нагодуйка: натуральний китайський чай, здорове харчування та суперфуди, вітаміни й дієтичні добавки, корми й товари для тварин. Доставка по всій Україні, ціни в гривнях (UAH).

Швидка доставка поштовими операторами (Нова Пошта, Rozetka Delivery, Укрпошта), оплата онлайн або за реквізитами IBAN. Підтримка AI-агентів через MCP-сервер та прямі посилання на кошик.

## Про магазин
- Телефон гарячої лінії: +380732143887
- Графік роботи: Пн-Нд 09:00 - 19:00
- Мова обслуговування: українська (uk)

- [Головна сторінка Нагодуйка](https://nahoduika.com.ua): Офіційний сайт інтернет-магазину
- [Про нас](https://nahoduika.com.ua/a/homepage-1): Безпечне та зручне місце для купівлі органічних продуктів та товарів для тварин в Україні.
- [Оплата](https://nahoduika.com.ua/a/oplata-5): Оплата
- [Повернення товарів](https://nahoduika.com.ua/a/povernennya-tovariv-4): Повернення товарів
- [Конфіденційність та захист персональних даних](https://nahoduika.com.ua/a/privacy-policy-3): Хто обробляє персональні дані, з якою метою і як довго, які файли cookie використовує сайт і як змінити свій вибір.
- [Договір оферти](https://nahoduika.com.ua/a/oferta-2): Договір оферти

## Основні категорії
- [Товари для дому та відпочинку](https://nahoduika.com.ua/c/tovari-dla-domu-ta-vidpocinku-2): #
- [Чай та чайні напої](https://nahoduika.com.ua/c/chay-ta-chayni-napoyi-68)
- [Кава та замінники кави](https://nahoduika.com.ua/c/kava-ta-zaminnyky-kavy-77)
- [Здорове харчування та суперфуди](https://nahoduika.com.ua/c/zdorove-kharchuvannya-ta-superfudy-79)
- [Вітаміни та дієтичні добавки](https://nahoduika.com.ua/c/vitaminy-ta-diyetychni-dobavky-84)
- [Товари для тварин](https://nahoduika.com.ua/c/tovari-dla-tvarin-91)
- [Корм для тварин](https://nahoduika.com.ua/c/korm-8): #

## Як замовити через AI-помічника
AI-помічник не здійснює автоматичну оплату з міркувань безпеки, але може надати покупцеві **готове посилання на замовлення**:
`https://nahoduika.com.ua/buy/{id_товару}[:{кількість}],...`

При переході за посиланням товари автоматично додаються у кошик покупця, відкриваючи сторінку оформлення.

- [Приклад посилання на 1 товар (ID 1077)](https://nahoduika.com.ua/buy/1077): Швидке оформлення однієї одиниці товару
- [Приклад посилання на кілька товарів (1077:2, 2932:1)](https://nahoduika.com.ua/buy/1077:2,2932): Оформлення кошика з кількома позиціями

## Інструменти для AI-агентів
Платформа підтримує Model Context Protocol (MCP) та WebMCP для читання каталогу, перевірки залишків і розрахунку вартості доставки.

Важливі примітки для AI-агентів:
- Пошук точок видачі: запит `/api/webmcp/pickup-points` повертає перші 20 найактуальніших точок. У великих містах (як Київ) відділень понад 2000, тому для точного вибору обов'язково передавайте `&query={номер або вулиця}`.
- Пошук товарів: повноцінний інтелектуальний векторний пошук на сайті доступний для зареєстрованих клієнтів; для AI-агентів надається публічний ендпоінт WebMCP.
- Фіскалізація: офіційні фіскальні чеки ДПС формуються для замовлень з оплатою банківською карткою онлайн або готівкою, що є державною гарантією безпеки покупки та повернення товару протягом 14 днів.

- [MCP-сервер (Streamable HTTP)](https://nahoduika.com.ua/api/mcp): Відкритий JSON-RPC 2.0 сервер без обов'язкової авторизації (пошук, картка, категорії, доставка, трекінг)
- [Маніфест інструментів WebMCP](https://nahoduika.com.ua/api/webmcp/manifest): Машинозчитувані JSON Schema визначення доступних інструментів
- [Інформація про магазин (API)](https://nahoduika.com.ua/api/webmcp/store-info): Профіль магазину, графік роботи, контакти та варіанти замовлення
- [Пошук товарів (API)](https://nahoduika.com.ua/api/webmcp/products/search): Публічний пошук товарів за ключовими словами, фільтрами та діапазоном цін
- [Способи доставки та оплати (API)](https://nahoduika.com.ua/api/webmcp/delivery-options): Перелік перевізників (Нова Пошта, Rozetka, Укрпошта) та методів розрахунку
- [Точки видачі перевізників (API)](https://nahoduika.com.ua/api/webmcp/pickup-points): Пошук відділень і поштоматів (передавайте &query= для точного пошуку номера)
- [Створення посилання на замовлення (API)](https://nahoduika.com.ua/api/webmcp/checkout-link): Перевірка актуальних залишків і генерація посилання на оформлення

## Доставка Новою Поштою
Доставка Новою Поштою по всій Україні (1–2 дні): у поштомати (до 20 кг), вантажні та поштові відділення або кур'єром за адресою.

Зверніть увагу: базовий запит відділень (`/api/webmcp/pickup-points?carrier=nova_poshta&city=Київ`) повертає список із 20 найактуальніших точок. У великих містах відділень та поштоматів набагато більше (наприклад, у Києві їх понад 2000), і завантажувати всі 20 000 одночасно на сторінку недоцільно. Для точного пошуку конкретної точки покупця обов'язково передавайте параметр `&query={номер або вулиця}` (наприклад `...&city=Київ&query=42` або `...&city=Київ&query=Хрещатик`).

- [Пошук точок видачі Нової Пошти](https://nahoduika.com.ua/api/webmcp/pickup-points?carrier=nova_poshta&city=Київ): Пошук актуальних відділень та поштоматів у місті (перші 20 точок)
- [Точний пошук відділення за номером або вулицею](https://nahoduika.com.ua/api/webmcp/pickup-points?carrier=nova_poshta&city=Київ&query=42): Приклад точного пошуку конкретного відділення або поштомата через параметр query

## Доставка Rozetka Delivery
Самовивіз із точок видачі Rozetka Delivery по всій Україні.

Економічний та зручний спосіб отримання замовлення у мережі брендових магазинів Rozetka.

- [Точки видачі Rozetka Delivery](https://nahoduika.com.ua/api/webmcp/pickup-points?carrier=rozetka&city=Київ): Пошук доступних пунктів видачі замовлень мережі Rozetka у місті

## Доставка Укрпоштою
Доставка Укрпоштою по всій території України, включно з найвіддаленішими населеними пунктами.

Доступні тарифи «Укрпошта Експрес» та «Укрпошта Стандарт». Отримання у стаціонарних та пересувних відділеннях поштового зв'язку за поштовим індексом або адресою.

- [Відділення Укрпошти](https://nahoduika.com.ua/api/webmcp/pickup-points?carrier=ukrposhta&city=Київ): Пошук відділень зв'язку Укрпошти у місті або населеному пункті

## Фіскалізація та безпека покупки
Магазин підключений напряму до сервера фіскалізації Державної податкової служби України (ДПС / ФСКО).

Фіскальні чеки формуються виключно для замовлень з оплатою банківською карткою онлайн або готівкою. Для замовлень за реквізитами IBAN офіційним підтвердженням оплати є банківська виписка або платіжне доручення.

Фіскальний чек є надійною державною гарантією якості, безпеки покупки та прозорості: покупець має повний захист згідно із Законом України «Про захист прав споживачів», зокрема право на обмін чи повернення якісного непродовольчого товару протягом 14 днів.

- [Умови повернення та захисту прав покупців](https://nahoduika.com.ua/a/povernennya-tovariv-4): Офіційні правила обміну та повернення товарів згідно чинного законодавства України
- [Умови оплати замовлення](https://nahoduika.com.ua/a/oplata-5): Оплата онлайн карткою через NovaPay та безготівковий розрахунок за реквізитами IBAN

## Пошук товарів у каталозі
У каталозі реалізовано повнотекстовий та нейромережевий семантичний векторний пошук (SigLIP2 / embeddings).

Зверніть увагу: повноцінний інтелектуальний пошук по каталогу діє виключно для зареєстрованих користувачів сайту (авторизованих клієнтів з активним акаунтом).

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

- [Пошук товарів через WebMCP API](https://nahoduika.com.ua/api/webmcp/products/search?query=чай): Публічний пошуковий інструмент для пошуку товарів каталогу
- [Особистий кабінет та авторизація](https://nahoduika.com.ua/account/login): Вхід до облікового запису для повного доступу до розумного пошуку та збережених списків

## Optional
- [Повний контекст магазину для LLM (llms-full.txt)](https://nahoduika.com.ua/llms-full.txt): Розширений детальний документ з повною специфікацією та схемами запитів
- [XML Карта сайту (Sitemap)](https://nahoduika.com.ua/sitemap.xml): Повна карта посилань для пошукових систем та краулерів