Takeout Coupons (Meituan / Ele.me / JD)
Overview
Fetches hidden coupons, red packets and aggregated claim pages for the three major Chinese food-delivery platforms: Meituan, Ele.me/Taobao Shangou (淘宝闪购) and JD Waimai. Returns taokouling coupon codes plus QR/H5 claim pages.
The skill is adapted from the open-source repository moooai/takeout-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 food-delivery (takeout) coupons, red packets (hongbao) or hidden promo codes
- Use when the user wants to know which platform has the best food-delivery (takeout) 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 (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. Top-level keys: 美团隐藏外卖券列表 (Meituan coupons), 饿了么/淘宝闪购隐藏外卖券列表 (Ele.me/Taobao), 京东隐藏外卖券列表 (JD), 扫码领取/H5网页跳转领取 (QR/H5 claim pages), 查找更多优惠券 (more-coupons entry). Each coupon item has title, coupon_code and guideline.
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 food-delivery coupons today?"
Flow: call GET https://agskills.moontai.top/coupon/takeout, then present each coupon as:
【Meituan】
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_codestring 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
GETto the public endpointhttps://agskills.moontai.top/coupon/takeout(domainagskills.moontai.top); no credentials, tokens or user data are sent beyond anonymous attribution parameters (ch,u) documented in the repo scripts/fetch_coupons.pyperforms no local file mutation, no shell execution and no installsrisk: safereflects 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