# AviaSeek - WebMCP для ИИ-агентов > AviaSeek - глобальный метапоисковик авиабилетов. Агрегирует цены из авиакомпаний и агрегаторов, показывает лучшие варианты перелётов (прямые рейсы и с пересадками, цены в RUB, время в пути, условия багажа). Сайт реализует WebMCP (Model Context Protocol for the Web): браузеры с поддержкой могут получить инструменты через `document.modelContext`. Расширенная версия этого файла - `/llms-full.txt`. ## Данные каталога (live) 318 городов, 340 аэропортов, 20 авиакомпаний, 312 направлений в справочнике, 15 статей помощи. Версия контракта `searchFlights`: `1.1.0`. Markdown-версия любой страницы: путь + `.md` (например `/cities.md`, `/cities/moskva-mow.md`, `/index.md`). ## Серверный MCP (для облачных агентов) Помимо браузерного WebMCP, AviaSeek предоставляет **настоящий серверный MCP-эндпоинт** по протоколу Model Context Protocol (Streamable HTTP): `https://aviaseek.ru/mcp`. Инструмент `searchFlights` доступен серверным агентам (DeepSeek, Claude, ChatGPT, Cursor и др.) **напрямую, без браузера**. Методы: `tools/list`, `tools/call`. Схема входа/выхода - та же, что у браузерного WebMCP (см. `/llms-full.txt`). Автодискавери: `https://aviaseek.ru/.well-known/mcp.json`. ## Как выполнить поиск (3 способа) 1. **MCP** (если у агента есть MCP-клиент): `POST https://aviaseek.ru/mcp`, инструмент `searchFlights` (JSON-RPC 2.0, Streamable HTTP). 2. **URL-поиск** (агент умеет только открывать ссылки): `https://aviaseek.ru/search?from=MOW&to=LED&date=2026-09-20` -> редирект на страницу результатов с ценами и ссылками на покупку. Параметры: `from`/`origin`, `to`/`destination`, `date`/`departure_date` (`YYYY-MM-DD`, `DD.MM.YYYY`, `MMDD` или `tomorrow`), `return`, `adults`, `children`, `infants`, `cabin` (`economy|business|first`). Без даты - редирект на страницу маршрута с календарём цен. Справка с HTML-формой (работает без JavaScript): `https://aviaseek.ru/search`. 3. **Прямая ссылка на результаты**: `https://aviaseek.ru/results?flightSearch=MOW0920LEDy100` - формат `AAAMMDDБББ[MMDD][ycf][взрослые][дети][младенцы]` (то же значение, что в `view_all_url` ответа MCP). Если страницу открывает агент/бот, сервер сам выполняет поиск и отдаёт **HTML со списком вариантов и ссылками на покупку** - это путь для ассистентов, которые умеют только читать страницы (MCP и HTTP-запросы недоступны). 4. **JSON для агентов без MCP** (один GET, сразу готовые ссылки на покупку): `https://aviaseek.ru/api/flights?from=MOW&to=LED&date=2026-09-20&limit=5` -> `results[]`, где у каждого варианта есть `title`, `price`, `currency`, `transfers`, `duration_minutes`, `display_markdown` и **`booking_url`** вида `/r//` (действует ~15 минут). Фильтры в query: `direct=1`, `max_price`, `max_transfers`, `transfers=0,1`, `airlines=DP,S7`, `with_baggage=1`, `departure_periods=morning,afternoon`, `sort=price_asc|duration_asc|departure_asc|arrival_asc|transfers_asc|recommended`, `limit` (до 50), `offset`. Если параметров не хватает или нет даты, ответ `200` содержит `status: need_route|need_date` и пример ссылки. Город в `from`/`to` можно задать кодом IATA города или аэропорта, slug страницы (`moskva-mow`, `sankt-peterburg-led`) или названием («Москва», «Санкт-Петербург»). ## Контракт вывода и фильтрация (searchFlights, v1.1) - По умолчанию возвращаются **20** самых дешёвых вариантов (`limit`, максимум 100). Остальные - через `offset` + `has_more`/`next_offset`; `view_all_url` ведёт на страницу результатов на сайте. - `sort`: `price_asc` (по умолчанию), `duration_asc`, `departure_asc`, `arrival_asc`, `transfers_asc`, `recommended`. - `filters` применяются **до** сортировки и обрезки: `direct_only` (только прямые), `max_transfers`, `transfers[]` (точные наборы пересадок, как галочки на сайте), `max_price`, `max_duration_min`, `airlines[]`, `with_baggage`, `with_handbag`, `with_change`, `with_return`, `departure_periods[]`, `arrival_periods[]` (`early_morning` 00:00-06:00, `morning` 06:00-12:00, `afternoon` 12:00-18:00, `evening` 18:00-24:00). - Примеры: «только прямые» → `filters.direct_only=true`; «до 10 000 ₽» → `filters.max_price=10000`; «утром» → `departure_periods=["morning"]`; «самый быстрый» → `sort=duration_asc`. - Пустая выдача → `total_after_filters=0` и подсказка `hint` (что именно ослабить). ### Как показывать результат пользователю (обязательно) - 3-5 вариантов списком: авиакомпания и номер рейса, время вылета → прилёта, число пересадок, длительность, цена и **кликабельная ссылка** вида `[Купить за 3 179 ₽](booking_url)`. - В каждом варианте есть готовое поле `display_markdown` - можно воспроизвести его как есть, в нём уже есть цена и ссылка. - Не отвечайте одной ценой без ссылки и не выдумывайте варианты, которых нет в `results`. - `is_complete: false` → предупредите, что цены предварительные, и повторите вызов с тем же `search_id`. ## Навык Алисы (голосовой) AviaSeek доступен как навык для Яндекс Алисы: пользователь говорит «Алиса, спроси у АвиаСика, найди билеты из Москвы в Питер на завтра». Навык ищет билеты через AviaSeek и озвучивает лучшие варианты (топ-3) или показывает карточку с вариантами и ссылками на покупку на экранных устройствах. - Webhook: `https://aviaseek.ru/alice` (POST, протокол Яндекс Диалогов, лимит ответа 4,5 сек). - Поиск асинхронный (split-turn): на «найди билеты» запускается поиск, продолжение по фразе/кнопке «проверить результат». - Ссылки на покупку - страница покупки `https://aviaseek.ru/r//`. ## WebMCP tools - [searchFlights](/): поиск авиабилетов по маршруту и датам. Возвращает список рейсов с ценами, авиакомпаниями, временем и ссылкой для покупки. - Параметры: `origin`, `destination` (IATA-код, 3 буквы, напр. MOW, LED, PAR), `departure_date` (YYYY-MM-DD, обязателен), `return_date` (опционально, для «туда-обратно»), `adults`/`children`/`infants` (количество пассажиров), `cabin` (`economy`|`business`|`first`). - Вызов: `document.modelContext.executeTool('searchFlights', {...})`. - Получение списка: `await document.modelContext.getTools()`. ## Ключевые разделы сайта - Поиск авиабилетов: https://aviaseek.ru/ - Результаты: https://aviaseek.ru/results - Каталог городов: https://aviaseek.ru/cities - Каталог направлений: https://aviaseek.ru/directions - Каталог аэропортов: https://aviaseek.ru/airports - Каталог авиакомпаний: https://aviaseek.ru/airlines - FAQ: https://aviaseek.ru/faq ## Контакты - Главная страница: https://aviaseek.ru/