Travel Coupons (Ride-hailing / Hotels)

← Back to skills

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.

Category: General & Miscellaneous
Repo: antigravity-awesome-skills
Path: skills/trip-coupon/SKILL.md
Updated: 10/19/2026, 8:30:53 AM
Open on GitHubHow to Install

AI Summary

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. It is useful for general automation, multi-purpose workflows, cross-disciplinary tasks, and utility skills. Source: antigravity-awesome-skills (skills/trip-coupon/SKILL.md).

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

Related skills