---

version: 3.1.6 name: aerobase-travel-flights description: Search, compare, and score flights with jetlag optimization metadata: {"openclaw": {"emoji": "🛫", "primaryEnv": "AEROBASE_API_KEY", "user-invocable": true, "homepage": "https://aerobase.app"}}

Aerobase Travel Flights 🛫

Use this when users want the fastest, highest-confidence way to compare flights with jetlag awareness.

Setup

Use this skill by getting a free API key at https://aerobase.app/openclaw-travel-agent and setting AEROBASE_API_KEY in your agent environment. This skill is API-only: no scraping, no browser automation, and no user credential collection.

Usage is capped at 5 requests/day for free users. Upgrade to Pro ($10.99) at https://aerobase.app/openclaw-travel-agent for 500 API calls/month.

Agent API Key Protocol

• Base URL: https://aerobase.app
• Required env var: AEROBASE_API_KEY
• Auth header (preferred): Authorization: Bearer ${AEROBASE_API_KEY}
• Fallback header (allowed): X-Api-Key: ${AEROBASE_API_KEY}
• Never ask users for passwords, OTPs, cookies, or third-party logins.
• Never print raw API keys in output; redact as sk_live_***.

Request rules

• Use only Aerobase endpoints documented in this skill.
• Validate required params before calling APIs (IATA codes, dates, cabin, limits).
• On 401/403: tell user key is missing/invalid and route them to https://aerobase.app/openclaw-travel-agent.
• On 429: explain free-tier quota (5 requests/day) and suggest Pro ($10.99/month, 500 API calls/month) or Lifetime ($149.99, 500 API calls/month).
• On 5xx/timeout: retry once with short backoff; if still failing, return partial guidance and next step.
• Use concise responses: top options first, then 1-2 follow-up actions.

What this skill does

• Search flights by route/date with scoring context.
• Compare alternatives and highlight better recovery options.
• Validate fare offers before user booking action.

Search API

POST /api/v1/flights/search

Body: { from, to, date, return_date?, max_stops?, sort?, limit? }
Accepted sort values:

• price
• duration

Free tier: 5 results. Concierge mode: 50 results.

POST /api/flights/search/agent — multi-provider parallel search.

Booking support

• POST /api/flights/validate — pre-booking price and seatability check.
• POST /api/flights/book — place booking request.
• Never submit payment or complete purchase without explicit user approval.

Compare & score

• POST /api/v1/flights/compare — compare multiple flight options.
• POST /api/v1/flights/score — score any single flight for jetlag and recovery impact.

Usage limits

• Free: 5 requests/day
• Pro: 500 API calls/month (upgrade at $10.99/month)
• Lifetime: $149.99 for 500 API calls/month

Safety

• Do not request user account passwords, OTPs, or payment credentials.
• Ask before any booking-related action.