🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Aerobase Travel Flights
πŸ¦€ ClawHub

Aerobase Travel Flights

by @kurosh87

Search, compare, and score flights with jetlag optimization

Versionv3.3.1
Downloads1,358
#legal#travel
TERMINAL
clawhub install aerobase-travel-flights

πŸ“– About This Skill

version: 3.3.1 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 ($9.95/month) 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}
  • 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 ($9.95/month, 500 API calls/month) or Lifetime ($249, 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 canonical jetlag scoring context.
  • Compare alternatives and highlight better accelerated 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/v1/flights/validate β€” pre-booking price and seatability check.
    • Body: { bookingToken, provider? } Returns: { available, currentPrice, priceChanged }

  • POST /api/v1/flights/book β€” place booking request (zooz credit card flow).
    • Body: { bookingToken, passengers: [{firstName, lastName, email, phone, birthday, title, nationality?, documentNumber?, documentExpiry?}], payment?: {cardNumber, expiry, cvv, holderName, currency?} } Returns: { action, bookingId, providerReference, totalPrice, message } Actions: booked, redirect, re-search, confirm_price_change, failed

  • GET /api/v1/flights/bookings β€” list your bookings with status.
    • Query: ?limit=20&offset=0

  • GET /api/v1/flights/bookings/{id} β€” booking detail with webhook history.

  • 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 with canonical jetlagScore (0-100) and accelerated recovery impact.

    • For 0-2h shifts, treat results as minimal/negligible circadian disruption rather than a full jetlag reset problem.

    Usage limits

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

    • Safety

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

    • Pro Superpowers

    Upgrade to Pro to unlock browser-powered superpowers for air travel sites:

  • Live Google Flights and Kayak price comparison
  • Concurrent multi-source search for comprehensive results
  • 500 API calls/month instead of 5/day
  • Get Pro at https://aerobase.app/openclaw-travel-agent

    • βš™οΈ Configuration

    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 ($9.95/month) at https://aerobase.app/openclaw-travel-agent for 500 API calls/month.