用途:通过 Patchright(Playwright 的免检测分支)自动化搜索 VRBO 度假屋,返回整栋住宅、公寓、木屋等房源,含价格与预订链接。它是 Airbnb MCP 的补充,适合多人、家庭出行;VRBO 上有不少专业托管公寓和木屋未在 Airbnb 上架。只负责查找并返回链接,不完成预订。
主要能力:按目的地、入住/退房日期、成人/儿童人数、宠物、最少卧室数筛选,返回房源名称、卧室数、浴室数、可住人数、评分、评论数、每晚价格、含税总价、经纬度与 URL;支持 --limit(默认 20)、--retries(默认 4)、--json 输出,便于编排。价格字符串解析为 pricePerNight 与 priceTotal,SERP 总价含税费。
用法:安装 pip install patchright && patchright install chromium;必须运行于有头模式(headless=False),macOS 会短暂弹出 Chrome 窗口;无人值守时用 Docker(Xvfb 提供虚拟显示)。示例:python3 skills/vrbo/scripts/search_vrbo.py --dest "Canmore, Alberta, Canada" --checkin 2026-06-26 --checkout 2026-07-02 --adults 3 --json。无需登录,搜索结果公开,持久化配置仅缓存 Akamai cookie 以减少重复验证。测试:python3 -m unittest discover -s skills/vrbo/tests -v。
适用场景:多人/家庭整栋或整套公寓、木屋;对比 Airbnb 与 VRBO;度假村或山区小镇(Canmore、班夫、Whistler、Muskoka)由专业物业管理的房源。
限制:不用于完成预订,也不用于酒店(用 compare-hotels / serpapi / liteapi)或单间/合住房间(用 Airbnb MCP private_room)。VRBO 位于 Akamai Bot Manager 之后,普通 HTTP、标准 Playwright、@playwright/mcp 和 agent-browser 会遭遇 429 机器人墙,需 Patchright 通过传感器验证;Akamai 对 IP 限速,数据中心/CI/VPN IP 常被阻止,建议住宅网络并间隔数分钟搜索。DOM 选择器会随 Expedia 的 data-stid 设计系统变动,若 extractor 为 dom:anchors 需刷新选择器。浏览器驱动路径无法单元测试,需真实搜索手动验证。