- name
- hotel-manager
- description
- 酒店管家 Skill - 管理酒店 OTA 基础信息、房价库存及订单同步。
- env_vars
Hotel Manager Skill
本 Skill 为酒店管理人员提供多平台（OTA）统一管理方案，支持 API 自动化 与 浏览器自动化 双模式。
[!IMPORTANT] 本仓库目前提供的是 集成架构模板。在使用前，您需要根据特定平台的 API 文档完善 scripts/ota_client.js 中的协议细节。安全与隐私 (Security)
为了保护您的 API 密钥，本 Skill 采用以下安全策略：
- 环境变量优先：强烈建议通过环境变量配置凭证。
- 浏览器沙箱：UI 自动化模式利用 Agent 已有的浏览器会话，不需本地存储明文密码。
- 安全传输：脚本强制使用 HTTPS 请求。
配置指南
方法 A: 环境变量 (推荐 API 模式)
设置 OTA_CTRIP_API_KEY 等变量。详细列表见上方元数据。
方法 B: UI 自动化模式 (无 API 时)
无需特殊 API 配置，Agent 将直接操作浏览器。参考 scripts/browser_controller.js 了解 SOP。
核心功能
- OTA 基础信息管理：同步酒店描述、设施等。
- 日常价库调整：支持批量 API 更新及智能体 直接改价（浏览器模拟）。
- 房态控制：快速开关特定房型，支持跨平台同步。
- 自动接单同步：一键开启订单抓取并推送到内部系统。
操作模式
1. API 模式
高速执行，适用于大型酒店连锁。逻辑位于 scripts/ota_client.js。
2. 浏览器直接改价 (Visual Mode)
适用于无法获取 API 权限的小型客栈或特殊 OTA 平台。
- Agent 执行逻辑：打开对应的 OTA 后台网页 -> 自动定位改价区 -> 执行修改并截图存证。
- 详见：
scripts/browser_controller.js。
权限说明
- 网络访问：访问 OTA 后台及内部 API。
- 浏览器权限：需要读写及点击操作权限。
最佳实践
- 操作留痕：UI 模式下建议 Agent 在每次改价后提供页面截图。
- 速率限制：避免过快操作导致封禁，脚本预留了休眠策略。