Booking.com MCP Server

Хостируемый сервер Model Context Protocol (MCP), который предоставляет Claude, Cursor, Windsurf и любому другому MCP-клиенту два инструмента Booking.com только для чтения. Поиск вариантов размещения по направлению и датам с богатыми фильтрами и полное чтение отдельного объекта — всё в виде структурированного JSON, без аккаунта Booking.com и без необходимости что-либо хостить.

Он читает публичные страницы объектов на Booking.com, которые видит посетитель без входа в аккаунт.

https://mcp.hasdata.com/api/mcp?apis=booking

Содержание

• Что нужно

• Быстрый старт

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

• Инструменты

• Ошибки и сбои

• Цены, бесплатный тариф и лимиты

• Выбор инструмента

• Сравнение с аналогами

• FAQ

• Ссылки HasData

• Разработка

• Участие в разработке

• Лицензия

Related MCP server: Hotels MCP Server

Что нужно

Нужны MCP-клиент и ключ API HasData из дашборда, который создаётся бесплатно без карты, а пробный период покрывает 100 вызовов по тарифу 10 кредитов. Это удалённый сервер, поэтому самый простой путь — URL и заголовок x-api-key: не нужно запускать контейнер, и аккаунт Booking.com нигде в процессе не участвует. Клиент, который умеет только stdio, подключается к нему через тонкий лаунчер, опубликованный как @hasdata/booking-mcp на npm и hasdata-booking-mcp на PyPI, как показано ниже.

Быстрый старт

URL сервера одинаков для всех клиентов. Мы используем его напрямую в Claude Code и Claude Desktop. Остальные блоки следуют документированному формату каждого клиента для удалённого сервера.

Клиенты с поддержкой OAuth могут добавить тот же URL как коннектор и войти, не помещая ключ в конфигурационный файл.

claude mcp add --transport http booking "https://mcp.hasdata.com/api/mcp?apis=booking" \
  --header "x-api-key: HASDATA_API_KEY"

Настройки, затем Connectors, затем Add custom connector, затем вставьте https://mcp.hasdata.com/api/mcp?apis=booking и войдите.

При использовании конфигурационного файла Claude Desktop загружает только локальные (stdio) серверы, поэтому он обращается к удалённому серверу через stdio-лаунчер. Пакет @hasdata/booking-mcp и есть этот лаунчер; он читает ключ из окружения. Добавьте это в claude_desktop_config.json:

{
  "mcpServers": {
    "booking": {
      "command": "npx",
      "args": ["-y", "@hasdata/booking-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Для Python вместо Node замените лаунчер пакетом PyPI, который uvx запускает без ручной установки:

{
  "mcpServers": {
    "booking": {
      "command": "uvx",
      "args": ["hasdata-booking-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

~/.cursor/mcp.json — для каждого проекта, или .cursor/mcp.json — для одного:

{
  "mcpServers": {
    "booking": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=booking",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json. Windsurf использует поле serverUrl, а не url:

{
  "mcpServers": {
    "booking": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=booking",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

.vscode/mcp.json в рабочей области:

{
  "servers": {
    "booking": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=booking",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

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

Это запросы, а не код. Вставьте один — и агент сам выберет инструмент. Каждый помечен количеством вызовов: каждый успешный вызов стоит 10 кредитов.

Найди на Booking.com отели в Париже с 15 по 18 сентября для двух взрослых и покажи десять лучших по отзывам с ценой до $700 за проживание.

Один вызов, 10 кредитов. Цена, оценка по отзывам и местоположение возвращаются в результате поиска.

Возьми верхний результат и получи его полные детали: удобства, правила дома, варианты номеров и оценки по категориям.

Один вызов, 10 кредитов. Они находятся на странице объекта, которую инструмент деталей читает по URL и датам.

Найди четырёхзвёздочные отели в Париже с бесплатной отменой недалеко от центра и выведи цену и оценку по отзывам.

Один вызов, 10 кредитов. Звёздный рейтинг, условия отмены и расстояние — это фильтры в одном запросе.

Сравни самое дешёвое проживание в Париже и Риме на одни и те же даты.

Два вызова, 20 кредитов: по одному поиску на город.

Инструменту объекта нужны те же даты и количество гостей, что и поиску, потому что наличие и цена зависят от периода. Поиск для короткого списка плюс вызов деталей по трём объектам — это один поиск и три вызова объекта.

Инструменты

Два инструмента, только для чтения. Примеры ниже сокращены из реальных вызовов, а цены постоянно меняются. Воспринимайте их как структуру. Каждое имя инструмента ведёт на справочник endpoint'а с полным списком полей.

Примеры — это полезная нагрузка, а не весь ответ. Результат tools/call содержит один текстовый блок, и этот текст сам является JSON с полями url, status, text и json; данные, полученные со страницы, лежат в json. В сыром JSON-RPC ответе путь — result.content[0].text, затем парсинг и .json. Чат-клиент разворачивает это за вас, а код, работающий с endpoint'ом напрямую, — нет.

Получение результатов поиска Booking.com

hasdata_booking_search_getBookingSearchResults

Страница вариантов размещения по направлению и датам.

В справочнике описан полный набор фильтров, включая расстояние, питание, доступность, предпочтения по кровати и группу путешествующих.

Возвращает searchInformation, массив results и pagination с page, totalResults и totalPages. Каждый результат содержит hotelId, title, url, предлагаемые room и bedTypes, объект location, объект policies, объект price, звёздный rating, объект reviews с score, count и текстовой меткой, а также photo.

Поле скидки в price пишется как dicsount (dicsountRaw и dicsountParsed) — это зеркалит ключ вышестоящего источника. Читайте именно такое написание, а не discount. Также обратите внимание: rating — это официальный звёздный рейтинг, а reviews.score — оценка гостей из 10, это два разных числа.

{
  "hotelId": 50724,
  "title": "Hôtel du Jardin des Plantes",
  "url": "https://www.booking.com/hotel/fr/timjardindesplantes.html",
  "room": "Comfort Double Room",
  "location": { "city": "Paris", "address": "5 rue Linné", "mainDistance": "0.9 miles from downtown", "centrallyLocated": true },
  "policies": { "freeCancellation": true, "noPrepayment": true },
  "price": { "pricePerStayParsed": 451.36, "priceBeforeDiscountParsed": 885.03, "dicsountParsed": 433.66, "currency": "USD" },
  "rating": 3,
  "reviews": { "score": 7.5, "count": 1721, "text": "Good" }
}

Получение деталей объекта Booking.com

hasdata_booking_place_getBookingPlaceDetails

Один объект полностью — по его URL и периоду проживания.

Возвращает страницу в виде разделов, а не одного плоского объекта: overview (id, title, propertyType, структурированный address, description, highlights, mostPopularFacilities и photos), bookingDetails (период и валюта, в которых указаны цены), массив rooms доступных номеров, каждый с name, beds, facilities и вариантами variants с ценами, список facilities, houseRules, массив ratings с оценками по категориям, reviews и questionsAndAnswers.

{
  "overview": {
    "id": "50724",
    "title": "Hôtel du Jardin des Plantes",
    "propertyType": "HOTEL",
    "address": { "country": "France", "zipcode": "75005" },
    "mostPopularFacilities": ["Non-smoking rooms", "Free Wifi", "24-hour front desk"]
  },
  "bookingDetails": { "checkIn": "2026-09-15", "checkOut": "2026-09-18", "adults": 2, "rooms": 1, "currency": "USD" },
  "ratings": [
    { "label": "Average", "value": 7.5, "votes": 1721 },
    { "label": "Cleanliness", "value": 7.8 }
  ]
}

Ошибки и сбои

Ваш клиент почти никогда не видит HTTP-код ошибки от вызова инструмента. Слой MCP отвечает 200 и помещает сбой внутрь результата, с isError установленным в true и причиной в виде текста. Агент читает сообщение там, где вы могли бы ожидать строку статуса.

Неверный ключ проявляется как вывод инструмента, а не как сбой подключения. tools/list принимает любой непустой ключ и возвращает оба инструмента, поэтому клиент завершает рукопожатие и показывает зелёный статус. Первый вызов инструмента затем возвращается с isError: true и текстом HasData API error: 401 Unauthorized. Следите за этой строкой, потому что ничто ранее в процессе не сообщает о проблеме.

Отсутствующий ключ — единственная настоящая HTTP-ошибка. Авторизация выполняется до любого инструмента, и само подключение завершается ошибкой 401. Заголовки CORS присутствуют, поэтому браузерный клиент видит статус, а не непрозрачный сетевой сбой.

Аргумент, нарушающий схему инструмента, отклоняется до того, как начнётся сбор данных. Сервер отвечает с isError: true и текстом MCP error -32602: Input validation error, называя проблемное поле. Количество children без соответствующего childrenAges или выезд раньше или в день заезда отлавливаются здесь.

Поиск без доступных вариантов возвращает успешный результат с пустым массивом results, а не ошибку. Направление и период без свободных мест всё равно возвращаются с requestMetadata.status равным ok. Проверяйте длину массива перед перебором.

URL объекта, который больше не открывается, возвращает 400 с requestMetadata.status равным error.

Результаты, которые содержат данные, также содержат requestMetadata.id, который стоит указывать в обращении в поддержку.

Цены, бесплатный тариф и лимиты

Каждый инструмент Booking.com стоит 10 кредитов за успешный вызов. Размер ответа не меняет цену. Страница поиска с 25 вариантами размещения стоит столько же, сколько страница с двумя.

Бесплатный пробный период — 1 000 кредитов на 30 дней без карты, то есть 100 вызовов Booking.com. После этого активный аккаунт продолжает получать по 100 кредитов ежедневно, когда его баланс опускается ниже 100, так что агент с низким объёмом запросов работает на бесплатном тарифе бессрочно.

Платные тарифы начинаются от $49 в месяц за 200 000 кредитов, то есть 20 000 вызовов. Цена за единицу снижается с объёмом: от $2,45 за 1 000 вызовов на начальном тарифе до $0,99 на Business, $0,83 на Growth и $0,75 на крупнейших тарифах для больших объёмов.

Ваш тариф также определяет уровень параллелизма. Бесплатный пробный период допускает 1 запрос за раз, Startup — 15, Business — 30, Growth — 50, а тарифы для больших объёмов — от 200 до 1 500. В любом автоматическом процессе защитно обрабатывайте случай превышения лимита.

Запрос, вернувшийся с кодом не 200, не тарифицируется. Успешный вызов, который ничего не нашёл, всё равно считается вызовом.

Выбор инструментов

Параметр запроса apis определяет, какие инструменты видит ваш агент. Меньше инструментов — меньше контекста тратится на описания инструментов и меньше шансов, что модель потянется не к тому.

?apis=booking                    the two tools in this repo
?apis=booking,airbnb             add Airbnb stays
?apis=booking,google_travel      add Google Hotels and Flights

Параметр принимает имена провайдеров, такие как booking, и отдельные имена API, такие как booking_search. Имена с опечатками игнорируются. Если все имена неверны, запрос завершается ошибкой 400, и в теле ответа перечисляются и то, что не удалось распознать, и все допустимые значения. Уберите параметр — и тот же эндпоинт откроет все 57 инструментов HasData.

Сравнение

Собственные программы Booking.com — Demand API и аффилиатская партнёрская сеть — предназначены для одобренных партнёров, которые отправляют бронирования и получают комиссию, а не для самостоятельного чтения публичного рынка. Для поиска вариантов размещения и просмотра произвольных объектов правильный путь — парсинг публичных страниц, и этот сервер делает это, предоставляя стабильную схему данных.

Чего этот сервер не делает. Никаких бронирований, никаких платежей, никаких партнёрских комиссий, никаких данных аккаунта. Он читает то, что видит посетитель без входа на Booking.com.

FAQ

Существует ли официальный MCP-сервер Booking.com?

Booking.com не публикует такой сервер. Этот сервер поддерживается HasData и читает публичные страницы, поэтому ему не нужен аккаунт Booking.com.

Что такое MCP-сервер Booking.com?

Это сервер, который предоставляет данные Booking.com в виде инструментов, которые может вызывать ИИ-клиент. Клиент отправляет вызов инструмента по протоколу Model Context Protocol, сервер получает данные и возвращает структурированный JSON, а модель работает с результатом. Этот сервер предоставляет два инструмента и работает удалённо.

Нужен ли мне аккаунт Booking.com или одобрение партнёра?

Нет. Единственное, что нужно, — ваш ключ HasData. Никакого партнёрского онбординга нет, потому что инструменты читают публичные страницы Booking.com.

Почему инструменту для объектов нужны даты?

Потому что наличие, варианты номеров и цена зависят от периода проживания. Передайте те же checkInDate, checkOutDate и количество гостей, с которыми вы искали, и детали будут соответствовать этому периоду.

В чём разница между рейтингом и оценкой отзывов?

rating — это официальный звёздный рейтинг объекта. reviews.score — это оценка гостей по десятибалльной шкале. Трёхзвёздочный отель может иметь гостевую оценку 9.0, так что читайте ту, которую имеете в виду.

Можно ли использовать это вместе с другими API HasData?

Да. Параметр apis принимает список, и ?apis=booking,airbnb даёт вашему агенту Booking.com плюс Airbnb. Уберите параметр — и вы получите всё.

Связана ли HasData с Booking.com?

Нет. HasData — независимый сервис и не связан с Booking.com, не одобрен им и не спонсируется им. Booking.com является товарным знаком своего владельца.

Соответствие требованиям и персональные данные

HasData получает доступ только к общедоступным данным. Условия платформы могут ограничивать автоматический доступ, и вы несёте ответственность за собственное соответствие требованиям. Если собираемые вами данные включают персональную информацию, убедитесь, что у вас есть законное основание для её обработки в соответствии с GDPR, CCPA или эквивалентными правилами в вашей юрисдикции.

Ссылки HasData

Разработка

Этот репозиторий — конфигурация и документация для удалённого сервера. Здесь нет шага сборки и нечего контейнеризировать.

Тесты в test/ проверяют контракт инструментов — ту часть, которая может сломаться без коммита здесь. Они проверяют, что ?apis=booking возвращает ровно два инструмента, что каждый инструмент по-прежнему объявляет свои обязательные параметры, что ни одно имя не изменилось и что используемый ключ действительно принимается. Последняя проверка реально вызывает инструмент и стоит 10 кредитов — это цена канарейки, которая может упасть по правильной причине.

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

Тот же набор тестов запускается в CI при каждом пуше и раз в неделю по расписанию, потому что список инструментов на стороне API может измениться без изменений в этом репозитории. Сбой означает, что список инструментов сдвинулся, ключ перестал работать или эндпоинт был недоступен, и сообщение проверки говорит, что именно.

Участие в разработке

Самый полезный вклад — исправления в таблицах инструментов и примерах ответов, потому что именно эти части расходятся с реальностью. Приложите выполненный вызов и полученный ответ. Пул-реквесты из форков запускают набор тестов без ключа, а живые проверки пропускаются вместо того, чтобы падать.

Лицензия

MIT. См. LICENSE.