# Travel Planning

> 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.

- Skill: `better-world-ai/travel-planning` (Agent Skill)
- Install (CLI): `npx skillmds@latest add better-world-ai/travel-planning`
- Raw SKILL.md: https://api.skillmd.com/api/skills/better-world-ai/travel-planning/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: better-world-ai (https://skillmd.com/u/better-world-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/better-world-ai/travel-planning

---


# 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:
   ```bash
   ~/.kimi-webbridge/bin/kimi-webbridge status
   ```
   If not running: invoke the `kimi-webbridge` skill.

2. CLI binaries on `$PATH`:

   - **xiaohongshu-cli** — install via Homebrew:
     ```bash
     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:
     ```bash
     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:
   ```bash
   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.

```bash
# 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.

```bash
# 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

```bash
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

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

### xiaohongshu-cli

```bash
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.