用途:根据 Airbnb 数字房源 ID,通过内部 StaysPdpSections GraphQL API 获取该房源的完整详情数据,无需登录。
主要能力:返回标题、房型、描述、照片、经纬度、城市、设施列表、房屋规则、亮点、总体评分、评论数、分类评分、卧室信息等。
使用方式:需浏览器已打开(任意页面),API 调用在浏览器上下文中通过 fetch() 完成,无需特定页面导航。通过 Skill 工具加载 browser-act 使用方式。命令:eval "$(python scripts/listing-detail.py '{listing_id}')"。参数:listing_id 为数字房源 ID(如 5476930,可从 airbnb.com/rooms/{listing_id} 提取);--checkin、--checkout 为 YYYY-MM-DD 日期,默认无;--adults 默认 1;--locale 默认 en;--currency 默认 USD。
适用场景:批量抓取房源详情、整理房源数据。批量时建议串行循环并每次间隔 1 秒,先用 1-2 个 ID 测试,按 ID 保存结果以便断点续跑。
限制:无日期时不含每晚价格;新房源无评论时 rating_overall 与 review_count 为 null;单间或酒店式房间 bedrooms 可能为空;房东个人信息(简介、头像、回复率)不在此端点返回;调用过快可能触发限流;若返回错误需验证 ID 有效性,无数据可能表示房源已移除或 API 结构变更。执行前若存在经验记录文件应先读取,遇到异常可追加记录。