SkillHub

cabin

v1.0.0

Search and book real flights with USDC payments. Gives your AI agent the power to find flights across 500+ airlines and complete bookings paid in USDC on Base. No credit cards, no banks — crypto-native travel commerce.

Sourced from ClawHub, Authored by kobuta23

Installation

Please help me install the skill `cabin` from SkillHub official store. npx skills add kobuta23/cabin

Cabin — Flight Search & Booking with USDC

Search real flights across 500+ airlines and book with USDC on Base.

API Base URL

https://api.cabin.team

Endpoints

Search Flights

When the user wants to find flights:

curl -X POST https://api.cabin.team/v1/search 
  -H "Content-Type: application/json" 
  -d '{
    "from": "HAN",
    "to": "ATH",
    "date": "2026-03-15",
    "return_date": "2026-03-22",
    "adults": 1,
    "class": "ECONOMY",
    "currency": "USD",
    "max_results": 5
  }'

Parameters: - from (required): Origin IATA airport code - to (required): Destination IATA airport code - date (required): Departure date (YYYY-MM-DD) - return_date (optional): Return date for round-trip - adults (optional, default 1): Number of passengers - class (optional): ECONOMY, PREMIUM_ECONOMY, BUSINESS, FIRST - currency (optional, default USD): Currency for prices - max_results (optional, default 10): Maximum results

Response includes: - results[] — Array of flight offers with prices, airlines, times, stops - image_url — URL to a rendered PNG comparison image of results - search_id — ID to reference when booking

Presenting results to users: - Show the rendered image (fetch from image_url) for visual comparison - Use structured data for specific questions ("which is cheapest?", "any direct flights?") - Always show price in both USD and USDC equivalent

Book a Flight

When the user wants to book:

curl -X POST https://api.cabin.team/v1/book 
  -H "Content-Type: application/json" 
  -d '{
    "offer_id": "offer_1",
    "search_id": "abc123",
    "passengers": [{
      "type": "adult",
      "given_name": "John",
      "family_name": "Doe",
      "email": "[email protected]",
      "born_on": "1990-01-15",
      "gender": "m"
    }]
  }'

Required passenger info: - given_name, family_name - email - born_on (YYYY-MM-DD) - gender (m/f)

Response includes: - booking_id — Cabin booking reference (CBN-YYYY-XXXX) - amount_usdc — Amount to pay in USDC - payment.deposit_address — USDC deposit address on Base - payment.checkout_url — Payment page URL to share with user

USDC Payment Flow

After booking, the user needs to pay in USDC on Base:

  1. Show the user the amount_usdc and payment.checkout_url
  2. User can either: a. Send USDC directly to payment.deposit_address on Base b. Visit checkout_url for a guided payment experience
  3. After payment, booking is confirmed automatically

If the agent has wallet capabilities (e.g., evm-wallet skill):

# Check USDC balance on Base
node src/balance.js base --json

# Send USDC to deposit address
node src/send.js base USDC <deposit_address> <amount_usdc> --yes --json

Check Booking Status

curl https://api.cabin.team/v1/booking/CBN-2026-XXXX

Statuses: awaiting_payment → confirmed → checked_in

Get Confirmation Page

https://api.cabin.team/v1/booking/CBN-2026-XXXX/confirmation

Share this URL with the user after payment confirmation.

Get Check-in Page

https://api.cabin.team/v1/booking/CBN-2026-XXXX/checkin

Share when it's time to check in for the flight.

Common IATA Codes

Code City
HAN Hanoi
BKK Bangkok
SIN Singapore
NRT Tokyo Narita
HND Tokyo Haneda
ICN Seoul
LHR London
CDG Paris
FCO Rome
ATH Athens
JFK New York
LAX Los Angeles
SFO San Francisco
DXB Dubai
IST Istanbul

Workflow Examples

User: "Find me a flight from Bangkok to Tokyo next Friday" 1. Parse: from=BKK, to=NRT (or HND), date=next Friday 2. Call POST /v1/search 3. Show image_url to user 4. Present top 3-5 options with prices

Round-trip booking

User: "Book the cheapest round-trip from London to Barcelona, March 15-22" 1. Search: from=LHR, to=BCN, date=2026-03-15, return_date=2026-03-22 2. Present options 3. User picks one → collect passenger details 4. POST /v1/book with passenger info 5. Share payment URL → user pays in USDC 6. Confirm booking → share confirmation page

Multi-passenger

User: "We need flights for 3 people, Seoul to Bali, April 1-10" 1. Search with adults=3 2. Prices shown are per-person 3. When booking, collect details for all 3 passengers 4. Total USDC amount = per-person × 3

Error Handling

  • No results: Try nearby airports or different dates
  • Booking expired: Search results expire after 30 minutes, search again
  • Payment timeout: Bookings expire 1 hour after creation if unpaid
  • Invalid airport code: Suggest the correct IATA code

USDC on Base

  • Chain: Base (Ethereum L2)
  • Token: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
  • Gas fees: ~$0.01 per transaction
  • Confirmation: ~2 seconds