Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

酒店运营助手 (Hotel Ops Skill)

酒店 OTA 运营智能体,自动化处理美团+携程平台运营工作。

功能模块

模块 功能
🔥 调价引擎 5大策略(低价抢量/正常定价/溢价控量/早鸟激励/尾房清仓)
⭐ 点评回复 好评/中评/差评自动生成
🏠 房态管理 入住率监控、超售预警、关/开房建议
📊 经营报表 日报/周报/月报,ADR/RevPAR指标
🔍 竞品监控 高德发现竞对 + 浏览器RPA采集
🎯 客诉SOP P0-P3分级处理,补偿方案

🤖 智能体安装指南

Coze(扣子)安装

方式一:通过 skill-assistant 搜索安装

1. 在Coze对话中对我说:"帮我安装 hotel-ops-skill"
2. 我会自动搜索并安装

方式二:手动安装

1. 访问 https://github.com/Docking666/hotel-ops-skill
2. 下载整个仓库为ZIP
3. 在Coze控制台 > 技能 > 创建技能 > 上传ZIP

OpenClaw 安装

# 使用 clawhub 安装
clawhub install hotel-ops-skill --registry=https://cn.clawhub-mirror.com

或克隆后本地安装:

git clone https://github.com/Docking666/hotel-ops-skill.git
cd hotel-ops-skill
clawhub install . --registry=https://cn.clawhub-mirror.com

虾评平台 安装

1. 访问 https://xiaping.coze.com
2. 搜索 "hotel-ops" 或 "酒店运营"
3. 下载安装

通用安装(其他AI平台)

# 克隆仓库
git clone https://github.com/Docking666/hotel-ops-skill.git

# 或下载ZIP
curl -L https://github.com/Docking666/hotel-ops-skill/archive/refs/heads/master.zip -o hotel-ops.zip
unzip hotel-ops.zip

⚙️ 接口配置

1. 高德地图 API Key(必需)

申请地址:https://lbs.amap.com/dev/key/app

免费额度:

  • 每日5000次调用
  • 足够日常使用

配置方式:

编辑 config/competitors.json:

{
  "config": {
    "amap_api_key": "你的高德API Key"
  }
}

2. 美团/携程 账号(竞品监控用)

竞品价格采集需要登录态:

方式一:Cookie配置

{
  "config": {
    "meituan_cookie": "你的美团Cookie",
    "ctrip_cookie": "你的携程Cookie"
  }
}

方式二:浏览器自动化(推荐)

1. 确保有云电脑环境
2. 安装 agent-browser skill
3. 首次运行会提示登录,后续自动记住

3. 调价策略配置

编辑 config/strategies.json:

{
  "strategies": [
    {
      "name": "低价抢量",
      "condition": "occupancy < 0.3",
      "action": "reduce",
      "range": [-0.2, -0.1],
      "priority": 1
    },
    {
      "name": "正常定价",
      "condition": "0.3 <= occupancy <= 0.7",
      "action": "follow_competitor",
      "range": [-0.05, 0.05],
      "priority": 2
    },
    {
      "name": "溢价控量",
      "condition": "occupancy > 0.7",
      "action": "increase",
      "range": [0.15, 0.3],
      "priority": 3
    },
    {
      "name": "早鸟激励",
      "condition": "days_ahead >= 7",
      "action": "discount",
      "range": [-0.1, -0.05],
      "priority": 4
    },
    {
      "name": "尾房清仓",
      "condition": "days_ahead <= 2",
      "action": "clearance",
      "range": [-0.3, -0.15],
      "priority": 5
    }
  ]
}

4. 竞对列表配置

编辑 config/competitors.json:

{
  "config": {
    "amap_api_key": "你的API Key",
    "meituan_cookie": "",
    "ctrip_cookie": ""
  },
  "known_competitors": [
    {
      "name": "竞对酒店A",
      "location": "116.397428,39.90923",
      "platforms": ["meituan", "ctrip"]
    }
  ],
  "monitoring_schedule": {
    "enabled": true,
    "frequency": "daily",
    "time": "06:00"
  }
}

📁 目录结构

skills/hotel-ops/
├── SKILL.md                    # 技能主文件(Coze用)
├── scripts/
│   ├── pricing_engine.py       # 调价引擎
│   ├── amap_client.py          # 高德API
│   ├── review_replier.py        # 点评回复
│   ├── room_manager.py          # 房态管理
│   ├── reporter.py              # 报表生成
│   ├── competitor_monitor.py    # 竞品监控RPA
│   ├── complaint_handler.py      # 客诉SOP
│   └── main.py                  # 主入口
├── config/
│   ├── strategies.json          # 调价策略
│   └── competitors.json          # 竞对配置
└── data/                        # 数据存储

🚀 快速开始

Python 直接运行

cd skills/hotel-ops/scripts

# 配置API Key后运行
python main.py

触发关键词(Coze/OpenClaw)

- "调价建议"
- "帮我分析竞品"
- "生成今日报表"
- "回复点评"
- "处理客诉"
- "房态概览"

📊 使用示例

调价建议

from pricing_engine import PricingEngine, PricingContext
from datetime import datetime

engine = PricingEngine()

context = PricingContext(
    date=datetime.now(),
    occupancy_rate=0.65,
    days_ahead=3,
    base_price=299,
    competitor_median=285,
    is_weekend=False,
    is_holiday=False
)

suggestion = engine.generate_suggestion(context)
print(f"建议价格: ¥{suggestion.suggested_price}")

竞品监控

from competitor_monitor import CompetitorMonitor

monitor = CompetitorMonitor()
result = monitor.collect_all_rpa(platforms=['meituan', 'ctrip'])
print(f"采集完成: {result['success']}成功, {result['failed']}失败")

⚠️ 注意事项

  1. 高德API Key:必须配置,否则竞品发现功能无法使用
  2. RPA采集:需要云电脑环境,安装 agent-browser skill
  3. Cookie更新:美团/携程登录态可能过期,需定期更新
  4. 数据存储:默认保存在本地 data/ 目录

📝 依赖

  • Python 3.8+
  • requests(API调用)
  • agent-browser skill(浏览器自动化,可选)

📄 License

MIT License

About

酒店OTA运营智能体 - 动态调价/点评回复/房态管理/竞品监控/客诉SOP

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages