Home
Login
openbnb-org/mcp-server-airbnb

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アシスタントにシームレスに統合し、ユーザーによりスマートで便利な使用体験を創造する方法を示しています。

個人の旅行者、旅行プランナー、または物件データ分析を必要とする専門家にとって、このツールは価値のある支援を提供し、現代の旅行技術スタックに不可欠なコンポーネントです。