| name | travel-planning |
| description | Use when the user wants to plan a trip, compare hotels/flights/attractions across platforms, or asks for travel recommendations. Invoke when user mentions "旅游攻略", "旅行规划", "travel planning", or asks to plan a trip to any destination. |
Travel Planning
Orchestrates 3 CLI tools to help users plan domestic and international trips — covering hotels, flights, attractions, destination guides, and user reviews.
Prerequisites
-
kimi-webbridge daemon running:
~/.kimi-webbridge/bin/kimi-webbridge status
If not running: invoke the kimi-webbridge skill.
-
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.
ctrip-cli destination --name chengdu104
xiaohongshu-cli search "成都旅游攻略" --limit 10
ctrip-cli search-hotels --keyword "成都" --checkin 2026/07/01 --checkout 2026/07/05 --limit 10
ctrip-cli search-flights --from SHA --to CTU --date 2026-07-01 --limit 10
ctrip-cli search-attractions --destination chengdu104 --limit 10
Workflow: International Trip (出境游)
Use all 3 CLIs. Example: planning a trip to Kyoto.
ctrip-cli destination --name kyoto430
xiaohongshu-cli search "京都旅游攻略" --limit 10
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
ctrip-cli search-flights --from SHA --to KIX --date 2026-07-01 --limit 10
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 |
|---|
| 上海 | shanghai2 | Shanghai |
| 北京 | beijing1 | Beijing |
| 杭州 | hangzhou14 | Hangzhou |
| 成都 | chengdu104 | Chengdu |
| 西安 | xian7 | Xi'an |
| 三亚 | sanya61 | Sanya |
| 厦门 | xiamen21 | Xiamen |
| 广州 | guangzhou152 | Guangzhou |
| 重庆 | chongqing158 | Chongqing |
| 东京 | tokyo294 | Tokyo |
| 京都 | kyoto430 | Kyoto |
| 大阪 | osaka293 | Osaka |
| 首尔 | seoul234 | Seoul |
| 曼谷 | bangkok191 | Bangkok |
| 新加坡 | singapore53 | Singapore |
| 巴黎 | paris308 | Paris |
| 伦敦 | london309 | London |
Flight City Codes (IATA)
上海: SHA, 北京: BJS, 广州: CAN, 深圳: SZX, 成都: CTU, 杭州: HGH, 西安: SIA, 三亚: SYX, 重庆: CKG, 南京: NKG, 东京: TYO, 大阪: KIX, 首尔: SEL, 曼谷: BKK, 新加坡: 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.
