AirROI Airbnb MCP Server

---

AirROI 的 Airbnb MCP 服务为 Claude、Codex、Cursor、VS Code 及其他任何 Model Context Protocol 客户端提供 29 个工具，用于查询 Airbnb 和短租市场数据：入住率、ADR、RevPAR、收入百分位数、可比房源、收入估算、实时 Airbnb 日历和搜索排名，以及价格建议。它覆盖 190 多个国家/地区的 2,000 多万套房源，并基于持续维护的数据集提供答案，因此你的助手无需抓取 airbnb.com。

此仓库仅包含文档。服务完全托管在远程的 https://mcp.airroi.com，无需安装或运行任何内容。AirROI 是独立的数据提供商，与 Airbnb 没有隶属关系。截至 2026 年 9 月，Airbnb 尚无官方 MCP 服务或公开 API。

端点	https://mcp.airroi.com
传输方式	Streamable HTTP（远程）
身份验证	X-API-KEY 请求头，每个请求都必须提供
工具	29 个（11 个市场、13 个房源、3 个查询和估算、2 个定价）
价格	每次调用低至 $0.01，按使用量付费
注册表	官方 MCP Registry 中的 com.airroi/mcp
文档	https://www.airroi.com/mcp-server

你需要哪种 Airbnb MCP 服务？

“Airbnb MCP 服务”可能指三种不同的服务。请根据用途选择：

你想要……	服务类型	示例	AirROI？
查找住宿	房源搜索抓取器	Apify、Bright Data	否
管理自己的房源（消息、预订、日历）	房源管理服务	Hospitable、Guesty	否
分析市场、房源或可比房源组	市场数据 MCP	AirROI	是

包含价格和限制的并排比较：https://www.airroi.com/mcp-server/compare

获取 API 密钥

1. 在 https://www.airroi.com/api 注册免费 API 密钥。
2. 在开发者控制面板 https://www.airroi.com/api/developer/activate 中激活并复制密钥。
3. 在以下代码片段中，将密钥用作 X-API-KEY 请求头的值。仅替换 YOUR_API_KEY。

发现工具（tools/list）不计费，但每个请求都需要密钥。

设置

完整的客户端专属指南：Claude · Codex 和 ChatGPT · 其他所有客户端

Claude Code

claude mcp add --transport http airroi \
  https://mcp.airroi.com \
  --header "X-API-KEY: YOUR_API_KEY" --scope user

使用 claude mcp get airroi 检查，然后向 Claude 提出市场相关问题。

Claude Desktop

Claude Desktop 通过 mcp-remote 桥接程序使用自定义请求头连接远程服务（需要 Node.js）。编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows），然后重启应用：

{
  "mcpServers": {
    "airroi": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.airroi.com",
        "--header",
        "X-API-KEY:${AIRROI_API_KEY}"
      ],
      "env": { "AIRROI_API_KEY": "YOUR_API_KEY" }
    }
  }
}

确保 X-API-KEY:${AIRROI_API_KEY} 中冒号两侧没有空格。

Codex（CLI、IDE 扩展和 ChatGPT 桌面应用）

这三者都读取 ~/.codex/config.toml：

[mcp_servers.airroi]
url = "https://mcp.airroi.com"
env_http_headers = { "X-API-KEY" = "AIRROI_API_KEY" }

然后在 shell 配置文件中运行 export AIRROI_API_KEY=YOUR_API_KEY。codex mcp list 会显示 Auth: Unsupported，这是针对请求头身份验证的预期结果。网页版 ChatGPT（开发者模式）不支持使用 API 密钥的服务，因此请使用 Codex。

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）：

{
  "mcpServers": {
    "airroi": {
      "url": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "${env:AIRROI_API_KEY}" }
    }
  }
}

VS Code（Copilot Agent 模式）

.vscode/mcp.json。顶层键是 servers，而不是 mcpServers：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "airroi-key",
      "description": "AirROI API key",
      "password": true
    }
  ],
  "servers": {
    "airroi": {
      "type": "http",
      "url": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "${input:airroi-key}" }
    }
  }
}

Devin Desktop（原名 Windsurf）

~/.config/devin/mcp_config.json（Windows：%APPDATA%\devin\mcp_config.json）：

{
  "mcpServers": {
    "airroi": {
      "serverUrl": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "${env:AIRROI_API_KEY}" }
    }
  }
}

Antigravity CLI（Gemini CLI 的后继版本）

~/.gemini/config/mcp_config.json（全局）或 .agents/mcp_config.json（项目）：

{
  "mcpServers": {
    "airroi": {
      "serverUrl": "https://mcp.airroi.com",
      "headers": { "X-API-KEY": "YOUR_API_KEY" }
    }
  }
}

n8n

1. 添加一个 AI Agent 节点，然后将 MCP Client Tool 节点连接到该节点。
2. 将端点设置为 https://mcp.airroi.com，并将传输方式设置为 HTTP Streamable。
3. 选择 Header Auth，并创建一个凭据，名称为 X-API-KEY，值为你的密钥。

OpenAI Agents SDK (Python)

import asyncio, os
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    async with MCPServerStreamableHttp(
        name="airroi",
        params={
            "url": "https://mcp.airroi.com",
            "headers": {"X-API-KEY": os.environ["AIRROI_API_KEY"]},
        },
    ) as airroi:
        agent = Agent(name="STR analyst", mcp_servers=[airroi])
        result = await Runner.run(
            agent, "Occupancy and ADR for 2-bedroom homes in Nashville?"
        )
        print(result.final_output)

asyncio.run(main())

仅支持 stdio 的客户端

npx mcp-remote https://mcp.airroi.com --header X-API-KEY:${AIRROI_API_KEY}

一次真实会话

在运行中的服务 mcp.airroi.com 上执行提示词：

对比 Austin 和 Nashville 的整套 2 居室 Airbnb：入住率、ADR、RevPAR、年收入，以及我将面对多少个竞争房源。

工具调用：airroi_search_markets → airroi_search_markets → airroi_market_summary → airroi_market_summary → airroi_market_revenue → airroi_market_revenue（费用为 $0.42）

过去 12 个月，Nashville 的整套 2 居室房源平均每套收入更高：年均收入为 $40,075，而 Austin 为 $24,965。两地的入住率几乎相同（49% 对 48%），因此差距来自房价：Nashville 的 ADR 为 $296，Austin 为 $236，对应的 RevPAR 分别为 $146 和 $114。Nashville 的 2 居室房源供应也更少，每月约有 1,270 个活跃房源，而 Austin 约有 2,029 个。2025 年 10 月是两个市场中位数房源表现最好的月份，Nashville 为 $5,009，Austin 为 $3,941。

更多会话（实时搜索排名、房东报告、未来预订进度、Lisbon）：https://www.airroi.com/mcp-server/use-cases

工具（29 个）

没有任何工具可以更改房源、价格、预订或消息。26 个工具标记为只读；其余 3 个工具会创建下载文件或扫描游标。

市场分析（11）

工具	功能	每次调用价格
airroi_market_min_nights	跟踪市场内每月平均最少入住晚数设置及百分位数分布。可借此结合入住率和定价趋势，了解当地的住宿限制。	$0.10
airroi_market_summary	快速获取市场概览及关键统计数据：入住率、ADR、RevPAR、房源年均收入、预订提前期、入住时长、最少入住晚数和活跃房源数量。返回任意市场过去 12 个月的单次响应快照。	$0.10
airroi_market_metrics_all	在一次响应中获取合并后的所有市场指标。返回按月时间序列及百分位数分布（平均值、p25、p50、p75、p90），涵盖入住率、ADR、RevPAR、收入、预订提前期、入住时长、最少入住晚数和活跃房源数量，是最全面的单一工具。	$0.50
airroi_market_occupancy	通过按月时间序列数据跟踪历史和季节性入住率趋势。返回平均值及百分位数分布，帮助识别需求高峰期和预订模式。	$0.10
airroi_market_adr	通过按月时间序列和百分位数分布分析平均每日房价趋势。跟踪整个市场的定价压缩、季节性波动和房价增长。	$0.10
airroi_market_revpar	监测每间可出租房源收入，将入住率和定价合并为单一绩效指标。返回按月时间序列及百分位数分布，供基准比较。	$0.10
airroi_market_revenue	通过时间序列和百分位数分布跟踪每月房源收入。分析收入增长趋势和季节性模式，以评估投资机会规模。	$0.10
airroi_market_lead_time	了解各市场中房客提前多少天预订。返回按月时间序列及百分位数，帮助优化定价和营销时机策略。	$0.10
airroi_market_los	分析房客平均入住时长模式，以晚数计。返回按月时间序列及百分位数分布，用于运营规划和最少入住时长优化。	$0.10
airroi_market_active_listings	通过跟踪活跃房源数量随时间的变化，监测市场供给增长。利用按月时间序列数据识别新入市者、市场饱和情况和竞争格局变化。	$0.10
airroi_market_future_pacing	获取未来日期的预订进度数据。返回每日预订进度数据，包括已预订数量、可订数量、平均房价和预订率，用于需求预测和收入预测。	$0.20

市场查询和收入估算（3）

工具	功能	每次调用价格
airroi_search_markets	通过名称前缀匹配搜索短租市场。返回所有市场工具所需的确切市场标识（国家、地区、地方、行政区）及活跃房源数量。	$0.01
airroi_lookup_market	将原始 GPS 坐标解析为所有市场工具所需的确切市场标识（国家、地区、地方、行政区）。这是 search_markets 的反向操作——如果你有纬度和经度而非地点名称，请使用此工具。	$0.01
airroi_estimate_revenue	根据卧室数、浴室数和接待人数，为任意地点生成收入预测。返回预计年收入、ADR、入住率及百分位数分布（p25-p90）、月度分布和可比房源。	$0.20

房源数据（4 个）

工具	功能说明	每次调用价格
airroi_get_listing	按 ID 获取一个 Airbnb 房源的完整数据：房源详情、描述文本、照片 URL、入住和退房时间、住客最爱标识、定价、评分，以及包括过去 12 个月和过去 90 天入住率、ADR 和收入在内的业绩指标。	$0.10
airroi_batch_listings	在一次计费请求中获取最多 25 个房源的详细信息。返回数量统计和可下载的 JSON 资源，其中包含完整的房源详情以及各 ID 对应的错误。下载资源不会重复调用 API。	$1.00
airroi_find_comparables	根据位置、卧室数、卫生间数和接待人数，按相关性排序，查找最多 25 个相似房源。可通过坐标或实际地址指定位置，还可选填 1–10 英里的半径和房间类型，用于竞争基准分析。	$0.10
airroi_listing_metrics	获取每个房源最多 60 个月的历史业绩数据：月度入住率、ADR、RevPAR、收入和平均最少入住晚数设置。适用于趋势分析、季节性检测和投资评估。	$0.10

房源搜索与导出（4 个）

工具	功能说明	每次调用价格
airroi_search_by_market	使用 OpenStreetMap 市场定义，在城市、地区或街区内搜索活跃房源；未提供市场时则进行全球搜索。可按房源属性、房东详情、定价、评分和业绩指标筛选；每次调用最多返回 10 条精简摘要。	$0.50
airroi_search_by_radius	查找任意 GPS 坐标周围 1–100 英里范围内的房源。支持与市场搜索相同的筛选和排序功能，便于进行基于位置的竞争分析；每次调用最多返回 10 条精简摘要。	$0.50
airroi_search_by_polygon	搜索由 3 个或更多坐标点定义的自定义地理边界内的房源。可绘制任意形状来界定搜索区域，以便精确划分市场和分析街区；每次调用最多返回 10 条精简摘要。	$0.50
airroi_export	将匹配市场、半径或自定义多边形选择条件的所有房源导出到一个文件中，并通过有效期为 7 天的预签名下载 URL 提供。完整数据集不会流式传输到对话中——你会获得元数据、简短预览和下载链接，以便在本地保存。可选择 JSONL（每行一个完整的嵌套房源对象）或 CSV（展平的摘要列）。系统会在内部处理分页，最多支持 100,000 个房源；如果达到时间预算，超大型导出会返回包含数量统计的部分文件。适用于批量分析、数据管道和离线脚本处理。	$0.50（每 10 个房源调用 1 次）

Airbnb 实时数据（5）

工具	功能	每次调用价格
airroi_live_calendar	从 Airbnb 实时获取房源日历：未来 12 个月的每晚价格（不含清洁费）、可订状态和最短入住晚数，以及房东的清洁费和短住清洁费。已预订和被房东屏蔽的晚数均显示为不可订。	$0.20
airroi_live_rates	仅实时获取房源未来 12 个月的每晚价格，支持本地货币或美元。当无需了解可订状态时，可用于追踪竞品价格。	$0.10
airroi_live_availability	实时获取房源未来 12 个月的可订状态和入住规则：可订或不可订的晚数、最短和最长入住时间，以及住客能否在每个日期办理入住或退房。	$0.10
airroi_live_search_ranking	按排名顺序查看 Airbnb 针对地图矩形区域显示的房源（最多 270 个）。可用于检查某个房源在搜索结果中相对于竞品的排名。	$0.20
airroi_live_scan	实时查找自定义多边形区域内的所有 Airbnb 房源 ID，每页最多 100 个。使用返回的短 scan_id 继续扫描；服务会保留扫描进度，因此每页都很小。搭配 get_listing 或 batch_listings 获取完整详情。	$0.50

价格建议（2）

工具	功能	每次调用价格
airroi_recommend_base_price	根据房源坐标和已知房源信息，估算全年适用的每晚起始价格。可选的便利设施、评价和其他详情有助于优化估算结果。不会保存或发布任何内容。	$0.10
airroi_recommend_calendar_prices	根据坐标、货币和基础价格计算每晚价格。模型会结合季节性、星期、活动和需求，并支持可选的定价规则、季节性调整、价格限制和入住限制。	$0.10

含参数的完整参考文档：https://www.airroi.com/mcp-server/tools

一个问题的费用

典型的市场分析需要调用六次：

调用	价格
airroi_search_markets	$0.01
airroi_market_summary	$0.10
airroi_market_occupancy	$0.10
airroi_market_adr	$0.10
airroi_market_revenue	$0.10
airroi_market_future_pacing	$0.20
总计	$0.61

价格列表：https://www.airroi.com/api/pricing

数据覆盖范围

• 覆盖 190 多个国家/地区、30,000 多个市场中的 2,000 多万套房源
• 按月提供入住率、ADR、RevPAR 和收入，含 p25/p50/p75/p90 百分位数，每次请求最多覆盖 60 个月
• Airbnb 实时日历、价格、可订状态和搜索排名，最多可查看未来 12 个月
• 支持本地货币，也可按需提供美元数据

链接

• Airbnb MCP 服务概览：https://www.airroi.com/mcp-server
• 将 Claude 连接到 Airbnb 数据：https://www.airroi.com/mcp-server/claude
• 将 Codex 和 ChatGPT 连接到 Airbnb 数据：https://www.airroi.com/mcp-server/codex
• Airbnb MCP 服务对比：https://www.airroi.com/mcp-server/compare
• 各客户端的设置指南：https://www.airroi.com/mcp-server/setup
• 工具参考文档：https://www.airroi.com/mcp-server/tools
• 使用场景：https://www.airroi.com/mcp-server/use-cases
• REST API（数据和密钥相同）：https://www.airroi.com/api

许可证

MIT，详见 LICENSE。