/install aerobase-awards
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
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install aerobase-awards - 安装完成后,直接呼叫该 Skill 的名称或使用
/aerobase-awards触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Aerobase Awards 是什么?
Search 24+ airline loyalty programs for award space with miles cost, seat availability, and jetlag scores. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 327 次。
如何安装 Aerobase Awards?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install aerobase-awards」即可一键安装,无需额外配置。
Aerobase Awards 是免费的吗?
是的,Aerobase Awards 完全免费(开源免费),可自由下载、安装和使用。
Aerobase Awards 支持哪些平台?
Aerobase Awards 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Aerobase Awards?
由 Aerobase(@kurosh87)开发并维护,当前版本 v1.0.0。