Home
Login
openbnb-org/mcp-server-airbnb

에어비앤비 숙소를 검색하고 상세 정보를 가져오는 데 사용되는 MCP 서버

MITJavaScript 194openbnb-org Last Updated: 2025-04-24
https://github.com/openbnb-org/mcp-server-airbnb

MCP 서버 Airbnb 프로젝트 상세 소개

프로젝트 개요

MCP 서버 Airbnb는 Claude Desktop 사용자를 위해 특별히 설계된 MCP(Model Context Protocol) 서버로, 강력한 Airbnb 숙소 검색 및 상세 정보 조회 기능을 제공합니다. 이 프로젝트는 OpenBnB 조직에서 개발되었으며, MIT 오픈 소스 라이선스를 채택하여 사용자가 Claude 스마트 어시스턴트를 통해 직접 Airbnb 숙소 정보를 검색하고 얻을 수 있도록 하여 여행 계획 과정을 크게 간소화합니다.

핵심 기능 특징

🔍 숙소 검색 기능 (airbnb_search)

주요 용도: 지정된 조건에 따라 Airbnb 숙소 목록 검색

필수 매개변수:

  • location (문자열) - 검색 장소

선택적 매개변수:

  • placeId (문자열) - 장소 ID, 정확한 위치 지정에 사용
  • checkin (문자열) - 체크인 날짜, 형식: YYYY-MM-DD
  • checkout (문자열) - 체크아웃 날짜, 형식: YYYY-MM-DD
  • adults (숫자) - 성인 수
  • children (숫자) - 어린이 수
  • infants (숫자) - 유아 수
  • pets (숫자) - 반려동물 수
  • minPrice (숫자) - 최소 가격 필터
  • maxPrice (숫자) - 최대 가격 필터
  • cursor (문자열) - 페이지네이션 커서
  • ignoreRobotsText (불리언 값) - robots.txt 규칙 무시 여부

반환 결과: 숙소 이름, 가격, 위치 등 상세 정보가 포함된 숙소 배열

🏠 숙소 상세 정보 조회 (airbnb_listing_details)

주요 용도: 지정된 숙소의 상세 정보 획득

필수 매개변수:

  • id (문자열) - 숙소 고유 식별자

선택적 매개변수:

  • checkin (문자열) - 체크인 날짜, 형식: YYYY-MM-DD
  • checkout (문자열) - 체크아웃 날짜, 형식: YYYY-MM-DD
  • adults (숫자) - 성인 수
  • children (숫자) - 어린이 수
  • infants (숫자) - 유아 수
  • pets (숫자) - 반려동물 수
  • ignoreRobotsText (불리언 값) - robots.txt 규칙 무시 여부

반환 결과: 숙소 설명, 호스트 정보, 편의 시설 목록, 가격 정보 등 상세한 숙소 정보

기술 특징

🛡️ 규정 준수 설계

  • robots.txt 규칙 준수: 기본적으로 Airbnb의 robots.txt 규정을 엄격히 준수
  • 선택적 무시 모드: 특수한 요구 사항을 위해 --ignore-robots-txt 매개변수 제공

🔧 기술 구현

  • HTML 파싱: Cheerio 라이브러리를 사용하여 효율적인 HTML 콘텐츠 파싱
  • API 키 불필요: 공식 API 신청 없이 웹 페이지 크롤링을 통해 데이터 획득
  • 구조화된 데이터: 표준화된 JSON 형식 데이터 반환
  • 성능 최적화: 데이터 평탄화 및 필터링을 통해 컨텍스트 부하 감소

📦 쉬운 배포

  • NPX 지원: npx를 통해 직접 실행 가능, 로컬 설치 불필요
  • 원클릭 설치: Smithery 도구를 통해 자동 설치 및 구성 지원

설치 구성

전제 조건

시스템에 Node.js가 설치되어 있는지 확인하십시오.

Claude Desktop 구성

  1. 설정 진입: Settings > Developer > Edit Config

  2. 기본 구성 (robots.txt 준수):

{
  "mcpServers": {
    "airbnb": {
      "command": "npx",
      "args": [
        "-y",
        "@openbnb/mcp-server-airbnb"
      ]
    }
  }
}
  1. robots.txt 무시 구성:
{
  "mcpServers": {
    "airbnb": {
      "command": "npx",
      "args": [
        "-y",
        "@openbnb/mcp-server-airbnb",
        "--ignore-robots-txt"
      ]
    }
  }
}
  1. Claude Desktop 재시작으로 구성 완료

자동 설치 (Smithery)

npx -y @smithery/cli install @openbnb-org/mcp-server-airbnb --client claude

개발 환경 구성

npm install
npm run build

사용 시나리오

🌍 여행 계획

  • 목적지의 사용 가능한 숙소 빠르게 검색
  • 다른 날짜의 가격 차이 비교
  • 예산에 맞춰 적합한 숙소 필터링

🏡 숙소 분석

  • 숙소의 상세 편의 시설 정보 획득
  • 호스트의 평가 및 이력 파악
  • 숙소의 가격 책정 전략 분석

🤖 스마트 어시스턴트 통합

  • Claude와 원활하게 통합되어 자연어 상호 작용 제공
  • 자동화된 데이터 처리 및 분석
  • 수동 검색 시간 비용 절감

프로젝트 장점

✅ 무료 오픈 소스

  • MIT 라이선스, 완전 오픈 소스 무료
  • 커뮤니티 주도의 지속적인 개선
  • 사용 제한 및 숨겨진 비용 없음

✅ 쉬운 사용

  • 복잡한 API 인증 절차 불필요
  • 간단한 구성으로 사용 시작 가능
  • Claude Desktop과 기본적으로 통합

✅ 완전한 기능

  • 복잡한 검색 조건 조합 지원
  • 상세한 숙소 정보 제공
  • 유연한 매개변수 구성 옵션

✅ 기술적 신뢰성

  • 성숙한 웹 페이지 파싱 기술 기반
  • 구조화된 데이터 반환 형식
  • 우수한 오류 처리 메커니즘

법적 고지

본 프로젝트는 MIT 라이선스에 따라 사용이 허가됩니다. 다음 사항에 유의하십시오.

  • Airbnb는 Airbnb, Inc.의 등록 상표입니다.
  • OpenBnB는 Airbnb, Inc. 및 그 자회사와 어떠한 관련도 없습니다.
  • 본 도구를 사용할 때는 관련 법규 및 웹사이트 사용 약관을 준수하십시오.

결론

MCP 서버 Airbnb는 강력하고 사용하기 쉬운 오픈 소스 도구로, Claude Desktop 사용자에게 편리한 Airbnb 숙소 검색 및 조회 기능을 제공합니다. 간단한 구성을 통해 사용자는 Claude에서 직접 숙소를 검색하고 상세한 숙소 정보를 얻을 수 있어 여행 계획 효율성을 크게 향상시킬 수 있습니다.

이 프로젝트는 현대 소프트웨어 개발에서 MCP 프로토콜의 강력한 잠재력을 보여주며, 표준화된 인터페이스를 통해 외부 서비스를 AI 어시스턴트에 원활하게 통합하여 사용자에게 더욱 스마트하고 편리한 사용 경험을 제공하는 방법을 보여줍니다.

개인 여행자, 여행 플래너, 숙소 데이터 분석이 필요한 전문가 모두에게 가치 있는 도움을 제공할 수 있는 현대 여행 기술 스택에서 없어서는 안 될 구성 요소입니다.