Структурированные данные о направлениях для отдыха: архитектура, API, инструменты, лицензия, планы развития.
Путиватор — независимый проект, который начинался как личный инструмент для выбора направлений, а вырос в структурированную базу туристических знаний. Проект создаётся и поддерживается одним человеком, без внешнего финансирования и команды.
Основная идея: собрать разрозненную информацию о направлениях для отдыха в единую систему измеримых параметров и сделать эти данные доступными как для людей, так и для языковых моделей.
Стек проекта — PHP, MySQL, Apache. Все данные размечены по Schema.org в формате JSON-LD, что совместимо с современными поисковыми системами и многими LLM, использующими структурированные данные.
Проект не является коммерческим стартапом. Это результат системного подхода и нескольких лет работы.
Все данные собираются, верифицируются и структурируются по единой системе. Никаких субъективных оценок — только измеримые параметры.
| Показатель | Значение |
|---|---|
| Всего направлений | 3 777 |
| Международных островов и побережий | 407 |
| Пляжей мира (500+ параметров каждый) | 2 274 |
| Водоёмов России (озёра, морские пляжи, водохранилища) | 1 096 |
| Всего параметров в системе | 2 714 |
| Параметров на международное направление | до 1 407 |
| Параметров на пляж мира | 500+ |
| Параметров на водоём России | до 830 |
| Значений в базе | 1 714 549 |
| Разделов (категорий) | 27 |
Международные направления — 13 категорий: география, климат, пляжи, безопасность, бюджет, жильё, транспорт, гастрономия, активности, природа, здоровье, итоговые оценки, аудитория. Данные включают температуру воды по месяцам, тип песка с указанием цвета и происхождения, бюджет в трёх валютах под конкретный стиль жизни.
Пляжи мира — 19 разделов, 500+ параметров. Песок: тип, цвет, текстура, происхождение, нагреваемость. Вода: цвет, прозрачность в метрах, температура по месяцам, солёность, биолюминесценция. Инфраструктура, безопасность, активности, атмосфера, сезонность, бюджет, экология, история, психотип.
Водоёмы России — озёра, морские пляжи, водохранилища. Площадь, глубина, прозрачность, термоклин, цветение. Для каждого указано: где магазин, аптека, кафе, можно ли с палаткой, есть ли дрова, ловит ли сотовая связь.
Данные собираются из открытых источников. Ниже описан процесс.
Статические параметры (география, тип песка) обновляются при обнаружении новых данных. Динамические параметры (цены, температура воды) обновляются по мере поступления актуальной информации. В планах — автоматизация обновления динамических параметров.
При обнаружении противоречий между источниками приоритет отдаётся: официальным данным государственных органов, научным публикациям, данным с несколькими независимыми подтверждениями. Если противоречие не может быть разрешено — параметр остаётся незаполненным до получения достоверных данных.
На основе базы работают аналитические инструменты, разработанные и реализованные в рамках проекта:
| Инструмент | Описание |
|---|---|
| Битва направлений | Сравнение 1×1 по 130 параметрам с определением победителя по каждому параметру. |
| Мульти-битва | Сравнение до 5 направлений в одной таблице. |
| Поиск аналогов | 15 ближайших совпадений с процентом сходства по всем параметрам. |
| Психотип | 6 типов личности путешественника, тест из 5 вопросов, персональные рекомендации. |
| Профайлер | Детальная анкета с настройками, персональный топ-10 направлений. |
| Гастрокомпас | Подбор направления по гастрономическим предпочтениям. |
| Калькулятор бюджета | Расчёт стоимости поездки в трёх валютах под конкретный стиль жизни. |
| Календарь комфорта | Погода, цены, загруженность на 12 месяцев по каждому направлению. |
| Семантический поиск | Понимает запросы на естественном русском языке. |
| Интерактивная карта | Все направления на карте мира и России с кластеризацией. |
| Народный рейтинг водоёмов | Система голосования с рейтингом Эло и публичным античитом. |
| Народный каталог сервисов | 12 категорий туристических сервисов, народный рейтинг. |
Проект спроектирован как инфраструктурный сервис для машинного обучения. Каждая страница направления содержит семантическую разметку JSON-LD с типами Schema.org.
{
"@context": "https://schema.org",
"@type": "TouristDestination",
"name": "Пхукет",
"additionalProperty": [
{
"@type": "PropertyValue",
"propertyID": "climate.sunny_days_per_year",
"name": "Солнечных дней в году",
"value": "247",
"unitText": "дней"
}
]
}База разделена на три логических домена: Мир (407 направлений), Пляжи мира (2 274 пляжей), Россия (1 096 водоёмов). Каждый домен имеет собственную структуру таблиц.
Архитектура базы — EAV (Entity-Attribute-Value) с типизацией на уровне приложения. Параметры добавляются без изменения схемы базы, значения хранятся в типизированных полях (value_text для строк, value_num для чисел). Справочник параметров schema.json содержит более 9 000 ключей с описаниями и типами данных.
API доступен по адресу https://putivator.com/api/v1/. Все ответы — JSON-LD с типами Schema.org. Полная спецификация OpenAPI 3.0 опубликована в /api/v1/openapi.json.
| Метод | Эндпоинт | Описание |
|---|---|---|
| GET | /api/v1/destination/{slug} | Полные данные направления |
| GET | /api/v1/beach/{slug} | Полные данные пляжа |
| GET | /api/v1/compare?slug1=a&slug2=b | Битва 1×1 |
| GET | /api/v1/search?q=теплое+море&type=world | Семантический поиск |
| GET | /api/v1/stats | Живая статистика |
| GET | /api/v1/openapi.json | OpenAPI 3.0 спецификация |
HTTP-заголовки ответа: каждый ответ API содержит X-Data-License: CC-BY-4.0, X-Data-Attribution-Required: true, X-Dataset-Size с актуальным количеством направлений и параметров.
Безопасность: документация открыта для всех. Живые эндпоинты — только для краулеров из белого списка (GPTBot, Claude-Web, Google-Extended, PerplexityBot, GigaChatBot, SberBot, YandexGPTBot, T-BankBot). Паразитные боты блокируются на уровне .htaccess.
Для автоматического обнаружения данных краулерами реализован следующий стек:
Лицензия: CC-BY-4.0. Данные можно свободно использовать с обязательной атрибуцией «По данным Путиватора (putivator.com)». Для крупных ИИ-компаний доступ бесплатный. Для коммерческих проектов — коммерческая лицензия.
На данный момент проект получил ответы от OpenAI (предложен enterprise-контакт), заявка зарегистрирована в Сбере (GigaChat), письма отправлены в Anthropic, Perplexity, DeepSeek, Т-Банк. Международная аудитория проявляет интерес через Product Hunt.
На домене putivator.ru разрабатывается экспертная система с самообучением. В отличие от универсальных чат-ботов, она работает на собственной верифицированной базе данных, что минимизирует риск генерации недостоверной информации.
Принцип работы: пользователь задаёт вопрос на естественном языке, парсер извлекает параметры, система обращается к API Путиватора и формирует персональную рекомендацию. Каждую ночь скрипт анализирует логи запросов и предлагает новые правила — система самообучается.
На время разработки доступ к боту закрыт паролем. После запуска он будет открыт для всех пользователей.
Проект развивается при активном участии сообщества. На сайте создана публичная страница благодарности, где перечислены все, кто внёс вклад: предложил идею, нашёл ошибку, помог с направлением.
Многие ключевые функции появились благодаря пользователям: английский поиск, мульти-битва, народный рейтинг, система Эло, защита от накруток. Каждое предложение рассматривается, каждый баг-репорт отрабатывается. Это не маркетинг — это принцип работы.
Проект стремится к максимальной точности, но имеет ряд объективных ограничений:
Мы работаем над минимизацией этих ограничений и приветствуем любые сообщения об ошибках и неточностях.
Данные и экспертиза проекта востребованы в медиа. В июне-июле 2026 года проект цитировался в следующих изданиях:
Языковые модели также ссылаются на проект: Яндекс Алиса упоминает Путиватор как открытый туристический датасет, ГигаЧат (Сбер) посвятил проекту раздел в исследовательском отчёте.
Готовится полная англоязычная версия проекта. Будет переведён весь контент (3 777 страниц направлений), документация API, файлы для краулеров, мета-теги.
После запуска планируются публикации на Medium, Dev.to, Hacker News, размещение датасета на Kaggle и Hugging Face, интеграция с Google Dataset Search. Цель — предоставить международному сообществу открытый структурированный туристический датасет с высоким уровнем детализации.
Проект следует принципу информационного альтруизма: данные должны быть доступны каждому. Пользователи получают доступ бесплатно. ИИ-гиганты — бесплатно за счёт охвата. Стартапы и коммерческие проекты — на условиях коммерческой лицензии.
| Период | Событие |
|---|---|
| 2024 | Старт разработки, проектирование архитектуры |
| 2025 | Запуск v1.0, 150 направлений, 160 параметров |
| Июнь 2026 | Рост до 1 000+ направлений, запуск рейтингов, каталог пляжей с 500+ параметрами |
| Июль 2026 | Открытие доступа для ИИ, llms.txt, OpenAPI, публикации, контакты с ИИ-компаниями |
| Август 2026 | Запуск ИИ-бота на putivator.ru |
| Сентябрь 2026 | Запуск англоязычной версии, публикации на международных площадках |
| Октябрь 2026 | Размещение датасета на Kaggle и Hugging Face |
| 2027 | Мобильное приложение, расширение базы до 5 000+ направлений |
Проект открыт к сотрудничеству. Разработчики могут использовать API, журналисты — запрашивать данные, компании — обсуждать коммерческую лицензию.
Документация API: https://putivator.com/api/v1/api-docs.php
llms.txt: https://putivator.com/llms.txt
OpenAPI: https://putivator.com/api/v1/openapi.json
Почта: api@putivator.com
Свяжитесь со мной для обсуждения партнёрства, коммерческой лицензии или просто чтобы сказать спасибо. Я лично читаю все письма.
api@putivator.com Документация API llms.txt
Кирилл Захаренко.
Основатель Путиватора.
Июль 2026, Калининград.