← Back to Skills Marketplace
327
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install aerobase-awards
Description
Search 24+ airline loyalty programs for award space with miles cost, seat availability, and jetlag scores
README (SKILL.md)
Award Flight Intelligence
Search
POST /api/v1/awards/search — search seats.aero cache (286K+ rows, 24 programs)
Body: { origin?, destination?, program?, cabin?, dateFrom?, dateTo?, minScore? }
Returns: jetlagScore (0-10 raw, multiply by 10 for K2), k2CabinScore, k2BaseScore,
milesCost, remaining_seats, transfer_options.
Cabin values: economy, business, premium, first (full names, NOT codes).
Saved Award Trips
GET /api/v1/awards/trips — retrieve saved award trip search results Returns previously searched award itineraries with segments, pricing, and jetlag scores.
Alerts
- POST /api/awards/alerts — create alert
- GET /api/awards/alerts — list user's alerts
- Continuous alerts require Pro tier
Program Intelligence
24 programs: Copa, Aeromexico, Ethiopian, United, Delta, American, BA, Lufthansa, AF/KLM, etc. Cross-reference user's credit card portfolio with transfer partner map.
Always
- Present prices in miles/points, not cash
- Include jetlag score alongside every result
- Warn about fuel surcharges on BA, LH, AF awards
- Calculate cents-per-point value: "Business to Tokyo is 75K Aeroplan. Cash price is $3,200. That's 4.3 cents/point — excellent value, your points are worth more here than average."
- When comparing cash vs. points: "The economy option saves 50K miles but the 11 PM departure scores 7.8 — four days of zombie mode. The business seat literally buys you three productive days."
Rate Limits
- Award search: max 20/hr. Alert create: max 10 alerts per user total.
- Award monitoring cron: every 4 hours (do not increase). Batch route queries where possible.
Scrapling — Cash Price Lookup for CPP Calculation
Use Scrapling /search to get cash prices from Google Flights for cents-per-point value:
Reference: Scrapling Documentation
POST {SCRAPLING_URL}/search
{"site":"google-flights","origin":"JFK","destination":"LHR","departure":"2026-04-01","return":"2026-04-08"}
Returns: {"results": [{"price":"€488","duration":"6 hr 50 min","stops":"Nonstop"}], "count": 48}
CPP Calculation Workflow
- Get award price from seats.aero API (e.g., 60K Aeroplan)
- Fire Scrapling Google Flights search for same route
- Extract cash price (EUR from Helsinki — convert to USD if needed)
- Calculate:
cash_price_usd / miles_required * 100 = cents_per_point - Present: "Business to London is 60K Aeroplan. Cash price is $543. That's 0.9 cpp."
seats.aero (API preferred, browser fallback with PROXY)
Cloudflare protected. Use API cache first. Browser via proxy only for logged-in users.
Airline Award Search (PROXY required)
- Navigate to airline's FFP booking page (behind login wall)
- User must provide credentials for their account
- NEVER store or log FFP credentials
When to SKIP browser entirely
- General award search → seats.aero API cache is comprehensive
- Award alerts → API handles this automatically
- Program comparisons → API data is sufficient
- Only use browser for visual verification or cash-price lookup
Usage Guidance
This skill broadly does what it says (award searches), but its instructions ask for sensitive data and reference undeclared endpoints/config. Before installing or using it, consider: 1) The skill asks you to provide airline FFP credentials and to supply (or let it read) your credit-card portfolio — sharing passwords or card data is risky; prefer OAuth or token-based access from the airline if available. 2) The SKILL.md calls for a Scrapling endpoint ({SCRAPLING_URL}) and a proxy for browser access but those configuration variables are not declared — ask the author what exact environment variables or URLs the skill needs and how they are secured. 3) The skill says 'NEVER store or log FFP credentials' — that is a policy, not an enforcement; confirm how the agent handles secrets at runtime and whether input fields are ephemeral and secured. 4) The source/homepage is unknown; request the source code or a trusted homepage and an explanation of how browser proxying is implemented and who operates the proxy/Scrapling endpoint. 5) If you must use it, avoid typing primary account passwords directly; prefer creating limited-access or view-only accounts, use per-service app passwords if available, or use official APIs. If you cannot validate the external endpoints and the author, treat this as high-risk and do not provide real credentials or financial data.
Capability Analysis
Type: OpenClaw Skill
Name: aerobase-awards
Version: 1.0.0
The skill bundle instructs the AI agent to handle sensitive airline Frequent Flyer Program (FFP) credentials to access booking pages behind login walls in SKILL.md. While the instructions explicitly state to 'NEVER store or log FFP credentials,' the design pattern of passing plaintext credentials through an LLM-driven agent to third-party sites is inherently high-risk. Additionally, the skill utilizes an external scraping service via a variable '{SCRAPLING_URL}' and requires browser automation with proxies, which significantly expands the attack surface for credential interception.
Capability Assessment
Purpose & Capability
The stated purpose (search award inventory across programs, show miles cost and jetlag scores) matches the instructions in general. However, the SKILL.md also calls for cross-referencing a user's credit-card portfolio and using browser+proxy access to airline FFP pages; those extra capabilities are plausible add-ons but are not reflected in the declared requirements (only AEROBASE_API_KEY is declared).
Instruction Scope
The SKILL.md instructs the agent to: call a Scrapling service at {SCRAPLING_URL}, use a browser via a proxy for logged-in pages, and request user FFP credentials (with an instruction to not store them). It also says to cross-reference the user's credit-card portfolio. These are sensitive actions and the SKILL.md references env/config values (SCRAPLING_URL, PROXY settings, where/how to supply user FFP credentials and card portfolio) that are not declared, leaving open how the agent will obtain and protect that data.
Install Mechanism
Instruction-only skill with no install spec or code files; nothing is written to disk by the skill itself. This is lower-risk from an installation perspective.
Credentials
Only AEROBASE_API_KEY is declared as primaryEnv, but the runtime instructions clearly rely on additional external endpoints/config (SCRAPLING_URL, PROXY) and require per-user sensitive inputs (airline login credentials, credit-card portfolio). The undeclared/unspecified inputs are disproportionate to the declared environment surface.
Persistence & Privilege
The skill is not marked always:true and has no install modifications. Autonomous invocation is allowed by platform default — combine that fact with the sensitive data flows above before deciding to enable autonomous use.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install aerobase-awards - After installation, invoke the skill by name or use
/aerobase-awards - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of aerobase-awards skill.
- Search over 24 major airline loyalty programs for award seats with miles cost, seat availability, and jetlag scores.
- View saved award trip searches and set up personalized award alerts (requires Pro tier for continuous monitoring).
- See price breakdowns in miles/points, automatic jetlag scoring, warning for fuel surcharges, and cents-per-point (cpp) value calculations using real cash prices from Google Flights via Scrapling.
- User rate limits: max 20 searches/hr, 10 alerts/user; award monitoring every 4 hours.
- Secure workflow for airline website access; credentials never stored or logged.
Metadata
Frequently Asked Questions
What is Aerobase Awards?
Search 24+ airline loyalty programs for award space with miles cost, seat availability, and jetlag scores. It is an AI Agent Skill for Claude Code / OpenClaw, with 327 downloads so far.
How do I install Aerobase Awards?
Run "/install aerobase-awards" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Aerobase Awards free?
Yes, Aerobase Awards is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Aerobase Awards support?
Aerobase Awards is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Aerobase Awards?
It is built and maintained by Aerobase (@kurosh87); the current version is v1.0.0.
More Skills