OpenParable
Skip to content
← Back to skills

Travel Planning

Productivity
travel-planning

Travel Planning is an Agent Skill for productivity published in the better-world-ai/x-cli repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/better-world-ai/x-cli/blob/HEAD/skills/travel-planning/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/travel-planning, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

Capabilityctrip-clibooking-clixiaohongshu-cli
Hotel searchDomestic + InternationalInternational only-
Flight searchDomestic + International--
AttractionsYes (with scores, prices)--
Destination guideMust-do lists, travel notes--
User reviews/tips--Travel notes search
Login requiredNo (member prices need login)NoRead: No, Write: Yes
CAPTCHA riskLowLowLow

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

Destinationctrip slugbooking name
上海shanghai2Shanghai
北京beijing1Beijing
杭州hangzhou14Hangzhou
成都chengdu104Chengdu
西安xian7Xi'an
三亚sanya61Sanya
厦门xiamen21Xiamen
广州guangzhou152Guangzhou
重庆chongqing158Chongqing
东京tokyo294Tokyo
京都kyoto430Kyoto
大阪osaka293Osaka
首尔seoul234Seoul
曼谷bangkok191Bangkok
新加坡singapore53Singapore
巴黎paris308Paris
伦敦london309London

Flight City Codes (IATA)

上海: SHA, 北京: BJS, 广州: CAN, 深圳: SZX, 成都: CTU, 杭州: HGH, 西安: SIA, 三亚: SYX, 重庆: CKG, 南京: NKG, 东京: TYO, 大阪: KIX, 首尔: SEL, 曼谷: BKK, 新加坡: SIN

Login & CAPTCHA Notes

PlatformLogin neededWithout loginCAPTCHA risk
CtripRecommendedAll features work, but prices are significantly higher without login (50%+ markup observed on the same hotel). Log in in Chrome for accurate member pricesLow — never triggered during testing
Booking.comRecommendedSearch 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 retryLow
XiaohongshuRead: No, Write: Yessearch, view, feeds, user all work. like/comment/post require loginLow

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.