ClawHub

Aerobase Travel Hotels

v3.3.0

Hotel search, booking, amendments, loyalty vouchers, and jetlag-friendly layover stays

⭐ 0· 460·3 current·3 all-time
byAerobase@kurosh87
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
ℹ
Purpose & Capability
Name/description, declared primary credential (AEROBASE_API_KEY), and the listed API endpoints align with a hotel-booking/search capability. Minor marketing inconsistency: SKILL.md states "API-only: no scraping, no browser automation" but the "Pro Superpowers" section advertises "browser-powered superpowers" — this is likely a promotional note about Pro-tier features rather than a hidden behavior in the skill itself.
✓
Instruction Scope
SKILL.md instructs the agent to use only documented Aerobase endpoints, validate inputs, handle standard HTTP errors, and never request or expose user secrets. It does not instruct reading unrelated files or environment variables beyond the declared API key.
✓
Install Mechanism
No install spec or code files — instruction-only skill. Nothing is downloaded or written to disk by the skill bundle itself.
✓
Credentials
Only the Aerobase API key (AEROBASE_API_KEY) is required, which is proportional to an API-driven hotel booking skill. No unrelated credentials or config paths are requested.
✓
Persistence & Privilege
Skill does not request always:true and does not modify other skills or system-wide settings. Autonomous invocation (model can call skill) is allowed but is the platform default.
Assessment
This skill appears to do what it says: it calls Aerobase APIs and needs an AEROBASE_API_KEY. Before installing, verify you trust https://aerobase.app and the API key signup page, understand free-tier limits (5 requests/day) and paid tiers, and ensure any key you provide has minimal permissions and can be rotated. Note the SKILL.md explicitly says not to collect user card details; the booking flow uses API offer/prebook/book endpoints and payment method tokens rather than raw card collection. The only minor inconsistency is marketing text about "browser-powered superpowers" for Pro — the skill bundle itself contains no browser automation. If you plan to enable autonomous agent actions, monitor network usage and avoid storing long-lived secrets in shared environments.

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

🏨 Clawdis
Primary envAEROBASE_API_KEY
accommodationvk975e12rbcav52asbbvwqx38ed82c00ghotelsvk975e12rbcav52asbbvwqx38ed82c00glatestvk977tbe7tt5gjbkd57atvavb8h83zwmmtravelvk975e12rbcav52asbbvwqx38ed82c00g
460downloads
0stars
22versions
Updated 3w ago
v3.3.0
MIT-0
Aerobase@kurosh87
accommodationhotelslatesttravel
Download

Aerobase Travel Hotels 🏨

Use this skill when users need places to stay that help with transit flow and recovery, including short layover stay options.

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 hotels with jetlag-friendly filters.
  • Find day-use options for long layovers.
  • Compare rates with recovery-relevant features first.

Search Endpoints

GET /api/v1/hotels
Filters: airport, city, country, chain, tier, stars, jetlagFriendly, search, limit, offset

GET /api/v1/hotels/near-airport/{code}
Find hotels near an airport by IATA code. Returns hotels sorted by distance.
Query params: radius (km, default 25), limit (default 20)
Example: GET /api/v1/hotels/near-airport/JFK?radius=15&limit=10

GET /api/dayuse
Filters: airport or city, country, search, maxPrice, sort, limit, offset

Rates

POST /api/v1/hotels/rates
Get live room rates and availability. Provide hotelIds (array) OR airportCode (IATA string — auto-discovers nearby hotels).
Required: checkin, checkout. Optional: adults (default 2), children, childrenAges, currency.

POST /api/v1/hotels/rates
{ "airportCode": "NRT", "checkin": "2026-04-15", "checkout": "2026-04-16", "adults": 2 }

Each room in the response has an offerId — use it in prebook.

Price Index (Beta)

GET /api/v1/hotels/prices?hotelIds={ids}
Historical price trends per hotel. Returns avg per-night USD prices by calendar day.
Query params: hotelIds (comma-separated, max 50, required), fromDate, toDate (YYYY-MM-DD, optional).
Example: GET /api/v1/hotels/prices?hotelIds=lp19d9e,lp19e0c&fromDate=2026-04-01&toDate=2026-04-30

Booking Flow (Pro tier required)

  1. POST /api/v1/hotels/prebook — Lock rate: { "offerId": "..." } → returns prebookId 1b. GET /api/v1/hotels/prebook/{prebookId} — Retrieve prebook session (optional, for recovery/status check). Add ?includeCreditBalance=true for credit info.
  2. POST /api/v1/hotels/book — Confirm booking:
{
  "prebookId": "...",
  "holder": { "firstName": "Jane", "lastName": "Doe", "email": "jane@example.com", "phone": "+1234567890" },
  "guests": [{ "occupancyNumber": 1, "firstName": "Jane", "lastName": "Doe", "email": "jane@example.com" }],
  "payment": { "method": "ACC_CREDIT_CARD" }
}

Payment methods: ACC_CREDIT_CARD (sandbox-safe), TRANSACTION_ID, WALLET, CREDIT 3. GET /api/v1/hotels/bookings?guestId=... or ?clientReference=... — List bookings 4. GET /api/v1/hotels/bookings/{id} — Booking detail + cancellation policy 5. DELETE /api/v1/hotels/bookings/{id} — Cancel booking

Booking Amendments

  • PUT /api/v1/hotels/bookings/{id}/amend — Correct guest name/email: { "holder": { "firstName", "lastName", "email" } }
  • POST /api/v1/hotels/bookings/{id}/alternative-prebooks — Get up to 3 alternative rates for date/occupancy changes
  • POST /api/v1/hotels/rebook — Complete hard amendment: { "prebookId", "existingBookingId" } — auto-cancels old booking

Loyalty & Vouchers (Wallet integration)

  • GET /api/v1/hotels/guests — List loyalty program guests
  • GET /api/v1/hotels/guests/{guestId}/loyalty-points — Check points balance
  • POST /api/v1/hotels/guests/{guestId}/loyalty-points/redeem — Convert points to voucher (10 pts = $1 USD): { "points": 100, "currency": "USD" }
  • Voucher code returned from redemption can be applied at prebook via voucherCode param

Never book without explicit user approval. Always show cancellation policy before booking.

Output expectations

  • Include cancellation policy and layover fit when recommending options.
  • If layover is over 8 hours, show day-use candidates first.
  • Highlight jetlag recovery amenities (nap zones, showers, low-noise options).

Usage limits

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

Safety

  • Never ask for user card details, loyalty IDs, or account secrets.
  • Keep the conversation focused on public booking metadata and user constraints only.

Pro Superpowers

Upgrade to Pro to unlock browser-powered superpowers for hotel booking sites:

Comments

Loading comments...