meituan-waimai

name	meituan-waimai
description	Order food delivery from Meituan (美团外卖) via CLI. Use when user wants to search restaurants, browse menus, or manage cart for Chinese food delivery.
metadata	{"bashPattern":"mt\\s+waimai|mt\\s+auth|meituan"}

Meituan Food Delivery CLI

Use the mt CLI to interact with Meituan Waimai (美团外卖). All commands output JSON with --json flag.

Auto-Install

IMPORTANT: Before running any mt command, check if it's installed and set up:

# Check if mt CLI is available
which mt || {
  # Install: clone repo, install deps, link globally
  git clone https://github.com/juntaochi/meituan-cli.git ~/.meituan-cli 2>/dev/null
  cd ~/.meituan-cli && npm install && npm link
  # Install Playwright browser for H5guard signing
  npx playwright install chromium
}

# Check if logged in
mt auth whoami --json 2>/dev/null | grep -q '"loggedIn":true' || {
  # NOT logged in — ask user to provide cookie
  echo "需要登录美团。请在浏览器打开 https://h5.waimai.meituan.com ，登录后从 DevTools → Application → Cookies 复制完整 cookie 字符串"
  # Then run: mt auth login --cookie '<paste full cookie>'
}

Commands Reference

Authentication

mt auth whoami --json           # Check login status
mt auth login --cookie '...'    # Login with full browser cookie
mt auth logout                  # Clear credentials

Address (instant, no browser proxy)

mt waimai address list --json           # List all saved addresses
mt waimai address set <label>           # Set active address by label substring (e.g. "融创", "家")

Search Restaurants (~10s first call, ~2s after)

mt waimai search <keyword> --json
# Example: mt waimai search 鸡 --json
# Returns: [{id, name, rating, distance, deliveryTime, shippingFee, monthSales}]

Menu

mt waimai menu <restaurant-id> --json
# Returns: {items: [{id, name, min_price, unit, description, skus: [{id, spec, price}]}]}
# Or if categorized: {categories: [{name, items: [...]}]}

Cart

mt waimai cart add <spu-id> --restaurant <id> --sku <sku-id> --name <name> --price <price> --json
mt waimai cart view --restaurant <id> --json
mt waimai cart clear --restaurant <id> --json

Order

mt waimai order place --confirm --json    # Place order (requires --confirm flag, real money!)
mt waimai order place --dry-run --json    # Preview order without placing
mt waimai order status <order-id> --json  # Track order status

Reorder & Coupon

mt waimai reorder <order-id> --json              # Repopulate cart from previous order
mt waimai coupon apply <code> --restaurant <id> --json  # Apply coupon to current cart

Typical Agent Workflow

# 1. Ensure address is set
mt waimai address list --json
mt waimai address set 融创

# 2. Search
mt waimai search 清远鸡 --json

# 3. Pick restaurant, get menu
mt waimai menu <poi_id_str from search> --json

# 4. Add to cart (use id + first sku.id from menu)
mt waimai cart add <item.id> \
  --restaurant <poi_id_str> \
  --sku <item.skus[0].id> \
  --name "<item.name>" \
  --price <item.skus[0].price> \
  --json

# 5. Preview and place order
mt waimai order place --dry-run --json   # check total
mt waimai order place --confirm --json   # submit (real money!)

# 6. Track
mt waimai order status <orderId> --json

Notes

• Residential IP required — Meituan blocks datacenter/VPS IPs. Run from a local machine with residential internet
• First call starts headless Chromium with stealth plugin (~10s), subsequent calls ~2s
• Browser state is cached locally — warm restarts are faster
• Address commands bypass browser (instant)
• Cookie expires periodically — re-login if auth errors
• JSON output: {ok: true, data: ...} or {ok: false, error: ...}
• stderr has warnings (e.g. "Starting browser proxy..."), stdout is clean JSON
• Order placement uses real money — always use --dry-run first