Airbnb 搜索与房源 - 桌面扩展 (DXT)

一个全面的桌面扩展，用于搜索 Airbnb 房源，具备高级过滤功能和详细的房源信息检索功能。该扩展以模型上下文协议 (MCP) 服务器的形式构建，并打包为桌面扩展 (DXT) 格式，便于安装并与兼容的 AI 应用程序一起使用。

功能

🔍 高级搜索功能

基于位置的搜索，支持城市、州和地区
Google Maps Place ID 集成，实现精确的位置定位
日期过滤，支持入住和退房日期
客人配置，包括成人、儿童、婴儿和宠物
价格范围过滤，支持最低和最高价格限制
分页支持，便于浏览大量结果集

🏠 详细的房源信息

全面的房源详情，包括设施、政策和亮点
位置信息，包括坐标和社区详情
房屋规则和政策，帮助做出明智的预订决策
房源描述和关键特点
直接链接到 Airbnb 房源，便于预订

🛡️ 安全与合规

遵守 robots.txt，支持可配置的测试覆盖
请求超时管理，防止请求挂起
增强的错误处理，带有详细的日志记录
速率限制意识，尊重 API 使用
通过 DXT 用户设置进行安全配置

安装

对于 Claude Desktop

该扩展打包为桌面扩展 (DXT) 文件。安装步骤如下：

从发布页面下载 .dxt 文件
打开兼容的 AI 应用程序（例如 Claude Desktop）
通过应用程序的扩展管理器安装扩展
根据需要配置扩展设置

对于 Cursor 等

在开始之前，请确保已在桌面上安装 Node.js 以使 npx 正常工作。

进入：Cursor 设置 > 工具与集成 > 新建 MCP 服务器

将以下内容添加到 mcp.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"
      ]
    }
  }
}

重启。

配置

该扩展提供以下用户可配置选项：

忽略 robots.txt

类型: 布尔值（复选框）
默认值: false
描述: 在向 Airbnb 发出请求时绕过 robots.txt 限制
建议: 除非测试需要，否则保持禁用

工具

`airbnb_search`

使用全面的过滤选项搜索 Airbnb 房源。

参数:

location（必填）：搜索位置（例如 "San Francisco, CA"）
placeId（可选）：Google Maps Place ID（覆盖位置）
checkin（可选）：入住日期，格式为 YYYY-MM-DD
checkout（可选）：退房日期，格式为 YYYY-MM-DD
adults（可选）：成人数（默认：1）
children（可选）：儿童数（默认：0）
infants（可选）：婴儿数（默认：0）
pets（可选）：宠物数（默认：0）
minPrice（可选）：每晚最低价格
maxPrice（可选）：每晚最高价格
cursor（可选）：浏览结果的分页游标
ignoreRobotsText（可选）：为此请求覆盖 robots.txt

返回:

搜索结果，包括房源详情、价格和直接链接
分页信息，便于浏览更多结果
参考的搜索 URL

`airbnb_listing_details`

获取特定 Airbnb 房源的详细信息。

参数:

id（必填）：Airbnb 房源 ID
checkin（可选）：入住日期，格式为 YYYY-MM-DD
checkout（可选）：退房日期，格式为 YYYY-MM-DD
adults（可选）：成人数（默认：1）
children（可选）：儿童数（默认：0）
infants（可选）：婴儿数（默认：0）
pets（可选）：宠物数（默认：0）
ignoreRobotsText（可选）：为此请求覆盖 robots.txt

返回:

详细的房源信息，包括：
- 带有坐标的位置详情
- 设施和配套
- 房屋规则和政策
- 房源亮点和描述
- 房源的直接链接

技术细节

架构

运行时: Node.js 18+
协议: 模型上下文协议 (MCP) 通过 stdio 传输
格式: 桌面扩展 (DXT) v0.1
依赖: 最小化外部依赖，确保安全性和可靠性

错误处理

带有时间戳的全面错误日志记录
当 Airbnb 的页面结构发生变化时，优雅降级
网络请求的超时保护
详细的错误信息，便于故障排除

安全措施

默认遵守 robots.txt
请求超时限制
输入验证和清理
安全的环境变量处理
不存储敏感数据

性能

使用 Cheerio 进行高效的 HTML 解析
适当的请求缓存
最小的内存占用
快速启动和响应时间

兼容性

平台: macOS, Windows, Linux
Node.js: 18.0.0 或更高版本
Claude Desktop: 0.10.0 或更高版本
其他 MCP 客户端: 兼容任何支持 MCP 的应用程序

开发

从源代码构建

# 安装依赖
npm install

# 构建项目
npm run build

# 开发期间监视更改
npm run watch

测试

可以通过直接运行 MCP 服务器来测试扩展：

# 默认遵守 robots.txt
node dist/index.js

# 忽略 robots.txt（用于测试）
node dist/index.js --ignore-robots-txt

法律与道德考虑

尊重 Airbnb 的服务条款: 该扩展用于合法的研究和预订辅助
遵守 robots.txt: 默认情况下，扩展遵守 robots.txt
速率限制: 注意请求频率，避免对 Airbnb 的服务器造成过大压力
数据使用: 仅提取公开信息用于合法目的

支持

问题: 在 GitHub Issues 上报告错误和功能请求
文档: 存储库中提供更多文档
社区: 加入关于 MCP 和 DXT 开发的讨论

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

贡献

欢迎贡献！请阅读贡献指南并提交拉取请求以改进项目。

注意: 该扩展与 Airbnb, Inc. 无关。它是一个独立的工具，旨在帮助用户搜索和分析公开的 Airbnb 房源。