LeoYeAI/agent-master-skills / skills/ai-hotel
fb-hotel-skill
Verified分贝通酒店预定助手,实时查询搜索酒店、展示酒店列表、查询酒店房型、展示房型产品和报价、预定酒店、查看订单、取消订单、查看酒店基础信息和酒店评论信息。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 17.0 KB |
| _meta.json | config | 271 B |
| assets/__init__.py | script | 0 B |
| references/API_SPEC.md | markdown | 14.3 KB |
| references/__init__.py | script | 0 B |
| requirements.txt | manifest | 51 B |
| scripts/__init__.py | script | 0 B |
| scripts/fb_hotel_api.py | script | 19.1 KB |
| scripts/formatter.py | script | 20.9 KB |
| scripts/openai_adapter.py | script | 16.3 KB |
scripts/fb_hotel_api.py
View on GitHub#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
分贝通酒店预订 API 封装
版本: 3.1.0 | 最后更新: 2026-03-25
基于新的统一接口入口: /business/hotel/open/push/skill/access
所有操作通过 skill_type 参数区分
支持鉴权 token 自动保存到 ~/.fbt-auth.json
"""
import requests
import json
import sys
import time
import os
from typing import List, Dict, Optional, Any
from pathlib import Path
from datetime import datetime
# ==================== 配置 ====================
# FAT 测试环境
FAT_BASE_URL = "https://app-gate.fenbeitong.com"
# 线上环境
PROD_BASE_URL = "https://app-gate.fenbeitong.com"
# 当前使用环境
BASE_URL = FAT_BASE_URL
API_PATH = "/business/hotel/open/push/skill/access"
# 默认 access-token(测试用)
DEFAULT_ACCESS_TOKEN = "fbsk-2db251f6c8d74ce69ae3dcb82ed1055b"
# 鉴权信息保存路径
AUTH_FILE = Path.home() / ".fbt-auth.json"
# ==================== Skill Types ====================
SKILL_TYPES = {
# 认证类(需要登录验证)
"getMobileCaptcha": "获取手机号验证码",
"getIdentityCode": "获取身份编码接口",
# 酒店查询类
"searchHotelList": "搜索酒店列表",
"queryHotelPrice": "实时查询酒店价格详情",
"queryHotelDetail": "查询酒店扩展详情",
"queryHotelComment": "查询酒店评论",
# 订单类
"createOrder": "酒店下单",
"cancelOrder": "取消订单",
"queryOrder": "查询订单",
}
# ==================== Token 存储管理 ====================
def save_auth_token(token: str, mobile: str = None) -> bool:
"""
保存认证 token 到 ~/.fbt-auth.json
Args:
token: identity_code (access-token)
mobile: 手机号(可选)
Returns:
是否保存成功
"""
try:
auth_data = {
"identity_code": token,
"mobile": mobile,
"created_at": datetime.now().isoformat(),
"updated_at": datetime.now().isoformat()
}
# 如果文件已存在,保留部分字段
if AUTH_FILE.exists():
try:
existing = json.loads(AUTH_FILE.read_text())
auth_data["mobile"] = mobile or existing.get("mobile")
auth_data["created_at"] = existing.get("created_at", auth_data["created_at"])
except:
pass
AUTH_FILE.write_text(json.dumps(auth_data, ensure_ascii=False, indent=2))
return True
except Exception as e:
print(f"[fbsk-hotel] 保存token失败: {e}")
return False
def load_auth_token() -> Optional[str]:
"""
从 ~/.fbt-auth.json 读取已保存的 token
Returns:
identity_code 或 None
"""
try:
if AUTH_FILE.exists():
auth_data = json.loads(AUTH_FILE.read_text())
return auth_data.get("identity_code")
except Exception as e:
print(f"[fbsk-hotel] 读取token失败: {e}")
return None
def get_auth_info() -> Optional[Dict]:
"""
获取完整的认证信息
Returns:
{"identity_code": "...", "mobile": "...", "created_at": "..."} 或 None
"""
try:
if AUTH_FILE.exists():
return json.loads(AUTH_FILE.read_text())
except:
pass
return None
def clear_auth_token() -> bool:
"""
清除保存的认证信息
Returns:
是否清除成功
"""
try:
if AUTH_FILE.exists():
AUTH_FILE.unlink()
return True
except:
return False
class FbHotelApiError(Exception):
"""分贝通酒店API异常"""
pass
class FbHotelApi:
"""分贝通酒店API客户端"""
def __init__(self, access_token: str = None, context: Optional[Dict] = None):
"""
初始化API客户端
Token 获取优先级:
1. 参数传入的 access_token
2. 从 ~/.fbt-auth.json 读取已保存的 token
3. 使用默认 token(测试用)
Args:
access_token: 身份编码(可选)
context: 用户上下文信息
"""
self.context = context
self.session = requests.Session()
self.base_url = BASE_URL
self.api_path = API_PATH
# 获取 token(优先级:参数 > 文件 > 默认)
if access_token:
self.access_token = access_token
else:
saved_token = load_auth_token()
self.access_token = saved_token or DEFAULT_ACCESS_TOKEN
def _get_headers(self, with_auth: bool = True) -> Dict:
"""获取请求头"""
headers = {
"Content-Type": "application/json"
}
if with_auth:
headers["access-token"] = self.access_token
return headers
def _request(self, skill_type: str, data: Dict = None, with_auth: bool = True) -> Dict:
"""
通用请求方法
Args:
skill_type: 技能类型
data: 请求参数
with_auth: 是否需要认证header
Returns:
接口响应
"""
url = f"{self.base_url}{self.api_path}"
# 构建请求体
body = {"skill_type": skill_type}
if data:
body.update(data)
headers = self._get_headers(with_auth)
try:
response = self.session.post(
url,
json=body,
headers=headers,
timeout=30
)
response.raise_for_status()
res_json = response.json()
# 检查响应状态
if res_json.get("code") == 0 or res_json.get("success"):
return res_json
else:
error_msg = res_json.get("msg", res_json.get("message", "未知错误"))
raise FbHotelApiError(f"接口失败: {error_msg}")
except requests.exceptions.RequestException as e:
raise FbHotelApiError(f"网络请求失败: {str(e)}")
except json.JSONDecodeError:
raise FbHotelApiError("接口响应非JSON格式")
except Exception as e:
raise FbHotelApiError(f"请求异常: {str(e)}")
# ==================== 认证类接口 ====================
def send_captcha(self, mobile: str) -> Dict:
"""
发送手机验证码
Args:
mobile: 手机号
Returns:
{"code": 0, "msg": "success", "data": true}
"""
return self._request(
"getMobileCaptcha",
{"mobile": mobile},
with_auth=False
)
def verify_captcha(self, mobile: str, captcha: str) -> Dict:
"""
验证验证码并获取身份编码
Args:
mobile: 手机号
captcha: 验证码
Returns:
{"code": 0, "data": {"identity_code": "fbsk-xxx"}}
"""
return self._request(
"getIdentityCode",
{"mobile": mobile, "captcha": captcha},
with_auth=False
)
# ==================== 酒店查询接口 ====================
def search_hotel_list(
self,
city_name: str,
keywords: str = "",
hotel_name: str = "",
page_index: int = 1,
page_size: int = 5
) -> Dict:
"""
搜索酒店列表
Args:
city_name: 城市名称(如"北京市")
keywords: 关键词(用户输入的全部内容,原样传递)
hotel_name: 酒店名称
page_index: 页码
page_size: 每页数量
Returns:
酒店列表数据
"""
data = {
"city_name": city_name,
"keywords": keywords,
"hotel_name": hotel_name,
"page_index": page_index,
"page_size": page_size
}
return self._request("searchHotelList", data)
def query_hotel_price(
self,
hotel_id: str,
check_in_date: str,
check_out_date: str,
payment_type: str = "PP",
nation_type: int = 1
) -> Dict:
"""
查询酒店价格详情(含房型和产品)
Args:
hotel_id: 酒店ID
check_in_date: 入住日期 yyyy-MM-dd
check_out_date: 退房日期 yyyy-MM-dd
payment_type: 支付方式 PP=预付 SP=现付
nation_type: 1=国内 2=国际
Returns:
酒店详情 + 房型 + 产品数据
"""
data = {
"hotel_id": hotel_id,
"check_in_date": check_in_date,
"check_out_date": check_out_date,
"payment_type": payment_type,
"nation_type": nation_type
}
return self._request("queryHotelPrice", data)
def query_hotel_detail(self, hotel_id: str) -> Dict:
"""
查询酒店扩展详情
Args:
hotel_id: 酒店ID
Returns:
酒店详细信息(星级、评分、地址、电话、周边等)
"""
return self._request("queryHotelDetail", {"hotel_id": hotel_id})
def query_hotel_comment(
self,
hotel_id: str,
page_index: int = 1,
page_size: int = 5
) -> Dict:
"""
查询酒店评论
Args:
hotel_id: 酒店ID
page_index: 页码
page_size: 每页数量
Returns:
酒店评论数据
"""
data = {
"hotel_id": hotel_id,
"page_index": page_index,
"page_size": page_size
}
return self._request("queryHotelComment", data)
# ==================== 订单接口 ====================
def create_order(
self,
hotel_id: str,
room_id: str,
plan_id: str,
check_in_date: str,
check_out_date: str,
total_price: float,
contact: Dict,
guest_list: List = None,
room_count: int = 1,
payment_type: str = "PP",
nation_type: int = 1
) -> Dict:
"""
创建酒店订单
Args:
hotel_id: 酒店ID
room_id: 房型ID
plan_id: 产品ID(plan_id)
check_in_date: 入住日期
check_out_date: 退房日期
total_price: 总价
contact: 联系人 {"name": "", "phone": ""}
guest_list: 入住人列表(二维数组)
room_count: 房间数
payment_type: 支付方式
nation_type: 1=国内 2=国际
Returns:
订单创建结果,包含 order_id
"""
# 生成第三方订单ID
third_order_id = f"SK{int(time.time() * 1000)}"
data = {
"nation_type": nation_type,
"payment_type": payment_type,
"hotel_id": hotel_id,
"check_in_date": check_in_date,
"check_out_date": check_out_date,
"room_id": room_id,
"plan_id": plan_id,
"total_price": total_price,
"room_count": room_count,
"contact": contact
}
if guest_list:
data["guestList1"] = guest_list
return self._request("createOrder", data)
def cancel_order(self, order_id: str, cancel_reason: str = "") -> Dict:
"""
取消订单
Args:
order_id: 订单ID
cancel_reason: 取消原因
Returns:
取消结果
"""
data = {"order_id": order_id}
if cancel_reason:
data["cancel_reason"] = cancel_reason
return self._request("cancelOrder", data)
def query_order(self, order_id: str) -> Dict:
"""
查询订单详情
Args:
order_id: 订单ID
Returns:
订单详情
"""
return self._request("queryOrder", {"order_id": order_id})
# ==================== 格式化输出 ====================
def format_hotel_list(self, data: Dict, check_in_date: str = None) -> str:
"""格式化酒店列表"""
hotel_list = data.get("data", {}).get("hotel_list", [])
if not hotel_list:
return "未找到符合条件的酒店"
lines = []
date_str = f"({check_in_date}入住)" if check_in_date else ""
lines.append(f"🏨 酒店列表{date_str}\n")
lines.append("| 序号 | 酒店名称 | 星级 | 区域 | 最低价 |")
lines.append("|:---:|---------|:---:|------|---:|")
for i, h in enumerate(hotel_list[:5], 1):
name = h.get('name', '-')
star = h.get('star_level_name', '-')
district = h.get('district_name', '-')
price = h.get('min_price', '-')
if price and price != '-':
price = f"¥{int(price)}"
lines.append(f"| {i} | {name} | {star} | {district} | {price} |")
lines.append("")
lines.append("💡 回复序号查看房型价格,如 \"1\"")
lines.append("💡 回复 \"序号-详情\" 查看酒店信息和评论,如 \"1-详情\"")
return "\n".join(lines)
def format_hotel_price(self, data: Dict, check_in: str, check_out: str) -> str:
"""格式化酒店价格详情"""
hotel = data.get("data", {}).get("hotel", {})
rooms = data.get("data", {}).get("rooms", [])
if not rooms:
return "暂无可用房型"
lines = []
lines.append(f"🏨 {hotel.get('name', '-')}")
lines.append(f"📍 {hotel.get('address', '-')} | ⭐{hotel.get('score', '-')}分 | {hotel.get('star_level_name', '-')}")
lines.append(f"📅 入住:{check_in} → 退房:{check_out}\n")
# 过滤有效房型
valid_rooms = []
for room in rooms:
if not room.get('status', False):
continue
plan_list = room.get('plan_list', [])
valid_plans = [p for p in plan_list if p.get('status', False)]
if valid_plans:
valid_plans.sort(key=lambda x: float(x.get('total_price', 999999)))
room['_valid_plans'] = valid_plans
room['_min_price'] = float(valid_plans[0].get('total_price', 0))
valid_rooms.append(room)
valid_rooms.sort(key=lambda x: x.get('_min_price', 999999))
for i, room in enumerate(valid_rooms[:5], 1):
room_name = room.get('room_name', '-')
bed_type = room.get('bed_type', '-')
window_type = room.get('window_type', '-')
area = room.get('area', '-')
lines.append(f"**房型{i}:{room_name}**")
lines.append(f"床型:{bed_type} | 窗户:{window_type} | 面积:{area}")
lines.append("| 序号 | 价格 | 早餐 | 取消政策 | 取消详情 |")
lines.append("|:---:|---:|:---:|:---:|---|")
for j, p in enumerate(room.get('_valid_plans', [])[:5], 1):
price = float(p.get('total_price', 0))
breakfast = p.get('breakfast', {}).get('value', '无早')
cancel_type = p.get('cancel_type', {}).get('value', '-')
cancel_rule = p.get('cancel_rule', '-')
emoji = '✅' if '限时' in cancel_type or '免费' in cancel_type else ''
lines.append(f"| {i}-{j} | ¥{int(price)} | {breakfast} | {emoji}{cancel_type} | {cancel_rule[:30]}... |")
lines.append("")
lines.append("💡 回复 \"房型序号-产品序号\" 预订,如 \"1-1\"")
return "\n".join(lines)
def format_order_result(self, data: Dict, check_in: str, check_out: str, room_name: str, total_price: float) -> str:
"""格式化订单创建结果"""
order_data = data.get("data", {})
order_id = order_data.get("order_id", "")
last_cancel_time = order_data.get("last_cancel_time", "")
lines = []
lines.append("✅ 订单创建成功!\n")
lines.append(f"🏨 订单号:{order_id}")
lines.append(f"📅 入住:{check_in} → 退房:{check_out}")
lines.append(f"🛏️ 房型:{room_name}")
lines.append(f"💰 价格:¥{int(total_price)}")
if last_cancel_time:
lines.append(f"📋 最晚取消时间:{last_cancel_time}")
lines.append("")
# 支付链接
pay_url = f"{self.base_url}/business/hotel/open/push/redirect?orderId={order_id}&type=0&token={self.access_token}"
detail_url = f"{self.base_url}/business/hotel/open/push/redirect?orderId={order_id}&type=1&token={self.access_token}"
lines.append(f"🔗 [立即支付]({pay_url})")
lines.append(f"🔗 [查看订单详情]({detail_url})")
return "\n".join(lines)
# ==================== 认证辅助函数 ====================
def send_verification_code(mobile: str) -> Dict:
"""
发送验证码(独立函数,不需要token)
Args:
mobile: 手机号
Returns:
发送结果
"""
api = FbHotelApi()
return api.send_captcha(mobile)
def verify_and_get_token(mobile: str, captcha: str) -> tuple:
"""
验证验证码并获取token,成功后自动保存到 ~/.fbt-auth.json
Args:
mobile: 手机号
captcha: 验证码
Returns:
(success, identity_code or error_message)
"""
api = FbHotelApi()
try:
result = api.verify_captcha(mobile, captcha)
identity_code = result.get("data", {}).get("identity_code", "")
if identity_code:
# 自动保存到文件
if save_auth_token(identity_code, mobile):
return True, identity_code
else:
return True, identity_code # 返回成功但提示保存失败
return False, "获取身份编码失败"
except FbHotelApiError as e:
return False, str(e)
# ==================== 测试代码 ====================
if __name__ == "__main__":
print("=" * 60)
print("分贝通酒店API测试")
print("=" * 60)
api = FbHotelApi()
# 测试搜索酒店
print("\n1. 测试搜索酒店...")
try:
result = api.search_hotel_list(
city_name="北京市",
keywords="国贸附近",
page_size=5
)
print("搜索成功!")
print(api.format_hotel_list(result))
except FbHotelApiError as e:
print(f"搜索失败: {e}")
# 测试查询酒店价格
print("\n2. 测试查询酒店价格...")
try:
result = api.query_hotel_price(
hotel_id="5a39df2fbbfdc4732360e860",
check_in_date="2026-03-27",
check_out_date="2026-03-28"
)
print("查询成功!")
print(json.dumps(result, ensure_ascii=False, indent=2)[:500])
except FbHotelApiError as e:
print(f"查询失败: {e}")Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |