Поиск и объявления Airbnb — MCP Bundle (MCPB)

Комплексный пакет MCP для поиска объявлений на Airbnb с расширенными возможностями фильтрации и получения подробной информации об объектах. Создан как сервер протокола контекста модели (MCP), упакованный в формат MCP Bundle (MCPB) для простой установки и использования с совместимыми ИИ-приложениями.

Возможности

🔍 Расширенные возможности поиска

• Поиск по местоположению с поддержкой городов, штатов и регионов

• Поддержка международных локаций через клиентское геокодирование, чтобы запросы вне США (например, «Париж, Франция», «Копенгаген, Дания») возвращали результаты в нужном городе

• Интеграция с Google Maps Place ID для точного выбора местоположения

• Фильтрация по типу жилья: целиком дом, отдельная комната, общая комната или номер в отеле

• Фильтрация по датам с поддержкой дат заезда и выезда

• Конфигурация гостей, включая взрослых, детей, младенцев и домашних животных

• Фильтрация по ценовому диапазону с ограничениями минимальной и максимальной цены

• Поддержка пагинации для просмотра больших наборов результатов

🏠 Подробная информация об объекте

• Полные сведения об объявлении, включая удобства, правила и основные характеристики

• Информация о местоположении с координатами и деталями района

• Правила дома и политики для принятия обоснованных решений о бронировании

• Описание объекта и ключевые особенности

• Прямые ссылки на объявления Airbnb для удобного бронирования

🛡️ Безопасность и соответствие требованиям

• Соблюдение robots.txt с настраиваемым переопределением для тестирования

• Управление тайм-аутом запросов для предотвращения зависания запросов

• Улучшенная обработка ошибок с подробным логированием

• Учет ограничений частоты запросов (rate limiting) и уважительное использование API

• Безопасная конфигурация через пользовательские настройки MCPB

Related MCP server: brasil-api-mcp-server

Установка

Для Claude Desktop

Это расширение упаковано в виде файла MCP Bundle (.mcpb). Для установки:

1. Скачайте файл .mcpb из последнего релиза

2. Откройте файл — Claude Desktop покажет диалоговое окно установки

3. Настройте параметры расширения по мере необходимости

Чтобы игнорировать robots.txt, откройте настройки Claude Desktop, перейдите к расширению и включите переключатель Ignore robots.txt.

Для Cursor и других

Перед началом убедитесь, что на вашем компьютере установлен Node.js для работы npx.

1. Перейдите в: Cursor Settings > Tools & Integrations > New MCP Server

2. Добавьте следующее в ваш mcp.json:

   {
     "mcpServers": {
       "airbnb": {
         "command": "npx",
         "args": [
           "-y",
           "@openbnb/mcp-server-airbnb"
         ]
       }
     }
   }

   Чтобы игнорировать robots.txt для всех запросов, используйте эту версию с аргументами --ignore-robots-txt

   {
     "mcpServers": {
       "airbnb": {
         "command": "npx",
         "args": [
           "-y",
           "@openbnb/mcp-server-airbnb",
           "--ignore-robots-txt"
         ]
       }
     }
   }

3. Перезапустите.

Конфигурация

Расширение предоставляет следующие настраиваемые пользователем параметры:

Ignore robots.txt

• Тип: Логический (флажок)

• По умолчанию: false

• Описание: Обход ограничений robots.txt при выполнении запросов к Airbnb

• Рекомендация: Держите отключенным, если это не требуется для целей тестирования

Disable third-party geocoding

• Тип: Логический (флажок)

• Переменная окружения: DISABLE_GEOCODING

• По умолчанию: false

• Описание: Пропустить этап геокодирования Photon/Nominatim и позволить Airbnb самостоятельно разрешить строку местоположения. Включение этого параметра восстанавливает поведение до PR — каждый поиск идет только на airbnb.com, без сторонних вызовов.

• Рекомендация: Держите отключенным, если вам специально не требуется нулевой сторонний исходящий трафик. При включении этого параметра поиск вне США может возвращать неверные результаты. См. Внешние сервисы.

Инструменты

airbnb_search

Поиск объявлений Airbnb с комплексными параметрами фильтрации.

Параметры:

• location (обязательно): Местоположение для поиска (например, «Сан-Франциско, Калифорния»). Если указано без placeId, сервер выполняет геокодирование этой строки на стороне клиента через Photon/Nominatim — см. Внешние сервисы.

• placeId (опционально): Google Maps Place ID. Переопределяет location и полностью пропускает клиентское геокодирование (никаких сторонних вызовов).

• checkin (опционально): Дата заезда в формате ГГГГ-ММ-ДД

• checkout (опционально): Дата выезда в формате ГГГГ-ММ-ДД

• adults (опционально): Количество взрослых (по умолчанию: 1)

• children (опционально): Количество детей (по умолчанию: 0)

• infants (опционально): Количество младенцев (по умолчанию: 0)

• pets (опционально): Количество домашних животных (по умолчанию: 0)

• minPrice (опционально): Минимальная цена за ночь

• maxPrice (опционально): Максимальная цена за ночь

• cursor (опционально): Курсор пагинации для просмотра результатов

• propertyType (опционально): Фильтр по типу жилья — entire_home, private_room, shared_room или hotel_room

• ignoreRobotsText (опционально): Переопределить robots.txt для этого запроса

Возвращает:

• Результаты поиска с деталями объекта, ценами и прямыми ссылками

• Информацию о пагинации для просмотра дополнительных результатов

• URL поиска для справки

airbnb_listing_details

Получение подробной информации о конкретном объявлении Airbnb.

Параметры:

• id (обязательно): ID объявления Airbnb

• checkin (опционально): Дата заезда в формате ГГГГ-ММ-ДД

• checkout (опционально): Дата выезда в формате ГГГГ-ММ-ДД

• adults (опционально): Количество взрослых (по умолчанию: 1)

• children (опционально): Количество детей (по умолчанию: 0)

• infants (опционально): Количество младенцев (по умолчанию: 0)

• pets (опционально): Количество домашних животных (по умолчанию: 0)

• ignoreRobotsText (опционально): Переопределить robots.txt для этого запроса

Возвращает:

• Подробную информацию об объекте, включая:

  • Детали местоположения с координатами

  • Удобства и оснащение

  • Правила дома и политики

  • Основные характеристики и описания объекта

  • Прямую ссылку на объявление

Технические детали

Архитектура

• Среда выполнения: Node.js 18+

• Протокол: Model Context Protocol (MCP) через транспорт stdio

• Формат: MCP Bundle (MCPB) v0.3

• Зависимости: Минимальные внешние зависимости для безопасности и надежности

Внешние сервисы

Помимо airbnb.com, сервер делает запросы геокодирования к двум сторонним сервисам для преобразования поисковых запросов местоположения в точные ограничивающие рамки (bounding boxes) карты. Это позволяет обойти собственный серверный геокодер Airbnb, который выдает неверные результаты для многих запросов вне США (например, «Париж, Франция» попадает в Вандею; «Копенгаген, Дания» попадает в Висконсин).

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

Отказ от использования: есть два способа пропустить геокодеры:

• Для каждого запроса: укажите явный placeId. Когда placeId присутствует, сервер использует собственный поиск мест Airbnb напрямую без сторонних вызовов.

• Глобально: установите переменную окружения DISABLE_GEOCODING=true. Сервер полностью пропустит Photon/Nominatim и передаст необработанную строку местоположения в Airbnb. Это восстанавливает поведение до PR для каждого поиска и гарантирует нулевой сторонний исходящий трафик — ценой некорректных результатов для локаций вне США, которые неправильно обрабатываются собственным геокодером Airbnb. По умолчанию false.

Если геокодер недоступен или не возвращает результат, сервер переключается на отправку строки местоположения напрямую в Airbnb, точно так же, как это было раньше — поэтому худший случай при сбое заключается в том, что международный поиск деградирует до предыдущего (некорректного) поведения, а не в том, что поиск полностью не удастся.

Обработка ошибок

• Комплексное логирование ошибок с временными метками

• Плавная деградация при изменении структуры страниц Airbnb

• Защита от тайм-аутов для сетевых запросов

• Подробные сообщения об ошибках для устранения неполадок

Меры безопасности

• Соблюдение robots.txt по умолчанию

• Ограничения тайм-аута запросов

• Валидация и очистка входных данных

• Безопасная обработка переменных окружения

• Отсутствие хранения конфиденциальных данных

Производительность

• Эффективный парсинг HTML с помощью Cheerio

• Кэширование запросов там, где это уместно

• Минимальное потребление памяти

• Быстрый запуск и время отклика

Совместимость

• Платформы: macOS, Windows, Linux

• Node.js: 18.0.0 или выше

• Claude Desktop: 0.10.0 или выше

• Другие клиенты MCP: Совместим с любым приложением, поддерживающим MCP

Разработка

Сборка из исходного кода

# Install dependencies
npm install

# Build the project
npm run build

# Watch for changes during development
npm run watch

Тестирование

Расширение можно протестировать, запустив сервер MCP напрямую:

# Run with robots.txt compliance (default)
node dist/index.js

# Run with robots.txt ignored (for testing)
node dist/index.js --ignore-robots-txt

Юридические и этические соображения

• Уважение к Условиям использования Airbnb: Это расширение предназначено для законных исследований и помощи в бронировании

• Соблюдение robots.txt: Расширение соблюдает robots.txt по умолчанию

• Ограничение частоты запросов: Помните о частоте запросов, чтобы не перегружать серверы Airbnb

• Использование данных: Извлекайте только общедоступную информацию для законных целей

Поддержка

• Проблемы: Сообщайте об ошибках и запросах функций в GitHub Issues

• Документация: Дополнительная документация доступна в репозитории

• Сообщество: Присоединяйтесь к обсуждениям разработки MCP и MCPB

Лицензия

Лицензия MIT — подробности см. в файле LICENSE.

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

Вклад приветствуется! Пожалуйста, ознакомьтесь с рекомендациями по участию и отправляйте пулл-реквесты с любыми улучшениями.

Примечание: Это расширение не связано с Airbnb, Inc. Это независимый инструмент, разработанный для помощи пользователям в поиске и анализе общедоступных объявлений Airbnb.