sanatory.ru

Find Regions

Найти регион, курорт, город или страну по названию — например «Кисловодск». Возвращает place_id, который передаётся в search_sanatoriums, и parent — куда место входит (например, «Кавказские Минеральные Воды»). Совпадений может быть несколько — не берите первое вслепую, сверьте scope и parent: для поиска надёжнее всего город или курорт (scope: city); у крупных регионов (scope: region) объектов в каталоге может не оказаться — тогда search_sanatoriums подскажет взять город внутри региона. Для конкр

Find Hotels

Найти объект размещения (санаторий, отель, пансионат) по названию — например «Вилла Арнест». Опечатки допустимы. Возвращает id и slug для get_sanatorium и get_prices_availability. Одно название часто носят разные объекты в разных городах: если совпадений несколько, сверьте city и при неоднозначности уточните у пользователя, а не берите первое.

Find Treatment Profiles

Найти профиль лечения — по названию профиля («органы дыхания», «сердце») или по названию заболевания («астма», «остеохондроз»). Возвращает tag для фильтра treatment_profiles в search_sanatoriums; у профилей — ещё склонения названия (declension) для естественных русских фраз. Без query отдаёт весь справочник профилей.

Find Filter Options

Найти значения фильтров search_sanatoriums по названию: удобства («бассейн», «пляж», «детская комната»), питание, лечебные факторы, расположение, особенности размещения, тип объекта. Возвращает category + tag для одноимённого аргумента search_sanatoriums. Без query отдаёт каталог целиком (у amenities он большой — задайте categories).

Search Sanatoriums

Поиск санаториев по направлению, датам и составу гостей. place_id берётся из find_regions (курорт, регион, страна). Для конкретного санатория по названию используйте find_hotels → get_sanatorium, а не поиск. Без check_in/check_out ищет на даты по умолчанию — те же, что сайт; они возвращаются в ответе. У каждого объекта price_from посчитана по тарифу из stay: если stay.matches_requested_dates: false, тариф рассчитан на другие даты или срок (например, курс от 15 дней), и цену надо сопровождать это

Get Sanatorium

Детальная карточка санатория: описание, фото, профили лечения, программы, питание, условия оплаты, удалённость от транспорта. Принимает id или slug из выдачи search_sanatoriums. contacts — это контакты sanatory.ru (страница объекта, телефон, почта): бронирование и вопросы идут через них, прямых контактов санатория сервис не даёт. Цены и доступность на конкретные даты — get_prices_availability, отзывы — get_reviews. Даты и гости на карточку не влияют, но если разговор о конкретных датах — передай

Get Prices Availability

Цены, типы номеров и доступность санатория на конкретные даты. У каждого тарифа: includes — что входит в цену (питание, лечение, услуги), stay — даты и срок, на которые он посчитан: nights — ночи, value/unit — период тарификации (unit: day — суток на одни больше, чем ночей, и price_per_day считается за сутки), matches_requested_dates: false — тариф на другой срок; min_stay — минимальный срок в тех же единицах, cancellation_policy, где известна. available: false — это «нет тарифов на выбранные да

Find Available Dates

Ближайшие свободные даты санатория — когда на нужные даты мест нет (get_prices_availability → available: false) или пользователь гибок в датах. Ищет окна из nights ночей подряд в диапазоне from–to (не больше 60 дней) и проверяет цену на каждое найденное окно. У объектов-партнёров (внешний поставщик) календаря нет: проверяются только несколько дат с шагом в неделю (method: probing) — там задайте узкий диапазон. Для брони вызовите get_prices_availability на выбранные даты.

Get Reviews

Тексты отзывов гостей о санатории — чтобы ответить «как там кормят», «далеко ли до моря», «какое лечение». Рейтинг по 10-балльной шкале. Принимает id или slug из выдачи поиска. По умолчанию — свежие; sort: positive / negative — лучшие или худшие первыми. Листайте page, пока has_more: true.

Get Site Docs

Прочитать справочные файлы сайта для ИИ-агентов. «llms» — краткая карта сайта, Markdown-страницы и подключение MCP. «llms-full» — руководство по MCP и WebMCP, поиску, проверке тарифов, дат и гостей, ссылки на актуальные FAQ и условия. Цены и наличие проверяйте через get_prices_availability; правила и акции — по указанным страницам, не по памяти или старым условиям.

Prepare Certificate Link

Подготовить ссылку на форму покупки подарочного сертификата Санаторий.ру: номинал в рублях, формат, получатель, отправитель, поздравление и дата отправки. Заказ не создаётся, оплаты и отправки сертификата нет. Пользователь переходит по certificate_link, проверяет или дополняет данные и сам нажимает купить. Передавайте только данные, которые пользователь указал для этого подарка. Форма обязательно потребует sender.name, sender.email, sender.phone, recipient.last_name, а для digital ещё recipient.