JinDaGe - mcp-server-airbnb MCP Details

article

README

🚀 Airbnb MCP 服务器

用于搜索Airbnb并获取房源详细信息的MCP服务器，能让你轻松掌握Airbnb房源的各类信息。

✨ 主要特性

👍 尊重Airbnb的robots.txt规则，合规使用。
🛠️ 使用cheerio进行HTML解析，高效处理网页数据。
🗝️ 无需API密钥，使用更便捷。
📦 返回结构化JSON数据，方便后续处理。
⚡️ 减少上下文加载，通过扁平化和选择数据来实现，提升性能。

📦 安装指南

在Claude Desktop上安装

在开始之前，请确保您的设备已安装Node.js，以便npx可以正常运行。

打开：设置 > 开发者 > 编辑配置。
将以下内容添加到您的claude_desktop_config.json中：

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

如果希望所有请求都忽略robots.txt规则，可以使用以下版本：

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

重启Claude Desktop并计划您的下一次包含Airbnbs的旅行！

其他选项：通过Smithery安装

要通过Smithery自动安装mcp-server-airbnb：

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

🔧 技术细节

工具

`airbnb_search`

功能：搜索Airbnb房源。
必填输入：
- location（字符串）：指定搜索的地点。
可选输入：
- placeId（字符串）
- checkin（字符串，YYYY - MM - DD）：入住日期。
- checkout（字符串，YYYY - MM - DD）：退房日期。
- adults（数字）：成人数量。
- children（数字）：儿童数量。
- infants（数字）：婴儿数量。
- pets（数字）：宠物数量。
- minPrice（数字）：最低价格。
- maxPrice（数字）：最高价格。
- cursor（字符串）
- ignoreRobotsText（布尔值）：是否忽略robots.txt规则。
返回：包含名称、价格、位置等信息的房源数组。

`airbnb_listing_details`

功能：获取特定Airbnb房源的详细信息。
必填输入：
- id（字符串）：房源的ID。
可选输入：
- checkin（字符串，YYYY - MM - DD）：入住日期。
- checkout（字符串，YYYY - MM - DD）：退房日期。
- adults（数字）：成人数量。
- children（数字）：儿童数量。
- infants（数字）：婴儿数量。
- pets（数字）：宠物数量。
- ignoreRobotsText（布尔值）：是否忽略robots.txt规则。
返回：包含描述、房东信息、设施、价格等详细房源信息。

建设（针对开发者）

如果你是开发者，可使用以下命令进行项目的安装和构建：

npm install
npm run build

📄 许可证

此MCP服务器在MIT License下许可。

⚠️ 免责声明

Airbnb是Airbnb, Inc.的商标。OpenBnB与Airbnb, Inc.及其子公司无关。

mcp-server-airbnb