# Rumb.ru — Поиск туров из России

> Rumb.ru — онлайн-агрегатор туров из нескольких городов России и СНГ. Основной регион: Санкт-Петербург (~1300 туров). Также: Москва, Сызрань, Минск. Горящие туры, автобусные, железнодорожные, авиатуры, круизы.

## API для AI-ассистентов

Base URL: `https://rumb.ru/api/mcp/v1/`

### Мультирегиональность

Параметр `departure_from` определяет город вылета. Без него — туры из всех городов.
Получить список доступных городов: `/api/mcp/v1/departure-cities`

### Доступные инструменты

- [Города вылета](/api/mcp/v1/departure-cities) — доступные регионы с количеством туров
- [Поиск туров](/api/mcp/v1/tours?departure_from=St-Petersburg) — фильтры: страна, город, тип тура, транспорт, даты, бюджет
- [Горящие туры](/api/mcp/v1/tours/hot?departure_from=St-Petersburg) — актуальные горящие предложения
- [Подбор по бюджету](/api/mcp/v1/tours/budget?budget=50000&departure_from=St-Petersburg) — туры до указанной суммы
- [Календарь дат](/api/mcp/v1/tours/calendar?departure_from=St-Petersburg) — доступные даты отправления
- [Детали тура](/api/mcp/v1/tours/1) — полная информация о туре
- [Похожие туры](/api/mcp/v1/tours/1/similar) — альтернативные варианты
- [Направления](/api/mcp/v1/destinations?departure_from=St-Petersburg) — страны и города с турами
- [Турфирмы](/api/mcp/v1/agencies?departure_from=St-Petersburg) — список турагентств

### Примеры запросов

Города вылета: `/api/mcp/v1/departure-cities`
Туры из Москвы: `/api/mcp/v1/tours?departure_from=Moscow`
Туры в Турцию из СПб: `/api/mcp/v1/tours?country=Turkey_s&departure_from=St-Petersburg`
Горящие туры: `/api/mcp/v1/tours/hot?departure_from=St-Petersburg`
Туры до 50000₽: `/api/mcp/v1/tours/budget?budget=50000&departure_from=St-Petersburg`
Все туры (все города): `/api/mcp/v1/tours`

### Формат ответа

JSON с полями: `data` (результаты), `meta` (пагинация), `links` (ссылки на сайт).
Каждый тур содержит `web_url` — прямая ссылка на страницу тура для пользователя.

### Rate Limits

60 запросов/мин без ключа. Для повышенного лимита: header `X-MCP-Key`.

### OpenAPI спецификация

[openapi.json](/openapi.json)

## О сайте

- Города вылета: Санкт-Петербург (основной), Москва, Сызрань, Минск
- Валюта: рубли (RUB)
- Язык: русский
- Контакт: info@rumb.ru