SkillHub

trip-coupon

v1.0.1

获取出行优惠券,支持滴滴出行大礼包、携程礼包天天领(酒店、机票、门票)。返回领取链接和二维码图片,用户可点击链接或扫描二维码在微信中领取优惠。

Sourced from ClawHub, Authored by moooai

Installation

Please help me install the skill `trip-coupon` from SkillHub official store. npx skills add moooai/trip-coupon

出行优惠券

Overview

此skill通过调用出行优惠券API接口,获取滴滴出行大礼包和携程礼包天天领(包含酒店、机票、门票)的优惠券信息。返回优惠券链接(coupon_url)和二维码图片(coupon_qrcode_img_url),供用户点击链接或扫描二维码领取优惠。

Quick Start

  1. 调用API: GET https://agskills.moontai.top/coupon/trip
  2. 解析返回的JSON数据,包含2个主要对象
  3. 按平台分类展示优惠券信息
  4. 重要: coupon_url建议在微信中打开,或使用微信扫描二维码图片

API配置

基础信息

配置项
API地址 https://agskills.moontai.top/coupon/trip
认证方式 无需认证
请求方法 GET
返回格式 JSON

响应数据结构

[
  {
    "title":"滴滴出行大礼包,打车券天天领",
    "coupon_url":"https://open.cdyunzhanxinxi.com/link/100115769b7d6d0087771002k13YX0SY",
    "coupon_qrcode_img_url":"https://moontai-static.oss-cn-shenzhen.aliyuncs.com/coupon-trip.png",
    "guideline":"点击链接领券(建议用微信打开),或使用微信扫描二维码领券"
  },
  {
    "title":"携程礼包天天领,酒店、机票、门票",
    "coupon_url":"https://open.cdyunzhanxinxi.com/link/100012769b7d927254211000c1x1UOrw",
    "coupon_qrcode_img_url":"https://moontai-static.oss-cn-shenzhen.aliyuncs.com/trip-xiecheng.png",
    "guideline":"点击链接领券(建议用微信打开),或使用微信扫描二维码领券"
  }
]

响应字段说明

字段路径 类型 说明
[].title String 优惠券标题名称
[].coupon_url String 优惠券链接URL,建议在微信中打开
[].coupon_qrcode_img_url String 优惠券二维码图片URL,建议使用微信扫码
[].guideline String 使用说明和领取指南

任务类型

1. 获取全平台出行优惠券

调用API获取滴滴出行和携程礼包的优惠券,按平台分类展示给用户。

2. 获取特定平台优惠券

根据用户指定平台,返回该平台的专属优惠券: - 滴滴出行 → 滴滴出行大礼包 - 携程 → 携程礼包天天领(酒店、机票、门票)

3. 展示优惠券链接

提供优惠券链接URL,建议用户在微信中打开。

4. 展示优惠券二维码

提供优惠券二维码图片,建议用户使用微信扫描。

When to use(触发场景)

此skill在以下场景下使用:

  1. 用户询问出行优惠相关信息,例如:
  2. "有什么出行优惠券?"
  3. "帮我找打车红包"
  4. "出行券怎么领?"
  5. "滴滴出行有什么优惠?"
  6. "携程优惠券在哪领?"
  7. "酒店、机票、门票优惠"
  8. "旅行省钱"

  9. 用户明确指定某一平台的出行优惠券,例如:

  10. "我要滴滴出行优惠券"
  11. "携程礼包优惠"
  12. "酒店优惠券"
  13. "机票优惠券"

  14. 用户遇到优惠券链接问题,例如:

  15. "优惠券链接打不开"
  16. "优惠券怎么用不了"

重要规则

coupon_url 和 coupon_qrcode_img_url 处理规则

严格原样呈现API返回的URL链接和二维码链接!

  • 不允许修改URL链接的任何部分
  • coupon_url建议在微信中打开
  • coupon_qrcode_img_url建议使用微信扫码
  • 必须原样从API获取、原样呈现给用户

使用示例

示例1: 用户请求出行优惠

用户输入: "有什么出行优惠券可以领?"

处理流程: 1. 调用 GET https://agskills.moontai.top/coupon/trip 2. 解析返回的JSON数据 3. 按平台分类展示(滴滴出行、携程礼包) 4. 每条优惠券展示:标题、优惠券链接、领取说明 5. 同时展示二维码图片

输出格式:

【滴滴出行】
1. 滴滴出行大礼包,打车券天天领
   优惠券链接:https://open.cdyunzhanxinxi.com/link/100115769b7d6d0087771002k13YX0SY
   (建议用微信打开)
   二维码图片:https://moontai-static.oss-cn-shenzhen.aliyuncs.com/coupon-trip.png
   (使用微信扫描二维码领券)
   使用说明:点击链接领券(建议用微信打开),或使用微信扫描二维码领券

【携程礼包】
2. 携程礼包天天领,酒店、机票、门票
   优惠券链接:https://open.cdyunzhanxinxi.com/link/100012769b7d927254211000c1x1UOrw
   (建议用微信打开)
   二维码图片:https://moontai-static.oss-cn-shenzhen.aliyuncs.com/trip-xiecheng.png
   (使用微信扫描二维码领券)
   使用说明:点击链接领券(建议用微信打开),或使用微信扫描二维码领券

示例2: 用户指定平台

用户输入: "帮我找滴滴的出行优惠券"

处理流程: 1. 调用API获取数据 2. 仅提取滴滴出行相关的优惠券 3. 按顺序展示滴滴出行优惠券

错误处理

  • API调用失败时,返回友好提示:"暂时无法获取优惠券信息,请稍后重试"
  • 网络异常时,提供错误原因和重试建议
  • 数据解析异常时,提示用户联系技术支持

Edge cases(边缘场景处理)

1. API调用失败

  • 场景: 网络超时、服务器不可用
  • 处理: 返回友好提示"暂时无法获取优惠券信息,请稍后重试",并建议用户稍后再试

2. 数据结构变化

  • 场景: API返回的数据结构与文档不符
  • 处理: 尽量解析可用字段,对无法解析的部分给出提示

3. 特定平台无优惠券

  • 场景: 某一平台(如携程)暂无优惠券
  • 处理: 跳过该平台,仅展示有优惠券的平台,并说明"该平台暂无优惠券"

4. 用户无法打开coupon_url

  • 场景: 用户反馈优惠券链接无法打开
  • 处理: 建议用户在微信中打开链接,或使用微信扫描二维码

5. 二维码图片无法加载

  • 场景: 二维码图片URL无法访问
  • 处理: 提示用户使用优惠券链接,建议在微信中打开

Resources

scripts/

  • fetch_coupons.py - 获取出行优惠券的主脚本

references/

  • api_documentation.md - 完整的API接口文档