MCP-сервер Airbnb

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

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

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

Содержание

• Что нужно

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

• Примеры промптов

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

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

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

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

• Сравнение

• FAQ

• Ссылки HasData

• Разработка

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

• Лицензия

Related MCP server: lilo-vacation-rentals

Что нужно

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

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

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

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

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

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

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

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

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

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

~/.cursor/mcp.json для всех проектов или .cursor/mcp.json для одного:

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

~/.codeium/windsurf/mcp_config.json. Windsurf называет поле serverUrl, а не url:

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

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

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

Примеры промптов

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

Найди жильё в Остине для двух взрослых с 15 по 18 сентября и покажи десять самых рейтинговых вариантов дешевле $200 за ночь.

Один вызов, 5 кредитов. Рейтинг и цена за ночь возвращаются в результате поиска.

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

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

Сравни цену за ночь при трёхдневном проживании для двух гостей в Остине и Нашвилле.

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

Для этого URL объявления скажи, сколько там спален и ванных комнат и является ли хозяин суперхозяином.

Один вызов, 5 кредитов.

Результат поиска намеренно лёгкий: достаточно, чтобы ранжировать и составить шорт-лист. Удобства, кровати, хозяин и полное описание приходят из вызова property, поэтому промпт, который составляет шорт-лист, а затем изучает три жилья, — это один поиск плюс три вызова property.

Инструменты

Два инструмента, только для чтения. Примеры ниже урезаны из реальных вызовов, и цифры меняются по мере обновления Airbnb. Читайте их как формы. Имя каждого инструмента ведёт на справочник конечной точки с полным списком полей.

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

Поиск объявлений Airbnb

hasdata_airbnb_listing_getAirbnbListings

Страница результатов поиска по локации и датам.

Возвращает массив properties и объект pagination, чьи nextPageToken и pageTokens позволяют пройти по всему набору результатов. Каждый объект property содержит id, url, title, latitude, longitude, короткий description-теглайн, массив photos, rating, reviews, массив badges, например Guest favorite или Superhost, и объект price. В price хранятся originalPrice, опциональный discountedPrice, когда проживание со скидкой, qualifier вроде for 3 nights и breakdown.

Результат поиска намеренно лёгкий. Кроватей, ванных комнат, удобств, хозяина и полного описания здесь нет — они приходят из инструмента property ниже. Не ждите количества спален в результате поиска.

{
  "id": "17545365",
  "url": "https://www.airbnb.com/rooms/17545365",
  "title": "Home in East Austin",
  "latitude": 30.25741,
  "longitude": -97.73366,
  "description": "Downtown Casa - neighborhood feel, close to it all",
  "rating": 4.87,
  "reviews": 601,
  "badges": ["Guest favorite"],
  "price": {
    "originalPrice": "$607",
    "discountedPrice": "$447",
    "qualifier": "for 3 nights",
    "breakdown": [{ "description": "3 nights x $149.00", "price": "$447.00" }]
  }
}

Детали объекта Airbnb

hasdata_airbnb_property_getAirbnbPropertyDetails

Одно объявление полностью, по его URL.

Возвращает title, массив overview вроде ["4 guests", "2 bedrooms", "2 beds", "2 baths"], полное description, rating, reviews, address, latitude, longitude, массив photos, guestCapacity, объект host, массив amenities и safetyAndPropertyInfo. Объект host содержит name, isSuperhost, isVerified, собственные reviews хозяина, rating и yearsHosting. Каждое удобство несёт title, type, опциональное description и флаг available, поэтому фильтр читает available и не предполагает, что каждое перечисленное удобство присутствует.

{
  "id": "17545365",
  "title": "Downtown Casa - neighborhood feel, close to it all",
  "overview": ["4 guests", "2 bedrooms", "2 beds", "2 baths"],
  "rating": 4.87,
  "reviews": 601,
  "address": "Austin, Texas, United States",
  "guestCapacity": 4,
  "host": { "name": "Deanna", "isSuperhost": true, "isVerified": true, "reviews": 1273, "rating": 4.86, "yearsHosting": 11 },
  "amenities": [
    { "title": "Wifi", "type": "SYSTEM_WI_FI", "available": true },
    { "title": "Free washer – In unit", "type": "SYSTEM_WASHER", "available": true }
  ]
}

Ошибки и сбои

Ваш клиент почти никогда не увидит 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, указывая поле-нарушитель. Ничего не загружается и не списывается.

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

Удалённое объявление возвращает 400 с requestMetadata.status, установленным в error. URL из старого поиска может указывать на жильё, которого больше нет.

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

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

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

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

Платные тарифы начинаются с $49 в месяц за 200 000 кредитов, то есть 40 000 вызовов. Цена за единицу падает с объёмом: от $1.23 за 1 000 вызовов на начальном тарифе до $0.50 на Business, $0.42 на Growth и $0.37 на крупнейших тарифах для высоких объёмов.

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

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

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

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

?apis=airbnb                     the two tools in this repo
?apis=airbnb,booking             add Booking.com stays
?apis=airbnb,google_maps         add Google Maps places

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

Как это соотносится

У Airbnb нет публичного API поиска. Его API-программа — это интеграция для партнёров и совладельцев объявлений, предназначенная для управления собственными объявлениями, а не для чтения рынка. Для поиска жилья и чтения произвольных объявлений единственный путь — парсинг публичных страниц, и этот сервер делает это за стабильной схемой.

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

FAQ

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

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

Что такое Airbnb MCP сервер?

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

Нужен ли мне API-ключ Airbnb или партнёрский аккаунт?

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

Почему в результатах поиска не показываются кровати или удобства?

Потому что Airbnb не выводит их на карточке поиска. Они находятся на странице объекта, которую инструмент деталей читает по URL. Используйте поиск для составления шорт-листа, затем вызывайте инструмент объекта для получения подробной информации.

Можно ли фильтровать по гостям, животным или датам?

Да. Инструмент listings принимает checkIn, checkOut и количества adults, children, infants и pets, и возвращает наличие и цены для этой компании и периода.

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

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

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

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

Ссылки HasData

Разработка

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

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

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

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

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

Участие

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

Лицензия

MIT. См. LICENSE.