Domoteek_mcp-server-airbnb

🚀 Airbnb MCP 服务

Airbnb MCP 服务是一个用于搜索 Airbnb 房源并获取住宿详细信息的 MCP 服务器，它能够提供直接链接到 Airbnb 搜索结果中的房源，方便用户快速访问。

🚀 快速开始

本服务提供了便捷的方式来搜索和获取 Airbnb 房源信息，以下是详细介绍。

✨ 主要特性

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

📦 安装指南

在 Claude Desktop 上的安装

在开始之前，请确保您的计算机上已安装 Node.js，以便 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 以应用更改。

其他选项

您也可以通过以下命令使用 Smithery 进行安装：

# 在终端中运行此命令：
npx smithery install @Domoteek/mcp-server-airbnb

💻 使用示例

工具说明

airbnb_search

• 功能：搜索 Airbnb 房源。
• 必填参数：location（字符串）。
• 可选参数：
  • placeId（字符串）
  • checkin（字符串，AAAA-MM-DD）
  • checkout（字符串，AAAA-MM-DD）
  • adults（数字）
  • children（数字）
  • infants（数字）
  • pets（数字）
  • minPrice（数字）
  • maxPrice（数字）
  • cursor（字符串）
  • ignoreRobotsText（布尔值）
• 返回：包含房源名称、价格、位置等信息的数组。每个房源都包含一个直接链接到 Airbnb 页面的 url。

airbnb_listing_details

• 功能：获取特定 Airbnb 房源的详细信息。
• 必填参数：id（字符串）。
• 可选参数：
  • checkin（字符串，AAAA-MM-DD）
  • checkout（字符串，AAAA-MM-DD）
  • adults（数字）
  • children（数字）
  • infants（数字）
  • pets（数字）
  • ignoreRobotsText（布尔值）
• 返回：包含房源详细信息的响应，包括描述、房东信息、设施、价格等。响应中还包括一个直接链接到 Airbnb 页面的 url。

📚 详细文档

编译步骤

对于开发者，要编译项目，请执行以下步骤：

1. 克隆仓库。
2. 安装依赖项：npm install
3. 运行测试：npm test
4. 构建生产版本：npm run build

📄 许可证

[在此处添加许可证信息]

⚠️ 重要提示

此项目仅供参考，实际使用请谨慎。