Airbnb 房源可订日历采集(最长12个月·逐日价格·直连版)
无需任何凭证,按房源 ID 批量获取 Airbnb 公开的多月可用性日历,输出逐日明细与可订统计
概览
给它一个或多个房源 ID,它就返回每套房源未来数月的可用性日历:逐日的可订状态、入住/退房限制、最少最多晚数,以及可订/不可订天数统计。每套房源一条记录。
数据直接来自 Airbnb 公开的日历接口,不需要任何账号或凭证配置,不登录。
数据说明
只读取公开可见的日历数据。请求复用 Chrome 124 的浏览器网络指纹;若来源站拒绝访问,运行会明确报错,不会返回编造的数据。单套房源无日历数据时会跳过并记录日志。
结果长什么样
每套房源一条记录,内嵌 days 数组。
| 房源ID | 起始月 | 总天数 | 可订天数 | 不可订天数 |
|---|---|---|---|---|
| 691380 | 2026-11 | 365 | 264 | 101 |
应用场景
- 批量监控竞品房源的可用性日历
- 计算入住率、可订天数做市场分析
- 导出逐日可用性做表格或 BI 分析
适用边界
按房源 ID 或链接获取最多 12 个月逐日可用性,每套房源一条记录内嵌 days 数组。仅调用公开接口,不登录
- 适合用于
- 需要批量获取多套房源的可用性日历做竞品分析
- 需要可订天数、不可订天数等汇总统计
- 需要逐日的入住/退房限制与最少最多晚数
- 不要用于
- 需要按目的地搜索房源列表
- 需要评论或房源详情描述
- 需要登录后可见的私有数据
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1若来源站拒绝访问(反爬拦截),本次运行会明确报错,不返回伪造数据
- 2单个房源无日历数据时跳过并记录日志,其余照常返回
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 房源ID列表
listingIds选填array<string>Airbnb 房源数字 ID 列表,可多个示例["691380"] - 房源链接列表
startUrls选填array<string>完整的 Airbnb 房源链接,与房源ID可混用 - 日历月数
months选填integer每套房源获取的日历月数,1-12,默认 12范围1–12默认值12 - 起始月份
startMonth选填integer第一个日历月份 1-12,默认当前月范围1–12 - 起始年份
startYear选填integer第一个日历月份所在年份,例如 2026,默认当前年范围2020– - 币种
currency选填string价格字段币种代码,默认 USD默认值USD - 最大房源数
maxItems选填integer最多处理的房源数量,0 表示不限范围0–
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 房源ID
listingIdstringAirbnb 房源数字 ID - 房源链接
urlstring房源详情页链接 - 币种
currencystring价格币种 - 请求月数
requestedMonthsinteger请求的日历月数
调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=zhouzhouRPA/abnb-03343-cirkit-calendar",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。