hotel-price-check

酒店比价助手，对比携程、美团、同程、去哪儿、华住会、锦江会、飞猪等OTA平台相同酒店房型价格，给出最优推荐。Invoke when user wants to compare hotel prices across multiple OTA platforms or find the best hotel deal.

Security Scan

The skill's purpose (calling multiple OTA APIs to return live prices) aligns with the code, but there are notable mismatches — the code contains placeholder TODOs and the skill does not declare or request any OTA credentials or endpoints, which is inconsistent with its stated requirement to call real OTA APIs.

Purpose & Capability

The skill claims to call multiple OTA platform APIs to fetch real-time prices, and the included Python modules are a plausible implementation scaffold. However, all per‑platform fetch methods are stubs (TODOs) and there are no API endpoints, credential fields, or instructions for authenticating to the OTA providers. A practical multi‑OTA integrator would normally require API keys, client IDs, cookies, or scraping logic; the skill declares none of these.

Instruction Scope

SKILL.md instructs the agent to call OTA APIs, not to fabricate data, and to display source/time. The included code sticks to those boundaries (network requests via requests.Session). The instructions do not ask the agent to read unrelated files or exfiltrate unrelated data.

Install Mechanism

This is effectively an instruction-only skill with bundled Python source; there is no install spec that downloads external archives or binaries. Required binary is python3, which is proportionate for running the provided scripts.

Credentials

No environment variables or credentials are declared despite the SKILL.md requirement to '必须调用各OTA平台的API获取真实价格数据'. OTA APIs typically require credentials, cookies, or custom headers; absence of declared secrets is inconsistent and may indicate the implementation is incomplete or expects the user to supply credentials in an ad‑hoc, potentially insecure way.

Persistence & Privilege

The skill does not request permanent/autonomous elevation (always:false). It does not modify other skills or system configuration in the provided code. Normal autonomous invocation is enabled by platform defaults.

What to consider before installing

This skill is plausible but incomplete. Before installing or using it: (1) Ask the author how OTA APIs will be authenticated and where API keys/cookies should be stored; do not paste credentials into chat. (2) Request concrete implementations for the per‑platform fetch methods and the exact endpoints the skill will call. (3) Verify where any sensitive data (API keys, cookies) must be provided and prefer secure secret storage (not direct chat). (4) If you must test, run the code in a restricted sandbox and monitor outbound network calls to ensure requests go only to legitimate OTA domains. (5) If the author expects you to provide account cookies or tokens, treat that as higher-risk and require justification and secure handling.

酒店比价助手 (fb-hotel-comparison-skill)

技能描述

酒店比价助手，实时对比携程、美团、同程、去哪儿、华住会、锦江会、飞猪等OTA平台相同酒店下所有房型产品的报价，通过智能算法给出最优推荐。

---

⚠️ 【重要约束】

• 必须调用各OTA平台的API获取真实价格数据
• 禁止自行编造价格信息
• 接口返回什么数据就展示什么，不要修改
• 比价结果需标明数据来源和采集时间

---

技能概述

基于多平台OTA API开发的酒店比价技能，支持：

• 多平台酒店价格实时抓取
• 同酒店同房型跨平台价格对比
• 智能最优推荐算法（综合考虑价格、取消政策、早餐、积分等）
• 价格趋势分析和预订建议

技能能力

核心能力

1. 多平台价格抓取：同时查询携程、美团、同程、去哪儿、华住会、锦江会、飞猪等平台
2. 智能比价：同酒店同房型跨平台价格对比
3. 最优推荐：基于价格、政策、权益综合评分推荐最优选择
4. 价格监控：支持设置价格提醒，降价通知

触发条件

1. 酒店比价：当用户输入「比价/对比/哪个便宜/最优惠」+ 酒店名称时

   • 调用多平台API获取价格
   • 展示各平台同房型价格对比表格
   • 给出最优推荐

2. 展示格式示例：

   🏨 桔子酒店(北京燕莎三元桥店) - 多平台比价
   📅 入住：3月15日 → 退房：3月16日
   🛏️ 房型：高级大床房
   
   | 平台 | 价格 | 早餐 | 取消政策 | 会员权益 | 推荐指数 |
   |:---:|---:|:---:|:---|:---|:---:|
   | 🥇 携程 | ¥483 | 含早 | 限时取消 | 积分+早餐 | ⭐⭐⭐⭐⭐ |
   | 美团 | ¥526 | 无早 | 不可取消 | 无 | ⭐⭐⭐ |
   | 同程 | ¥498 | 含早 | 限时取消 | 积分 | ⭐⭐⭐⭐ |
   | 飞猪 | ¥510 | 无早 | 限时取消 | 积分 | ⭐⭐⭐⭐ |
   
   💡 最优推荐：携程 ¥483（含早+限时取消+积分）
   🔗 [立即预订-携程](https://...)
   

对接平台

支持OTA平台

平台	标识	特点
携程	ctrip	价格优势明显，会员权益丰富
美团	meituan	本地生活场景多，优惠券多
同程	tongcheng	微信生态，返现活动多
去哪儿	qunar	低价策略，学生优惠
华住会	huazhu	自有会员体系，积分价值高
锦江会	jinjiang	会员折扣力度大
飞猪	fliggy	阿里生态，信用住免押金

核心接口列表

一、查询类接口

接口名称	核心用途	必选参数
search_hotel_prices	多平台酒店价格查询	hotel_name, city, check_in, check_out, platforms
get_price_trend	价格趋势分析	hotel_id, room_type, days
get_best_deal	获取最优推荐	hotel_name, city, check_in, check_out

二、数据类接口

接口名称	核心用途	说明
compare_platforms	多平台对比	返回结构化对比数据
calculate_recommendation	计算推荐分数	基于多维度算法评分

推荐算法

评分维度

维度	权重	说明
价格	40%	基础价格对比
取消政策	20%	限时取消 > 不可取消
早餐权益	15%	含早 > 无早
会员权益	15%	积分、升级等
平台信誉	10%	服务保障、退改政策

推荐指数

• ⭐⭐⭐⭐⭐ (90-100分)：强烈推荐，综合最优
• ⭐⭐⭐⭐ (75-89分)：推荐，某方面突出
• ⭐⭐⭐ (60-74分)：一般，可考虑
• ⭐⭐ (40-59分)：不推荐
• ⭐ (0-39分)：强烈不推荐

响应规则

成功响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "hotel_name": "桔子酒店(北京燕莎三元桥店)",
    "check_in": "2026-03-15",
    "check_out": "2026-03-16",
    "room_type": "高级大床房",
    "platforms": [
      {
        "platform": "携程",
        "price": 483,
        "breakfast": "含早",
        "cancel_policy": "限时取消",
        "benefits": ["积分", "早餐"],
        "score": 95,
        "recommendation": "⭐⭐⭐⭐⭐"
      }
    ],
    "best_deal": {
      "platform": "携程",
      "price": 483,
      "savings": 43,
      "reason": "价格最低且含早餐"
    }
  }
}

失败响应

{
  "code": 500,
  "msg": "错误信息",
  "data": null
}