Domoteek MCP Server Airbnb

🚀 Airbnb MCP Service

An MCP server for searching Airbnb listings and retrieving detailed accommodation information. It provides direct links to listings in Airbnb search results.

🚀 Quick Start

The Airbnb MCP Service is designed to search for Airbnb listings and obtain detailed accommodation information. It offers direct links to the listings in Airbnb search results.

✨ Features

• Comply with Airbnb's robots.txt rules.
• Use cheerio for HTML parsing.
• No API key is required.
• Return structured JSON data.
• Reduce context load through data flattening and selection.
• Provide direct links to Airbnb listing pages.

📦 Installation

Installation on Claude Desktop

Before you begin, make sure you have Node.js installed on your computer so that npx can be used.

1. Open: Settings > Developer > Modify Configuration.
2. Add the following content to your claude_desktop_config.json file:

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

If you want to ignore the robots.txt file for all requests, use the following version and add the --ignore-robots-txt parameter:

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

3. After the configuration is complete, restart Claude Desktop to apply the changes.

Other Options

You can also use Smithery for installation with the following command:

# Run this command in the terminal:
npx smithery install @Domoteek/mcp-server-airbnb

🔧 Technical Details

Tools

airbnb_search

• Search for Airbnb listings.
• Required parameters: location (string).
• Optional parameters:
  • placeId (string).
  • checkin (string, AAAA-MM-DD).
  • checkout (string, AAAA-MM-DD).
  • adults (number).
  • children (number).
  • infants (number).
  • pets (number).
  • minPrice (number).
  • maxPrice (number).
  • cursor (string).
  • ignoreRobotsText (boolean).
• Returns: An array containing information such as listing names, prices, and locations. Each listing includes a url that directly links to the Airbnb page.

airbnb_listing_details

• Get detailed information about a specific Airbnb listing.
• Required parameters: id (string).
• Optional parameters:
  • checkin (string, AAAA-MM-DD).
  • checkout (string, AAAA-MM-DD).
  • adults (number).
  • children (number).
  • infants (number).
  • pets (number).
  • ignoreRobotsText (boolean).
• Returns: A response containing detailed listing information, including descriptions, host information, amenities, prices, etc. The response also includes a url that directly links to the Airbnb page.

💻 Compilation

For developers, to compile the project, follow these steps:

1. Clone the repository.
2. Install dependencies: npm install.
3. Run tests: npm test.
4. Build the production version: npm run build.

📄 License

[Add license information here]

⚠️ Important Note

This project is for reference only. Use it with caution in actual situations.