Airbnb

🚀 Airbnb MCP 服务器

本项目是一个用于搜索Airbnb房源并获取住宿详细信息的MCP服务器。使用该服务器搜索的结果中会包含直接链接到Airbnb房源页面的链接，方便您快速访问房源。

🚀 快速开始

本服务器提供了便捷的工具来搜索和获取Airbnb房源信息，您可以根据需求使用相应工具。

✨ 主要特性

• 遵守Airbnb的robots.txt规则，确保使用的合规性。
• 使用cheerio进行HTML分析，高效处理网页数据。
• 无需API密钥，降低使用门槛。
• 返回结构化的JSON数据，方便后续处理。
• 减轻上下文负担，通过扁平化和选择性数据返回来实现。
• 提供直接链接到Airbnb房源页面，方便用户快速访问。

📦 安装指南

在Claude Desktop上的安装

在开始之前，请确保您的计算机上已安装Node.js（https://nodejs.org/），以便npx能够正常运行。

1. 打开：设置 > 开发者 > 修改配置。
2. 将以下内容添加到claude_desktop_config.json文件中：

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

如果您希望忽略所有请求中的robots.txt文件，请使用带--ignore-robots-txt参数的版本：

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

3. 重启Claude Desktop并计划您的下次旅行，包含Airbnb房源！

其他选项：通过Smithery安装

要通过Smithery自动安装，请运行以下命令：

# 使用默认值安装到package.json
npx smithery install @domoteek/mcp-server-airbnb

# 或指定配置文件路径（可选）
npx smithery install --config your configFile.js @domoteek/mcp-server-airbnb

🔧 技术细节

工具

1. airbnb_search

• 功能：搜索Airbnb房源。
• 必填参数：
  • location（字符串）：指定搜索的地点。
• 可选参数：
  • placeId（字符串）：地点ID。
  • checkin（字符串，AAAA - MM - DD）：入住日期。
  • checkout（字符串，AAAA - MM - DD）：退房日期。
  • adults（数字）：成人数量。
  • children（数字）：儿童数量。
  • infants（数字）：婴儿数量。
  • pets（数字）：宠物数量。
  • minPrice（数字）：最低价格。
  • maxPrice（数字）：最高价格。
  • cursor（字符串）：分页游标。
  • ignoreRobotsText（布尔值）：是否忽略robots.txt文件。
• 返回值：包含房源名称、价格、位置等信息的数组。每个房源都包括一个直接链接到Airbnb页面的url。

2. airbnb_listing_details

• 功能：获取特定Airbnb房源的详细信息。
• 必填参数：
  • id（字符串）：房源ID。
• 可选参数：
  • checkin（字符串，AAAA - MM - DD）：入住日期。
  • checkout（字符串，AAAA - MM - DD）：退房日期。
  • adults（数字）：成人数量。
  • children（数字）：儿童数量。
  • infants（数字）：婴儿数量。
  • pets（数字）：宠物数量。
  • ignoreRobotsText（布尔值）：是否忽略robots.txt文件。
• 返回值：包含房源描述、房东信息、设施、价格等详细信息。响应中包括直接链接到Airbnb房源页面的url。

编译

如果您需要从源代码进行编译，请运行以下命令：

npm install

📄 许可证

本项目由Domino Liu创建，并在MIT License下开源。

项目地址
文档地址

⚠️ 重要提示

Airbnb的用户协议禁止通过自动化方式访问其网站，使用此库时请遵守相关法律法规。