Airbnb 検索 & リスティング デスクトップ拡張 (dxt)
概要
mcp-server-airbnbとは？
mcp-server-airbnbは、組織### openbnb-orgによってGitHubにホストされている公開リポジトリです。このプロジェクトは、Airbnbのような機能を実現するために設計されたサーバーサイドの実装であり、開発者がレンタルリスティングを作成・管理し、予約を処理し、ホストとゲストの両方のユーザー体験を向上させるさまざまな機能を統合できるようにします。
mcp-server-airbnbの特徴
- ユーザー管理: システムは、ホストとゲストを含むユーザーアカウントの作成と管理を可能にします。
- リスティング管理: ユーザーは、詳細な説明、画像、価格を含む物件リスティングを作成、更新、削除できます。
- 予約システム: サーバーは予約リクエスト、空き状況の確認、支払い処理を処理します。
- 通知: ユーザーは、予約確認、キャンセル、その他の重要な更新に関する通知を受け取ります。
- API統合: サーバーは、支払いゲートウェイや地図サービスなど、機能を強化するためにさまざまなAPIと統合できます。
mcp-server-airbnbの使い方
-
リポジトリをクローンする: まず、次のコマンドを使用してリポジトリをローカルマシンにクローンします。
git clone https://github.com/openbnb-org/mcp-server-airbnb.git -
依存関係をインストールする: プロジェクトディレクトリに移動し、必要な依存関係をインストールします。通常、次のコマンドを実行します。
npm install -
設定: データベース接続やAPIキーを含む、セットアップに必要な環境変数を設定します。
-
サーバーを実行する: 次のコマンドを使用してサーバーを起動します。
npm start -
APIにアクセスする: PostmanやcURLなどのツールを使用して、サーバーが提供するAPIエンドポイントと対話します。
よくある質問
mcp-server-airbnbで使用されている技術は何ですか？
mcp-server-airbnbプロジェクトは、サーバーサイドのロジックにNode.js、ルーティングにExpress.js、データベース管理にMongoDBを使用して構築されています。
プロジェクトに貢献するにはどうすればよいですか？
貢献は歓迎されます！リポジトリをフォークし、変更を加え、レビューのためにプルリクエストを提出できます。リポジトリに記載されている貢献ガイドラインに従うことを確認してください。
ドキュメントはありますか？
はい、リポジトリにはプロジェクトの概要、セットアップ手順、APIドキュメントを提供するREADMEファイルが含まれています。追加のドキュメントはdocsフォルダーにあるかもしれません。
問題やバグを報告するにはどうすればよいですか？
問題やバグに遭遇した場合は、GitHubリポジトリでイシューを開いてください。問題の詳細な説明、再現手順、関連するスクリーンショットやログを提供してください。
mcp-server-airbnbを商業目的で使用できますか？
このプロジェクトはMITライセンスの下でライセンスされており、個人使用と商業使用の両方が許可されています。ただし、コンプライアンスを確保するためにライセンス条項を確認することをお勧めします。
詳細
Airbnb Search & Listings - Desktop Extension (DXT)
A comprehensive Desktop Extension for searching Airbnb listings with advanced filtering capabilities and detailed property information retrieval. Built as a Model Context Protocol (MCP) server packaged in the Desktop Extension (DXT) format for easy installation and use with compatible AI applications.
Features
🔍 Advanced Search Capabilities
- Location-based search with support for cities, states, and regions
- Google Maps Place ID integration for precise location targeting
- Date filtering with check-in and check-out date support
- Guest configuration including adults, children, infants, and pets
- Price range filtering with minimum and maximum price constraints
- Pagination support for browsing through large result sets
🏠 Detailed Property Information
- Comprehensive listing details including amenities, policies, and highlights
- Location information with coordinates and neighborhood details
- House rules and policies for informed booking decisions
- Property descriptions and key features
- Direct links to Airbnb listings for easy booking
🛡️ Security & Compliance
- Robots.txt compliance with configurable override for testing
- Request timeout management to prevent hanging requests
- Enhanced error handling with detailed logging
- Rate limiting awareness and respectful API usage
- Secure configuration through DXT user settings
Installation
For Claude Desktop
This extension is packaged as a Desktop Extension (DXT) file. To install:
- Download the
.dxtfile from the releases page - Open your compatible AI application (e.g., Claude Desktop)
- Install the extension through the application's extension manager
- Configure the extension settings as needed
For Cursor, etc.
Before starting make sure Node.js is installed on your desktop for npx to work.
-
Go to: Cursor Settings > Tools & Integrations > New MCP Server
-
Add one the following to your
mcp.json:{ "mcpServers": { "airbnb": { "command": "npx", "args": [ "-y", "@openbnb/mcp-server-airbnb" ] } } }To ignore robots.txt for all requests, use this version with
--ignore-robots-txtargs{ "mcpServers": { "airbnb": { "command": "npx", "args": [ "-y", "@openbnb/mcp-server-airbnb", "--ignore-robots-txt" ] } } } -
Restart.
Configuration
The extension provides the following user-configurable options:
Ignore robots.txt
- Type: Boolean (checkbox)
- Default:
false - Description: Bypass robots.txt restrictions when making requests to Airbnb
- Recommendation: Keep disabled unless needed for testing purposes
Tools
airbnb_search
Search for Airbnb listings with comprehensive filtering options.
Parameters:
location(required): Location to search (e.g., "San Francisco, CA")placeId(optional): Google Maps Place ID (overrides location)checkin(optional): Check-in date in YYYY-MM-DD formatcheckout(optional): Check-out date in YYYY-MM-DD formatadults(optional): Number of adults (default: 1)children(optional): Number of children (default: 0)infants(optional): Number of infants (default: 0)pets(optional): Number of pets (default: 0)minPrice(optional): Minimum price per nightmaxPrice(optional): Maximum price per nightcursor(optional): Pagination cursor for browsing resultsignoreRobotsText(optional): Override robots.txt for this request
Returns:
- Search results with property details, pricing, and direct links
- Pagination information for browsing additional results
- Search URL for reference
airbnb_listing_details
Get detailed information about a specific Airbnb listing.
Parameters:
id(required): Airbnb listing IDcheckin(optional): Check-in date in YYYY-MM-DD formatcheckout(optional): Check-out date in YYYY-MM-DD formatadults(optional): Number of adults (default: 1)children(optional): Number of children (default: 0)infants(optional): Number of infants (default: 0)pets(optional): Number of pets (default: 0)ignoreRobotsText(optional): Override robots.txt for this request
Returns:
- Detailed property information including:
- Location details with coordinates
- Amenities and facilities
- House rules and policies
- Property highlights and descriptions
- Direct link to the listing
Technical Details
Architecture
- Runtime: Node.js 18+
- Protocol: Model Context Protocol (MCP) via stdio transport
- Format: Desktop Extension (DXT) v0.1
- Dependencies: Minimal external dependencies for security and reliability
Error Handling
- Comprehensive error logging with timestamps
- Graceful degradation when Airbnb's page structure changes
- Timeout protection for network requests
- Detailed error messages for troubleshooting
Security Measures
- Robots.txt compliance by default
- Request timeout limits
- Input validation and sanitization
- Secure environment variable handling
- No sensitive data storage
Performance
- Efficient HTML parsing with Cheerio
- Request caching where appropriate
- Minimal memory footprint
- Fast startup and response times
Compatibility
- Platforms: macOS, Windows, Linux
- Node.js: 18.0.0 or higher
- Claude Desktop: 0.10.0 or higher
- Other MCP clients: Compatible with any MCP-supporting application
Development
Building from Source
### Install dependencies
npm install
### Build the project
npm run build
### Watch for changes during development
npm run watch
Testing
The extension can be tested by running the MCP server directly:
### Run with robots.txt compliance (default)
node dist/index.js
### Run with robots.txt ignored (for testing)
node dist/index.js --ignore-robots-txt
Legal and Ethical Considerations
- Respect Airbnb's Terms of Service: This extension is for legitimate research and booking assistance
- Robots.txt Compliance: The extension respects robots.txt by default
- Rate Limiting: Be mindful of request frequency to avoid overwhelming Airbnb's servers
- Data Usage: Only extract publicly available information for legitimate purposes
Support
- Issues: Report bugs and feature requests on GitHub Issues
- Documentation: Additional documentation available in the repository
- Community: Join discussions about MCP and DXT development
License
MIT License - see LICENSE file for details.
Contributing
Contributions are welcome! Please read the contributing guidelines and submit pull requests for any improvements.
Note: This extension is not affiliated with Airbnb, Inc. It is an independent tool designed to help users search and analyze publicly available Airbnb listings.
サーバー設定
{
"mcpServers": {
"mcp-server-airbnb": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--openbnb-org--mcp-server-airbnb--mcp-server-airbnb",
"node dist/index.js"
],
"env": {}
}
}
}
