技能介绍

要解决什么问题

酒店运营需要持续对比周边竞对在 OTA（如携程、飞猪）上的可订价，但平台没有稳定、合规的公开报价 API；直接拼搜索 URL 或抓接口也容易触发风控、登录态失效，结果不可复现。

本技能面向日常复用的竞对价格采集：在已登录前提下，从平台首页或搜索页按真人可见操作进入酒店详情，只读取页面上渲染出来的房型与价格文本。

技能如何工作

技能分两条主路径，且都依赖 agent-browser 与 dashboard（默认 http://localhost:4848 镜像 default 会话）：

初始化登录：用 dashboard 打开 OTA 首页，用户在 Web 面板里扫码/短信登录；成功后 state save 保存各平台会话，供后续 --state 加载。
日常抓价：抓价前对平台首页做 curl 连通性预检（必要时代理失败后切直连）；加载已保存 state，仍通过 dashboard 可见路径完成搜索与进详情；按 config.json 中的 competitors 抓取指定 room_types 的最低价、含早与取消政策摘要（若页面可见）。

搜索流程有硬性顺序：城市下拉点选 → 关键词建议点选确认 → 入住/离店日期 → 再点搜索；禁止构造带搜索参数的 URL，禁止 XHR/fetch/隐藏接口。若结果页卡片点击不跳转，允许从已渲染 DOM 提取 hotelId/shid 再打开详情直链；首次确认 ID 后应回填 config.json。

适用边界与注意点

登录与抓价都必须在 dashboard 可见 下执行，不能改为 headless 静默跑。
登录失效时标记 login_required，需用户重新跑初始化，技能不会代填密码或自动过验证码/滑块。
飞猪若缺 shid 可能只展示最优惠房型，应记为 partial 而非伪造成完整大床/双床结果。
单家失败（blocked、not_found、network_failed 等）不应中断整批任务；原始 JSON 与 Markdown 简报会汇总各平台、各酒店状态。