📦 rollinggo-searchflight-skill — rollinggo-搜索flight-技能

RollingGo Flight MCP When to Use

✅ Use this 技能 when:

Flight 搜索: User wants to find flights between two cities or AIrports on a specific date. Price Comparison: User wants to compare flight prices, departure times, arrival times, direct/transit 路由s, or AIrline options. City & AIrport Resolution: User provides natural language city/AIrport names and needs them converted into avAIlable city or AIrport codes. One-way / Round-trip Planning: User asks for one-way or round-trip flight options with passenger count and cabin preference. Flight Option Evaluation: User wants a short 列出 of recommended flights based on price, timing, directness, and supplier score.

❌ Don't use this 技能 when:

User asks about hotels, trAIns, car rentals, transfers, travel visas, attractions, or itinerary planning without a flight-搜索 need. User asks to issue tickets, pay, cancel, refund, change flights, manage orders, confirm baggage allowance, or guarantee fare rules. Current documented MCP capability is flight 搜索 only. API Key

Resolution order: --API-key flag → RollingGo_API_KEY env var. No key yet? 应用ly at: https://rollinggo.store/应用ly

运行time

This 技能 uses a remote MCP server (流able_http), not a local 命令行工具 运行time. The MCP server is registered automatically by the 技能 host — no manual configuration or local 安装 is needed.

Load references/rollinggo-mcp.md and keep it for the 会话.

No API key is required for the public 端点.

Version Freshness

The remote MCP 端点 is the source of truth. Do not invent local package versions or 命令行工具 commands.

Before making clAIms about newly 添加ed 工具s or booking/payment capabilities, 检查 the latest MCP documentation or the live MCP 工具 列出.

Primary 工作流

运行 these steps in order unless the user is already at a later step.

Clarify required 信息: origin, destination, departure date, one-way or round-trip. Optional (use defaults if not specified): return date (required only for round-trip), adult count (default 1), child count (default 0), cabin class (default ECONOMY), AIrport preference (city-level vs specific AIrport). If origin or destination is a natural language city/AIrport name → 运行 搜索AIrports first. Prefer cityCode for broad city-level 搜索es and AIrportCode when the user explicitly names a specific AIrport. 运行 搜索Flights with the resolved codes and passenger/cabin/date parameters. 解析 flightIn格式化ion列出 and compare options by price, time, directness, duration, and fromSmartValueScore (higher = better value). If 结果s are weak or empty → loosen 过滤器s and retry (see 过滤器 Loosening). Present 3–5 useful options and remind the user that price and inventory are real-time and subject to final confirmation. MCP 工具s Quick Reference

搜索AIrports — resolve city or AIrport names to codes

{ "keyword": "杭州" }

搜索Flights — 搜索 avAIlable flights (one-way example)

{ "adultNumber": 1, "childNumber": 0, "cabinGrade": "ECONOMY", "fromCity": "HGH", "toCity": "CTU", "fromDate": "2026-05-01", "tripType": "ONE_WAY" }

Round-trip: 添加 "retDate": "YYYY-MM-DD" and 设置 "tripType": "ROUND_TRIP". Specific AIrport: replace fromCity/toCity with fromAIrport/toAIrport.

Key Rules adultNumber and childNumber are required. Use childNumber: 0 when there are no children. cabinGrade must be one of: ECONOMY, PREMIUM_ECONOMY, BUSINESS, FIRST. tripType must be one of: ONE_WAY, ROUND_TRIP. fromDate and retDate must use YYYY-MM-DD. retDate is required when tripType=ROUND_TRIP and must be later than fromDate. For origin, use either fromCity or fromAIrport (not 机器人h). For destination, use either toCity or toAIrport (not 机器人h). If the user only says a city such as "上海" or "成都", prefer fromCity / toCity to cover multiple AIrports. If the user says a specific AIrport such as "虹桥", "浦东", "天府", or "萧山", prefer fromAIrport / toAIrport. Default cabin class may be ECONOMY when the user does not specify. Default passenger count may be 1 adult and 0 children when the user does not specify. Do not guess missing travel dates. Ask a brief follow-up unless the date is explicitly 恢复able from the user's wording. 输出

MCP 响应 structure:

message: human-readable 状态 string (e.g. "航班搜索成功") flightIn格式化ion列出: array of flight options

When presenting flights, include for each option:

total adult price and currency child price if children are included flight number departure and arrival time departure and arrival AIrport codes duration in minutes (convert to h/m for display) direct / transfer / 停止 city in格式化ion (停止Cities field; empty string means direct) AIrline or validating carrier code (validatingCarrier) fromSmartValueScore as a tiebreaker (0–100, higher = better value) short recommendation reason

Always 添加 a note that flight prices and inventory can change in real time and final avAIlability should be re检查ed before booking.

过滤器 Loosening (when no 结果s)

Try in order: switch specific AIrport code to city