opencode-skills-collection 4.1.17 → 4.1.19

package/bundled-skills/obtain-coupons-all-in-one/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: obtain-coupons-all-in-one
+description: "All-in-one coupon fetcher supporting takeout (Meituan, Ele.me, JD), parcel/courier (SF, ZTO, YTO, etc.), travel (DiDi, Ctrip), and movie tickets (Taopiaopiao, Maoyan) coupons with one-click access to all discounts."
+category: shopping
+risk: safe
+source: community
+source_repo: moooai/obtain-coupons-all-in-one
+source_type: community
+date_added: "2026-10-16"
+author: moooai
+tags: [coupons, all-in-one, takeout, travel, movie, parcel]
+tools: [claude, codex]
+---
+
+# All-in-one Coupons (Takeout / Travel / Movie / Parcel)
+
+## Overview
+
+All-in-one coupon fetcher covering the four downstream moooai coupon skills: takeout (Meituan/Ele.me/JD), travel (Didi/hotels), movie tickets and parcel/courier. Pick the right endpoint per scenario and merge results.
+
+The skill is adapted from the open-source repository `moooai/obtain-coupons-all-in-one`. 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 takeout, travel, movie or parcel coupons, red packets (hongbao) or hidden promo codes
+- Use when the user wants to know which platform has the best takeout, travel, movie or parcel 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/takeout (takeout) | /coupon/trip (travel) | /coupon/movie (movie) | /coupon/parcel (parcel)` (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. Same shapes as the individual skills: takeout returns platform-keyed coupon lists, the other three return JSON arrays of claim-page entries.
+
+### 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:** "Show me all coupons you can find"
+
+**Flow:** call `GET https://agskills.moontai.top/coupon/takeout (takeout) | /coupon/trip (travel) | /coupon/movie (movie) | /coupon/parcel (parcel)`, then present each coupon as:
+
+```
+【All categories】
+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/takeout (takeout) | /coupon/trip (travel) | /coupon/movie (movie) | /coupon/parcel (parcel)` (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/obtain-coupons-all-in-one/references/api_documentation.md

@@ -0,0 +1,321 @@
+# 全平台优惠券API接口文档
+
+## 接口概览
+
+此skill整合了4个独立的优惠券API接口，提供一站式优惠券获取服务。
+
+| 优惠券类型 | 接口地址 | 支持平台 |
+|-----------|----------|---------|
+| 外卖优惠券 | `https://agskills.moontai.top/coupon/takeout` | 美团、饿了么/淘宝闪购、京东 |
+| 快递优惠券 | `https://agskills.moontai.top/coupon/parcel` | 顺丰、中通、圆通、韵达、申通、菜鸟 |
+| 出行优惠券 | `https://agskills.moontai.top/coupon/trip` | 滴滴出行、酒店优惠礼包 |
+| 电影票优惠券 | `https://agskills.moontai.top/coupon/movie` | 淘票票、猫眼 |
+
+## 通用配置
+
+| 配置项 | 值 |
+|--------|-----|
+| 认证方式 | 无需认证 |
+| 请求方法 | GET |
+| 返回格式 | JSON |
+| 超时设置 | 10秒 |
+
+## 1. 外卖优惠券API
+
+### 接口信息
+
+| 配置项 | 值 |
+|--------|-----|
+| 接口地址 | `https://agskills.moontai.top/coupon/takeout` |
+| 返回格式 | JSON |
+
+### 响应结构
+
+```json
+{
+  "美团隐藏外卖券列表": [
+    {
+      "title": "美团外卖节(主推)🔥🔥",
+      "coupon_code": "❤️复制整条信息，打开👉美团👈 http:/💰t7NWIxNDQ0NTE💰",
+      "guideline": "手机先复制优惠券代码，打开美团APP自动领取"
+    },
+    {
+      "title": "美团外卖甄选好店🔥🔥",
+      "coupon_code": "❤️复制整条信息，打开👉美团👈 http:/💰w0OGFiZjdmYTk💰",
+      "guideline": "手机先复制优惠券代码，打开美团APP自动领取"
+    },
+    {
+      "title": "美团外卖【品牌商品券🔥🔥】",
+      "coupon_code": "❤️复制整条信息，打开👉美团👈 http:/💰wuMzJlZGFlMTY💰",
+      "guideline": "手机先复制完整的优惠券代码，打开美团APP自动领取"
+    },
+    {
+      "title": "美团外卖【神券包】 9.9元购360元年卡",
+      "coupon_code": "❤️复制整条信息，打开👉美团👈 http:/💰ydZWY2NjQ2NDg💰",
+      "guideline": "手机先复制完整的优惠券代码，打开美团APP自动领取"
+    }
+  ],
+  "饿了么/淘宝闪购隐藏外卖券列表": [
+    {
+      "title": "淘宝闪购-叠红包🔥🔥",
+      "coupon_code": "￥Q8rJTMpjkKE￥/ HU7405 【闪购品牌日 单单有福利】",
+      "guideline": "请复制完整的优惠券代码，打开淘宝APP领取"
+    },
+    {
+      "title": "淘宝闪购-天天领红包(全场景, 最高抢66元大额红包)",
+      "coupon_code": "0fυィ直文本2:/＄TMpQp4v＄~.淘宝闪购App【天天领红包（全场景通用）】",
+      "guideline": "请复制完整的优惠券代码，打开淘宝APP领取"
+    },
+    {
+      "title": "淘宝闪购-宵夜专场",
+      "coupon_code": "0複制文本666:/＄TMpQ6cz＄~.淘宝闪购App【闪购夜宵专享会场】",
+      "guideline": "请复制完整的优惠券代码，打开淘宝APP领取"
+    },
+    {
+      "title": "淘宝闪购-学生专场",
+      "coupon_code": "29 HU7405 2:/TpOYTMpkOTb✔四学生专享天天好价",
+      "guideline": "请复制完整的优惠券代码，打开淘宝APP领取"
+    }
+  ],
+  "京东隐藏外卖券列表": [
+    {
+      "title": "京东外卖-惊喜红包(主推)",
+      "coupon_code": "！V6M0P42CyIm6sAe4！ CA1565",
+      "guideline": "请复制完整的优惠券代码，打开京东APP领取"
+    },
+    {
+      "title": "京东外卖-高Y品质会场",
+      "coupon_code": " ！F4v6f1xHQipuCbW8！ CA1331",
+      "guideline": "请复制完整的优惠券代码，打开京东APP领取"
+    },
+    {
+      "title": "京东外卖-夜宵专场",
+      "coupon_code": "！I3xPR007jcyak7Uo！ CA3576",
+      "guideline": "请复制完整的优惠券代码，打开京东APP领取"
+    }
+  ],
+  "扫码领取/H5网页跳转领取": [
+    {
+      "title": "美团优惠券领取页",
+      "coupon_url": "https://h5.sichuanyunzhan.com/pages_single/meiTuan/index?platform=singlePage&pid=e467cdcafe2b1791cdfc&accountsId=nEjX0zy4Zmyq",
+      "coupon_qrcode_img_url": "https://moontai-static.oss-cn-shenzhen.aliyuncs.com/meituan-614d8c70-26c5-43bc-9e91-4468651709e8.png",
+      "guideline": "点击链接下单(建议用微信打开)，或使用微信扫描二维码下单（单单享优惠）"
+    },
+    {
+      "title": "饿了么/淘宝闪购优惠券领取页",
+      "coupon_url": "https://h5.sichuanyunzhan.com/pages_single/hungry/index?platform=singlePage&pid=e467cdcafe2b1791cdfc&accountsId=nEjX0zy4Zmyq",
+      "coupon_qrcode_img_url": "https://moontai-static.oss-cn-shenzhen.aliyuncs.com/taobao-9dd25c45-2e2c-451d-af71-a502f815de16.png",
+      "guideline": "点击链接下单(建议用微信打开)，或使用微信扫描二维码下单（单单享优惠）"
+    }
+  ],
+  "查找更多优惠券": {
+    "title": "更多类型优惠券（外卖、电影、快递、旅游、打车)",
+    "coupon_h5_qrcode_img_url": "https://moontai-static.oss-cn-shenzhen.aliyuncs.com/qrcode_for_gh.jpg",
+    "guideline": "可以使用微信扫码后领券。关注不迷路，天天领券！"
+  }
+}```
+
+### 响应字段
+
+| 字段名 | 类型 | 说明 |
+|--------|------|------|
+| 美团隐藏外卖券列表 | Array | 美团外卖平台优惠券 |
+| 饿了么/淘宝闪购隐藏外卖券列表 | Array | 淘宝闪购/饿了么优惠券 |
+| 京东隐藏外卖券列表 | Array | 京东外卖优惠券 |
+| 查找更多优惠券 | Object | 更多优惠券入口（外卖、电影、快递、旅游、打车，公众号二维码） |
+| [].title | String | 优惠券标题 |
+| [].coupon_code | String | **优惠券代码，原样呈现，禁止修改** |
+| [].guideline | String | 领取说明 |
+| 查找更多优惠券.coupon_h5_qrcode_img_url | String | 公众号二维码图片URL |
+| 查找更多优惠券.guideline | String | 使用说明 |
+
+## 2. 快递优惠券API
+
+### 接口信息
+
+| 配置项 | 值 |
+|--------|-----|
+| 接口地址 | `https://agskills.moontai.top/coupon/parcel` |
+| 返回格式 | JSON（数组） |
+
+### 响应结构
+
+```json
+[
+  {
+    "title": "快递一站式服务，智能寄件，智能匹配价格；单单享优惠，件件有折扣",
+    "coupon_url": "https://open.cdyunzhanxinxi.com/link/100058569b79be0bd2561000406SEVGA",
+    "coupon_qrcode_img_url": "https://moontai-static.oss-cn-shenzhen.aliyuncs.com/coupon-parcel.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，原样呈现，禁止修改** |
+| [].guideline | String | 领取说明 |
+
+## 3. 出行优惠券API
+
+### 接口信息
+
+| 配置项 | 值 |
+|--------|-----|
+| 接口地址 | `https://agskills.moontai.top/coupon/trip` |
+| 返回格式 | JSON（数组） |
+
+### 响应结构
+
+```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 | 领取说明 |
+
+## 4. 电影票优惠券API
+
+### 接口信息
+
+| 配置项 | 值 |
+|--------|-----|
+| 接口地址 | `https://agskills.moontai.top/coupon/movie` |
+| 返回格式 | JSON（数组） |
+
+### 响应结构
+
+```json
+[
+  {
+    "title": "电影票优惠券-支持用户在线购买全国10000+影院电影票、用户享受8折起购票优惠",
+    "coupon_url": "https://personal.yunzhanxinxi.com/movie/?promotion_id=yz-69870112-218077-267995&user_source=vip",
+    "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，原样呈现，禁止修改** |
+| [].guideline | String | 领取说明 |
+
+## 重要说明
+
+### coupon_code 处理规则
+
+**严格禁止修改coupon_code字段的任何内容！**
+
+- 优惠券代码可能包含特殊字符：%、¥、✔、！、£等
+- 这些特殊字符是平台特定格式，必须原样保持
+- 禁止添加空格、换行或任何格式化
+- 禁止翻译、解释或重新排列代码顺序
+
+### coupon_url 和 coupon_qrcode_img_url 处理规则
+
+**严格禁止修改任何URL字段的任何内容！**
+
+- URL链接必须原样保持
+- 禁止添加空格、换行或任何格式化
+- 禁止翻译、解释或重新排列链接顺序
+
+## 错误码
+
+| 情况 | 说明 |
+|------|------|
+| 正常返回 | 返回JSON数据 |
+| 网络错误 | 返回"无法获取优惠券信息，请稍后重试" |
+| 解析错误 | 返回"数据解析异常，请联系技术支持" |
+
+## 使用建议
+
+### 外卖优惠券
+- 优先展示美团优惠券
+- 对于无法复制coupon_code的用户，提供「查找更多优惠券」公众号二维码
+
+### 快递优惠券
+- 建议在微信中打开coupon_url
+- 或使用微信扫描coupon_qrcode_img_url
+
+### 出行优惠券
+- 根据用户需求选择滴滴或酒店优惠礼包
+- 支持打车、住宿等多种出行场景
+
+### 电影票优惠券
+- 适合淘票票、猫眼等主流电影平台
+- 建议在微信中打开链接或扫码
+
+## 调用示例
+
+### Python
+
+```python
+import requests
+
+# 获取所有优惠券
+takeout = requests.get("https://agskills.moontai.top/coupon/takeout").json()
+parcel = requests.get("https://agskills.moontai.top/coupon/parcel").json()
+trip = requests.get("https://agskills.moontai.top/coupon/trip").json()
+movie = requests.get("https://agskills.moontai.top/coupon/movie").json()
+
+print("外卖优惠券:", takeout)
+print("快递优惠券:", parcel)
+print("出行优惠券:", trip)
+print("电影票优惠券:", movie)
+```
+
+### cURL
+
+```bash
+# 外卖优惠券
+curl https://agskills.moontai.top/coupon/takeout
+
+# 快递优惠券
+curl https://agskills.moontai.top/coupon/parcel
+
+# 出行优惠券
+curl https://agskills.moontai.top/coupon/trip
+
+# 电影票优惠券
+curl https://agskills.moontai.top/coupon/movie
+```