SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillstravel-planning

travel-planning

General & other

View repository

Updated 10-16 05:01

About this skill

Travel Planning

Orchestrates 3 CLI tools to help users plan domestic and international trips — covering hotels, flights, attractions, destination guides, and user reviews.

Prerequisites

  1. kimi-webbridge daemon running:

    ~/.kimi-webbridge/bin/kimi-webbridge status

    If not running: invoke the kimi-webbridge skill.

  2. CLI binaries on $PATH:

    • xiaohongshu-cli — install via Homebrew: 
      brew install xpzouying/agent-cli/xiaohongshu-cli
      (One-time tap setup: brew tap xpzouying/agent-cli. Covers macOS arm64/amd64 and Linux amd64/arm64.)
  • ctrip-cli and booking-cli — build from source: 
    git clone https://github.com/better-world-ai/x-cli
cd x-cli/ctrip-cli   && go build -o ~/.local/bin/ctrip-cli   . && cd ..
cd booking-cli       && go build -o ~/.local/bin/booking-cli .
    Ensure ~/.local/bin is on your $PATH.

Sanity check:

ctrip-cli --help && booking-cli --help && xiaohongshu-cli --help

CLI Capabilities

Capability ctrip-cli booking-cli xiaohongshu-cli
Hotel search Domestic + International International only -
Flight search Domestic + International - -
Attractions Yes (with scores, prices) - -
Destination guide Must-do lists, travel notes - -
User reviews/tips - - Travel notes search
Login required No (member prices need login) No Read: No, Write: Yes
CAPTCHA risk Low Low Low

Workflow: Domestic Trip (国内游)

Use ctrip + xiaohongshu. Example: planning a trip to Chengdu.

# 1. Get destination overview from Ctrip (must-do sights, restaurants, shops, travel notes)
ctrip-cli destination --name chengdu104

# 2. Search user travel tips on Xiaohongshu
xiaohongshu-cli search "成都旅游攻略" --limit 10

# 3. Search hotels on Ctrip
ctrip-cli search-hotels --keyword "成都" --checkin 2026/07/01 --checkout 2026/07/05 --limit 10

# 4. Search flights
ctrip-cli search-flights --from SHA --to CTU --date 2026-07-01 --limit 10

# 5. Browse attractions
ctrip-cli search-attractions --destination chengdu104 --limit 10

Workflow: International Trip (出境游)

Use all 3 CLIs. Example: planning a trip to Kyoto.

# 1. Get destination overview from Ctrip
ctrip-cli destination --name kyoto430

# 2. Search user travel tips on Xiaohongshu
xiaohongshu-cli search "京都旅游攻略" --limit 10

# 3. Compare hotels: Ctrip vs Booking.com
ctrip-cli search-hotels --keyword "京都" --city-id 734 --country-id 78 --checkin 2026/07/01 --checkout 2026/07/05 --limit 10
booking-cli search-hotels --destination "Kyoto" --checkin 2026-07-01 --checkout 2026-07-05 --limit 10

# 4. Search flights
ctrip-cli search-flights --from SHA --to KIX --date 2026-07-01 --limit 10

# 5. Browse attractions
ctrip-cli search-attractions --destination kyoto430 --limit 10

Quick Command Reference

ctrip-cli

ctrip-cli destination --name SLUG
ctrip-cli search-hotels --keyword "城市" [--city-id N --country-id N] [--checkin YYYY/MM/DD] [--checkout YYYY/MM/DD] [--limit N]
ctrip-cli search-flights --from IATA --to IATA [--date YYYY-MM-DD] [--limit N]
ctrip-cli search-attractions --destination SLUG [--limit N]

booking-cli

booking-cli search-hotels --destination "City" [--checkin YYYY-MM-DD] [--checkout YYYY-MM-DD] [--adults N] [--rooms N] [--limit N]

xiaohongshu-cli

xiaohongshu-cli search "关键词" [--limit N]
xiaohongshu-cli view <note_id> <xsec_token>
xiaohongshu-cli user <user_id>
xiaohongshu-cli feeds [--limit N]
xiaohongshu-cli login-status
xiaohongshu-cli screenshot <note_id> <xsec_token> [-o path.png]

Destination ID Cheat Sheet

Destination ctrip slug booking name
Shanghai shanghai2 Shanghai
Beijing beijing1 Beijing
Hangzhou hangzhou14 Hangzhou
Chengdu chengdu104 Chengdu
Xi'an xian7 Xi'an
Sanya sanya61 Sanya
Xiamen xiamen21 Xiamen
Guangzhou guangzhou152 Guangzhou
Chongqing chongqing158 Chongqing
Tokyo tokyo294 Tokyo
Kyoto kyoto430 Kyoto
Osaka osaka293 Osaka
Seoul seoul234 Seoul
Bangkok bangkok191 Bangkok
Singapore singapore53 Singapore
Paris paris308 Paris
London london309 London

Flight City Codes (IATA)

Shanghai: SHA, Beijing: BJS, Guangzhou: CAN, Shenzhen: SZX, Chengdu: CTU, Hangzhou: HGH, Xi'an: SIA, Sanya: SYX, Chongqing: CKG, Nanjing: NKG, Tokyo: TYO, Osaka: KIX, Seoul: SEL, Bangkok: BKK, Singapore: SIN

Login & CAPTCHA Notes

Platform Login needed Without login CAPTCHA risk
Ctrip Recommended All features work, but prices are significantly higher without login (50%+ markup observed on the same hotel). Log in in Chrome for accurate member prices Low — never triggered during testing
Booking.com Recommended Search works, but displayed prices are significantly higher without login (50%+ markup observed on the same hotel). May also show "Verify email" popup — complete in Chrome and retry Low
Xiaohongshu Read: No, Write: Yes search, view, feeds, user all work. like/comment/post require login Low

Tips

  • Start with destination overview: Run ctrip-cli destination first to understand the destination, then drill into hotels/flights/attractions.
  • International hotel comparison: Always run both ctrip-cli search-hotels and booking-cli search-hotels for international destinations — prices and availability differ significantly.
  • Ctrip international hotels: Use ctrip-cli destination first to get the hotel_url, extract city-id and country-id from it, then pass to search-hotels. Keyword-only search may return wrong city for international destinations.
  • Xiaohongshu for real tips: Search Xiaohongshu for first-person travel experiences, restaurant recommendations, and hidden gems that structured platforms miss.
  • Date formats differ: Ctrip hotels use YYYY/MM/DD, Ctrip flights use YYYY-MM-DD, Booking uses YYYY-MM-DD.
  • Xiaohongshu search retry: First search call may fail if no browser tab exists yet — simply retry once.
  • Output format: All 3 CLIs return {"ok": true, "data": ...} on success and {"ok": false, "error": {...}} on failure.