返回 MCP 目录
public公开dns本地运行

openbnb-org_mcp-server-airbnb

Airbnb房源搜索与详情查询服务,提供无需API密钥的房源数据获取功能,支持多种搜索条件与详细房源信息解析。

article

README

🚀 Airbnb MCP 服务器

用于搜索Airbnb房源并获取 listings 详细信息的MCP服务器,可助力用户轻松查找心仪的房源并获取全面信息。

smithery badge

✨ 主要特性

  • 尊重Airbnb的robots.txt规则,合规使用。
  • 使用cheerio进行HTML解析,高效处理网页内容。
  • 无需API密钥,使用门槛低。
  • 返回结构化的JSON数据,方便数据处理。
  • 减少上下文负载通过扁平化和选择数据,提升使用性能。

📦 安装指南

在Claude Desktop上安装

在开始之前,请确保已安装Node.js,以便npx可以使用。

  1. 转到: 设置 > 开发者 > 编辑配置。
  2. 将以下内容添加到您的claude_desktop_config.json中:
{
  "mcpServers": {
    "airbnb": {
      "command": "npx",
      "args": [
        "-y",
        "@openbnb/mcp-server-airbnb"
      ]
    }
  }
}

若要忽略所有请求的robots.txt规则,请使用以下版本带有--ignore-robots-txt参数:

{
  "mcpServers": {
    "airbnb": {
      "command": "npx",
      "args": [
        "-y",
        "@openbnb/mcp-server-airbnb",
        "--ignore-robots-txt"
      ]
    }
  }
}
  1. 重启Claude Desktop并计划您的下一次包含Airbnbs的旅行!

其他选项: 通过Smithery安装

要通过Smithery自动安装mcp-server-airbnb到Claude Desktop,可使用以下命令:

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 (布尔值)
  • 返回: 包含名称、价格、位置等信息的列表房源。

airbnb_listing_details

  • 功能:获取特定Airbnb房源的详细信息。
  • 必填输入: id (字符串)
  • 可选输入:
    • checkin (字符串, YYYY-MM-DD)
    • checkout (字符串, YYYY-MM-DD)
    • adults (数字)
    • children (数字)
    • infants (数字)
    • pets (数字)
    • ignoreRobotsText (布尔值)
  • 返回: 详细的房源信息,包括描述、房东详情、设施、价格等。

🔧 技术细节(针对开发者)

构建步骤

npm install
npm run build

📄 许可证

请参阅项目的许可证文件以获取详细信息。

⚠️ 免责声明

请参阅项目的免责声明文件以获取详细信息。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端