opencode-skills-collection 4.1.16 → 4.1.18

package/bundled-skills/takeout-coupon/scripts/fetch_coupons.py

@@ -0,0 +1,221 @@
+#!/usr/bin/env python3
+"""
+外卖优惠券获取脚本
+调用API获取各平台外卖优惠券信息
+
+API地址: https://agskills.moontai.top/coupon/takeout
+"""
+
+import json
+import requests
+from typing import Optional, Dict, List, Any
+
+import os
+import uuid
+
+# API配置
+API_BASE_URL = "https://agskills.moontai.top"
+
+
+# 归因配置：渠道标识 + 安装uuid，由中转服务烘焙进 CPS sid 做归因
+CHANNEL = "takeout"
+
+
+def _load_install_id() -> str:
+    """首次运行生成uuid并持久化到 scripts/.install_id，用于渠道归因。"""
+    id_file = os.path.join(os.path.dirname(os.path.abspath(__file__)), '.install_id')
+    try:
+        with open(id_file, 'r', encoding='utf-8') as f:
+            install_id = f.read().strip()
+            if install_id:
+                return install_id
+    except OSError:
+        pass
+    install_id = uuid.uuid4().hex
+    try:
+        with open(id_file, 'w', encoding='utf-8') as f:
+            f.write(install_id)
+    except OSError:
+        pass
+    return install_id
+
+
+
+class CouponFetcher:
+    """外卖优惠券获取器"""
+
+    def __init__(self, base_url: str = API_BASE_URL):
+        self.base_url = base_url.rstrip('/')
+        self.session = requests.Session()
+        self.session.params.update({
+            'ch': CHANNEL,
+            'u': _load_install_id(),
+        })
+        self.session.headers.update({
+            'Content-Type': 'application/json',
+            'User-Agent': 'XiaFan-CouponFetcher/2.0'
+        })
+
+    def get_coupons(self) -> Dict[str, Any]:
+        """
+        获取外卖优惠券列表
+
+        Returns:
+            API响应结果，包含以下字段:
+            - 美团隐藏外卖券列表
+            - 饿了么/淘宝闪购隐藏外卖券列表
+            - 京东隐藏外卖券列表
+            - 聚合H5页面
+        """
+        endpoint = f"{self.base_url}/coupon/takeout"
+
+        try:
+            response = self.session.get(endpoint, timeout=10)
+            response.raise_for_status()
+            return response.json()
+        except requests.RequestException as e:
+            return {
+                "error": True,
+                "message": f"API请求失败: {str(e)}"
+            }
+
+    def get_meituan_coupons(self) -> List[Dict[str, Any]]:
+        """获取美团外卖优惠券"""
+        data = self.get_coupons()
+        if "error" in data:
+            return []
+        return data.get("美团隐藏外卖券列表", [])
+
+    def get_eleme_coupons(self) -> List[Dict[str, Any]]:
+        """获取饿了么/淘宝闪购优惠券"""
+        data = self.get_coupons()
+        if "error" in data:
+            return []
+        return data.get("饿了么/淘宝闪购隐藏外卖券列表", [])
+
+    def get_jd_coupons(self) -> List[Dict[str, Any]]:
+        """获取京东外卖优惠券"""
+        data = self.get_coupons()
+        if "error" in data:
+            return []
+        return data.get("京东隐藏外卖券列表", [])
+
+    def get_h5_page(self) -> Optional[Dict[str, Any]]:
+        """获取聚合H5页面信息"""
+        data = self.get_coupons()
+        if "error" in data:
+            return None
+        return data.get("聚合H5页面")
+
+
+def format_coupon_display(coupon: Dict[str, Any], platform: str) -> str:
+    """
+    格式化单条优惠券显示信息
+
+    Args:
+        coupon: 优惠券数据
+        platform: 平台名称
+
+    Returns:
+        格式化的字符串
+    """
+    title = coupon.get("title", "优惠券")
+    # coupon_code 必须原样呈现，禁止修改任何字符
+    coupon_code = coupon.get("coupon_code", "")
+    guideline = coupon.get("guideline", "")
+
+    lines = [
+        f"【{platform}】{title}",
+        f"   优惠券代码：{coupon_code}",
+        f"   领取说明：{guideline}"
+    ]
+
+    return "\n".join(lines)
+
+
+def format_coupons_list(data: Dict[str, Any]) -> str:
+    """
+    格式化优惠券列表显示
+
+    Args:
+        data: API返回的完整数据
+
+    Returns:
+        格式化的字符串
+    """
+    if "error" in data:
+        return f"获取失败: {data.get('message', '未知错误')}"
+
+    result = []
+
+    # 美团优惠券
+    meituan_list = data.get("美团隐藏外卖券列表", [])
+    if meituan_list:
+        result.append("【美团外卖】")
+        for i, coupon in enumerate(meituan_list, 1):
+            result.append(f"{i}. {format_coupon_display(coupon, '美团')}")
+            result.append("")
+        result.append("")
+
+    # 饿了么/淘宝闪购优惠券
+    eleme_list = data.get("饿了么/淘宝闪购隐藏外卖券列表", [])
+    if eleme_list:
+        result.append("【淘宝闪购/饿了么】")
+        for i, coupon in enumerate(eleme_list, 1):
+            result.append(f"{i}. {format_coupon_display(coupon, '淘宝闪购')}")
+            result.append("")
+        result.append("")
+
+    # 京东优惠券
+    jd_list = data.get("京东隐藏外卖券列表", [])
+    if jd_list:
+        result.append("【京东外卖】")
+        for i, coupon in enumerate(jd_list, 1):
+            result.append(f"{i}. {format_coupon_display(coupon, '京东')}")
+            result.append("")
+        result.append("")
+
+    # 聚合H5页面
+    h5_page = data.get("聚合H5页面")
+    if h5_page:
+        result.append("【聚合领券页面】")
+        result.append(f"   二维码图片：{h5_page.get('coupon_h5_qrcode_img_url', '')}")
+        result.append(f"   领取说明：{h5_page.get('guideline', '')}")
+
+    return "\n".join(result)
+
+
+# 主函数 - 支持命令行调用
+if __name__ == "__main__":
+    import argparse
+
+    parser = argparse.ArgumentParser(description="外卖优惠券获取工具")
+    parser.add_argument("--platform", "-p", choices=["all", "meituan", "eleme", "jd"],
+                        default="all", help="平台类型: all/meituan/eleme/jd")
+    parser.add_argument("--json", "-j", action="store_true",
+                        help="输出原始JSON数据")
+
+    args = parser.parse_args()
+
+    fetcher = CouponFetcher()
+
+    if args.json:
+        # 输出原始JSON
+        result = fetcher.get_coupons()
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+    elif args.platform == "all" or args.platform == "全部":
+        # 输出格式化后的列表
+        result = fetcher.get_coupons()
+        print(format_coupons_list(result))
+    elif args.platform == "meituan" or args.platform == "美团":
+        coupons = fetcher.get_meituan_coupons()
+        for i, coupon in enumerate(coupons, 1):
+            print(f"{i}. {format_coupon_display(coupon, '美团')}")
+    elif args.platform == "eleme" or args.platform == "饿了么" or args.platform == "淘宝闪购":
+        coupons = fetcher.get_eleme_coupons()
+        for i, coupon in enumerate(coupons, 1):
+            print(f"{i}. {format_coupon_display(coupon, '淘宝闪购')}")
+    elif args.platform == "jd" or args.platform == "京东":
+        coupons = fetcher.get_jd_coupons()
+        for i, coupon in enumerate(coupons, 1):
+            print(f"{i}. {format_coupon_display(coupon, '京东')}")

package/bundled-skills/trip-coupon/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: trip-coupon
+description: "Call trip/travel coupon API to fetch travel coupons including DiDi ride-hailing gift packages and hotel coupon bundles. Returns coupon links and QR code images for users to redeem via WeChat."
+category: shopping
+risk: safe
+source: community
+source_repo: moooai/trip-coupon
+source_type: community
+date_added: "2026-10-16"
+author: moooai
+tags: [coupons, travel, didi, hotel, ride-hailing]
+tools: [claude, codex]
+---
+
+# Travel Coupons (Ride-hailing / Hotels)
+
+## Overview
+
+Fetches travel coupons: Didi ride-hailing voucher bundles and hotel deals from Meituan, Tongcheng and Fliggy. Returns claim-page links (H5) and QR code images rather than text codes.
+
+The skill is adapted from the open-source repository `moooai/trip-coupon`. It ships with a fetch script (`scripts/fetch_coupons.py`) and full API documentation (`references/api_documentation.md`). No API keys or credentials are required - the public endpoint is free to call.
+
+## When to Use This Skill
+
+- Use when the user asks about ride-hailing or hotel coupons, red packets (hongbao) or hidden promo codes
+- Use when the user wants to know which platform has the best ride-hailing or hotel deal today
+- Use when the user cannot copy a coupon code and needs a QR code or H5 claim page instead
+
+## How It Works
+
+### Step 1: Fetch the coupon feed
+
+Call `GET https://agskills.moontai.top/coupon/trip` (no auth). `scripts/fetch_coupons.py` does this and additionally appends anonymous attribution parameters (`ch`, `u`) used for install/order attribution statistics.
+
+### Step 2: Parse and organize the response
+
+The response is JSON. The response is a JSON array; each item has `title`, `guideline`, and usually `coupon_url` plus `coupon_qrcode_img_url`.
+
+### Step 3: Present coupons to the user
+
+For each coupon show: title, coupon code (verbatim), and claim guideline. For entries with `coupon_url` / `coupon_qrcode_img_url`, show the claim-page link and/or QR code image. Highlight featured coupons (marked with 🔥 or "主推") first.
+
+## The Coupon Code Verbatim Rule (critical)
+
+`coupon_code` values are platform-specific taokouling (口令) strings that may contain `%`, `￥`, `＄`, `✔`, `！` and other special characters. They are only recognized by the target app if copied exactly.
+
+- ❌ Do not add, remove, reformat, translate or "beautify" any character of `coupon_code`
+- ❌ Do not URL-encode or escape special characters
+- ✅ Render the string exactly as returned by the API, together with its `guideline`
+
+## Examples
+
+### Example: user asks for coupons
+
+**User:** "Any Didi ride-hailing or hotel coupons?"
+
+**Flow:** call `GET https://agskills.moontai.top/coupon/trip`, then present each coupon as:
+
+```
+【Didi / Hotels】
+1. <title>
+   Coupon code: <coupon_code verbatim>
+   How to claim: <guideline>
+```
+
+For entries carrying `coupon_url`/`coupon_qrcode_img_url`, additionally offer the claim link (best opened in WeChat) and the QR code image.
+
+## Best Practices
+
+- ✅ Show the claim guideline next to every coupon code
+- ✅ Fall back to the QR/H5 claim page when the user cannot copy codes
+- ✅ Skip platforms whose coupon list is empty and say so
+- ❌ Never modify a `coupon_code` string in any way
+- ❌ Do not cache coupons for long - feeds refresh and codes expire
+
+## Limitations
+
+- Coupons are for mainland-China platforms; apps (Meituan, Taobao, JD, WeChat, etc.) and a Chinese phone number may be required to redeem
+- Feed availability depends on the upstream API; on failure, tell the user to retry later
+- This skill does not replace the apps themselves - codes must be redeemed inside the official apps
+
+## Security & Safety Notes
+
+- The only network operation is a read-only `GET` to the public endpoint `https://agskills.moontai.top/coupon/trip` (domain `agskills.moontai.top`); no credentials, tokens or user data are sent beyond anonymous attribution parameters (`ch`, `u`) documented in the repo
+- `scripts/fetch_coupons.py` performs no local file mutation, no shell execution and no installs
+- `risk: safe` reflects read-only network documentation; re-evaluate if the upstream API changes
+
+## Common Pitfalls
+
+- **Problem:** Coupon code does not work in the target app
+  **Solution:** Check that the code was copied with every special character intact; offer the QR/H5 claim page as fallback
+
+## Related Skills
+
+- `@obtain-coupons-all-in-one` - all-in-one coupon fetcher covering takeout, travel, movie and parcel

package/bundled-skills/trip-coupon/references/api_documentation.md

@@ -0,0 +1,73 @@
+# 出行优惠券API接口文档
+
+## 接口信息
+
+| 配置项 | 值 |
+|--------|-----|
+| 接口地址 | `https://agskills.moontai.top/coupon/trip` |
+| 请求方法 | GET |
+| 认证方式 | 无需认证 |
+| 返回格式 | JSON（数组） |
+
+## 接口说明
+
+获取出行优惠券列表，包括滴滴出行大礼包（打车券天天领）、酒店优惠大礼包（住宿出行天天领），以及「更多优惠券」公众号领券入口。
+
+## 请求示例
+
+```
+GET https://agskills.moontai.top/coupon/trip
+```
+
+无请求参数，直接调用即可。
+
+## 响应结构
+
+```json
+[
+  {
+    "title": "滴滴出行大礼包，打车券天天领",
+    "coupon_url": "https://h5.sichuanyunzhan.com/pages_single/didi/index?platform=singlePage&pid=e467cdcafe2b1791cdfc&accountsId=nEjX0zy4Zmyq",
+    "coupon_qrcode_img_url": "https://moontai-static.oss-cn-shenzhen.aliyuncs.com/didi-64c76f2b-0bf5-483f-beb9-57061c31f3e0.png",
+    "guideline": "点击链接领券(建议用微信打开)，或使用微信扫描二维码领券"
+  },
+  {
+    "title": "酒店优惠大礼包，住宿出行天天领",
+    "coupon_url": "https://h5.sichuanyunzhan.com/pages_single/hotel/index?platform=singlePage&pid=e467cdcafe2b1791cdfc&accountsId=nEjX0zy4Zmyq",
+    "coupon_qrcode_img_url": "https://moontai-static.oss-cn-shenzhen.aliyuncs.com/hotel-661139fb-17c1-4b88-a42b-7a02054af1b5.png",
+    "guideline": "点击链接领券(建议用微信打开)，或使用微信扫描二维码领券"
+  },
+  {
+    "title": "更多优惠券！（外卖、电影、快递、旅游、打车)",
+    "coupon_h5_qrcode_img_url": "https://moontai-static.oss-cn-shenzhen.aliyuncs.com/qrcode_for_gh.jpg",
+    "guideline": "可以使用微信扫码后领券。关注不迷路，天天领券！"
+  }
+]```
+
+## 响应参数
+
+| 字段路径 | 类型 | 说明 |
+|----------|------|------|
+| [].title | String | 优惠券标题 |
+| [].coupon_url | String | **优惠券链接，原样呈现，禁止修改**，建议在微信中打开 |
+| [].coupon_qrcode_img_url | String | **二维码图片URL，原样呈现，禁止修改**，建议使用微信扫码 |
+| [].coupon_h5_qrcode_img_url | String | 公众号二维码图片URL（仅「更多优惠券」入口项有，微信扫码领全品类券） |
+| [].guideline | String | 领取说明 |
+
+## 重要说明
+
+### URL 处理规则
+
+**严格禁止修改 coupon_url / coupon_qrcode_img_url / coupon_h5_qrcode_img_url 字段的任何内容！**
+
+- URL 链接必须原样保持
+- 禁止添加空格、换行或任何格式化
+- 禁止翻译、解释或重新排列链接顺序
+
+## 错误码
+
+| 情况 | 说明 |
+|------|------|
+| 正常返回 | 返回JSON数组数据 |
+| 网络错误 | 返回"无法获取优惠券信息，请稍后重试" |
+| 解析错误 | 返回"数据解析异常，请联系技术支持" |

package/bundled-skills/trip-coupon/scripts/fetch_coupons.py

@@ -0,0 +1,194 @@
+#!/usr/bin/env python3
+"""
+出行优惠券获取脚本
+调用API获取滴滴出行和携程礼包优惠券信息
+
+API地址: https://agskills.moontai.top/coupon/trip
+"""
+
+import json
+import requests
+from typing import Optional, Dict, List, Any
+
+import os
+import uuid
+
+# API配置
+API_BASE_URL = "https://agskills.moontai.top"
+
+
+# 归因配置：渠道标识 + 安装uuid，由中转服务烘焙进 CPS sid 做归因
+CHANNEL = "trip"
+
+
+def _load_install_id() -> str:
+    """首次运行生成uuid并持久化到 scripts/.install_id，用于渠道归因。"""
+    id_file = os.path.join(os.path.dirname(os.path.abspath(__file__)), '.install_id')
+    try:
+        with open(id_file, 'r', encoding='utf-8') as f:
+            install_id = f.read().strip()
+            if install_id:
+                return install_id
+    except OSError:
+        pass
+    install_id = uuid.uuid4().hex
+    try:
+        with open(id_file, 'w', encoding='utf-8') as f:
+            f.write(install_id)
+    except OSError:
+        pass
+    return install_id
+
+
+
+class CouponFetcher:
+    """出行优惠券获取器"""
+
+    def __init__(self, base_url: str = API_BASE_URL):
+        self.base_url = base_url.rstrip('/')
+        self.session = requests.Session()
+        self.session.params.update({
+            'ch': CHANNEL,
+            'u': _load_install_id(),
+        })
+        self.session.headers.update({
+            'Content-Type': 'application/json',
+            'User-Agent': 'XiaFan-CouponFetcher/2.0'
+        })
+
+    def get_coupons(self) -> List[Dict[str, Any]]:
+        """
+        获取出行优惠券列表
+
+        Returns:
+            API响应结果，包含多个优惠券对象:
+            - 滴滴出行大礼包
+            - 携程礼包天天领
+            每个优惠券包含:
+            - title: 优惠券标题
+            - coupon_url: 优惠券链接
+            - coupon_qrcode_img_url: 二维码图片链接
+            - guideline: 使用说明
+        """
+        endpoint = f"{self.base_url}/coupon/trip"
+
+        try:
+            response = self.session.get(endpoint, timeout=10)
+            response.raise_for_status()
+            data = response.json()
+            # 确保返回的是列表
+            if isinstance(data, dict):
+                return [data]
+            elif isinstance(data, list):
+                return data
+            else:
+                return []
+        except requests.RequestException as e:
+            return [{
+                "error": True,
+                "message": f"API请求失败: {str(e)}"
+            }]
+
+    def get_didi_coupons(self) -> List[Dict[str, Any]]:
+        """获取滴滴出行优惠券"""
+        all_coupons = self.get_coupons()
+        return [c for c in all_coupons if '滴滴' in c.get('title', '')]
+
+    def get_xiecheng_coupons(self) -> List[Dict[str, Any]]:
+        """获取携程礼包优惠券"""
+        all_coupons = self.get_coupons()
+        return [c for c in all_coupons if '携程' in c.get('title', '')]
+
+
+def format_coupon_display(coupon: Dict[str, Any], platform: str) -> str:
+    """
+    格式化单条优惠券显示信息
+
+    Args:
+        coupon: 优惠券数据
+        platform: 平台名称
+
+    Returns:
+        格式化的字符串
+    """
+    title = coupon.get("title", "优惠券")
+    # coupon_url 和 coupon_qrcode_img_url 必须原样呈现，禁止修改任何字符
+    coupon_url = coupon.get("coupon_url", "")
+    coupon_qrcode_img_url = coupon.get("coupon_qrcode_img_url", "")
+    guideline = coupon.get("guideline", "")
+
+    lines = [
+        f"【{platform}】{title}",
+        f"   优惠券链接：{coupon_url}",
+        f"   （建议用微信打开）",
+        f"",
+        f"   二维码图片：{coupon_qrcode_img_url}",
+        f"   （使用微信扫描二维码领券）",
+        f"",
+        f"   使用说明：{guideline}"
+    ]
+
+    return "\n".join(lines)
+
+
+def format_coupons_list(coupons: List[Dict[str, Any]]) -> str:
+    """
+    格式化优惠券列表显示
+
+    Args:
+        coupons: API返回的优惠券列表
+
+    Returns:
+        格式化的字符串
+    """
+    if not coupons:
+        return "暂无可用优惠券"
+
+    result = []
+
+    for i, coupon in enumerate(coupons, 1):
+        # 判断平台
+        title = coupon.get("title", "")
+        if '滴滴' in title:
+            platform = "滴滴出行"
+        elif '携程' in title:
+            platform = "携程礼包"
+        else:
+            platform = "其他优惠"
+
+        result.append(f"{i}. {format_coupon_display(coupon, platform)}")
+        result.append("")
+
+    return "\n".join(result)
+
+
+# 主函数 - 支持命令行调用
+if __name__ == "__main__":
+    import argparse
+
+    parser = argparse.ArgumentParser(description="出行优惠券获取工具")
+    parser.add_argument("--platform", "-p", choices=["all", "didi", "xiecheng"],
+                        default="all", help="平台类型: all/didi/xiecheng")
+    parser.add_argument("--json", "-j", action="store_true",
+                        help="输出原始JSON数据")
+
+    args = parser.parse_args()
+
+    fetcher = CouponFetcher()
+
+    if args.json:
+        # 输出原始JSON
+        result = fetcher.get_coupons()
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+    elif args.platform == "all" or args.platform == "全部":
+        # 输出格式化后的列表
+        coupons = fetcher.get_coupons()
+        print(format_coupons_list(coupons))
+    elif args.platform == "didi" or args.platform == "滴滴":
+        coupons = fetcher.get_didi_coupons()
+        for i, coupon in enumerate(coupons, 1):
+            print(f"{i}. {format_coupon_display(coupon, '滴滴出行')}")
+    elif args.platform == "xiecheng" or args.platform == "携程":
+        coupons = fetcher.get_xiecheng_coupons()
+        for i, coupon in enumerate(coupons, 1):
+            print(f"{i}. {format_coupon_display(coupon, '携程礼包')}")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-skills-collection",
-  "version": "4.1.16",
+  "version": "4.1.18",
   "description": "OpenCode CLI plugin that automatically downloads and keeps skills up to date.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",