alaska-air
# Alaska Airlines Scraper
Alaska Air uses **SvelteKit SSR** — all flight/award data is embedded in the raw HTML response. **No Playwright or JS rendering needed.**
> ⚠️ 目前只支援**單程查詢**（RT=false）。來回票請分兩次查詢。
---
## ⚠️ 日期陷阱（CRITICAL — 必讀）
用戶說「2月14日」或「2/14」→ 查**整個2月**，但結果只顯示**有位子**的日期。
**絕對不能把「2/4」當「2/14」！** 日期要精確對應，`2027-02-04` ≠ `2027-02-14`。
如果用戶指定的日期沒有位子（`awardPoints: null`），明確告知：
```
❌ 2月14日 無可用里程票
✅ 本月最近有位：2月15日 (15,000 里程)
```
**不要默默換成別的日期後說「我找到了」。**
---
## 查詢多路線/多月份 → 平行 Sub-Agents（MANDATORY）
**2 個以上路線或月份，必須同時 spawn，絕不串行。**
每個 sub-agent 查完後**立刻用 message 工具發 Telegram** — 不要等其他 agent，有結果馬上發：
```
# 每個 Worker sub-agent 的任務模板：
spawn model=openrouter/anthropic/claude-haiku-4-5
allowedTools=exec,read,message
"用 alaska-air skill 查 {ORIGIN}→{DEST} {YYYY}年{MM}月里程行事曆。
查完後立刻用 message 工具把結果發給用戶（Telegram to: {chat_id}），
不要等其他查詢，有結果就馬上發。
輸出格式必須含 👉 直連 URL，每個日期一個 URL，URL 單獨一行，前後各空一行。"
```
範例：查 3 條路線 → 同時 spawn 3 個 Worker，每個跑完就各自發 Telegram，不等彼此。
---
## 單一路線查詢
### Step 1: 抓 HTML
`OD=` 填目標月份內**任何一天**即可，API 回傳整月資料。
```bash
curl -s -A "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 Chrome/120.0.0.0 Safari/537.36" \
"https://www.alaskaair.com/search/calendar?O={ORIGIN}&D={DEST}&OD={YYYY-MM-01}&A=1&RT=false&RequestType=Calendar&ShoppingMethod=onlineaward&locale=en-us" \
-o /tmp/alaska_{ORIGIN}_{DEST}_{YYYYMM}.html
```
### Step 2: 錯誤處理
抓完後先確認 HTML 是否含有效資料：
```bash
if ! grep -q 'awardPoints' /tmp/alaska_{ORIGIN}_{DEST}_{YYYYMM}.html; then
echo "抓取失敗：HTML 不含 awardPoints，可能被封鎖或路線無效"
exit 1
fi
```
若抓取失敗，直接回報用戶「抓取失敗，請稍後再試」，不繼續執行。
### Step 3: 提取資料（含直連 URL）
將以下內容寫入 `/tmp/parse_alaska.py`，再執行：
```python
# /tmp/parse_alaska.py
import re, json, sys
def scrape_alaska(origin, dest, yyyymm, adults=1):
html = open(f'/tmp/alaska_{origin}_{dest}_{yyyymm}.html').read()
pat = r'\{date:"([^"]+)",price:([\d.]+|null),awardPoints:(\d+|null),isDiscounted:(true|false),flightSegments:\[.*?\],solutionId:"([^"]*)"\}'
results = []
for date, price, miles, disc, sol in re.findall(pat, html):
avail = miles != 'null'
entry = {
'date': date,
'available': avail,
'miles': int(miles) if avail else None,
'price_usd': float(price) if avail else None,
'discounted': disc == 'true',
}
if avail:
entry['book_url'] = (
f"https://www.alaskaair.com/search/?O={origin}&D={dest}"
f"&D1={date}&A={adults}&RT=false&ShoppingMethod=onlineaward&locale=en-us"
)
results.append(entry)
# 按日期排序（保留所有日期，含 N/A）
return sorted(results, key=lambda x: x['date'])
origin, dest, yyyymm = sys.argv[1], sys.argv[2], sys.argv[3]
results = scrape_alaska(origin, dest, yyyymm)
available = [r for r in results if r['available']]
print(json.dumps(available, indent=2, ensure_ascii=False))
```
執行方式：
```bash
python3 /tmp/parse_alaska.py {ORIGIN} {DEST} {YYYYMM}
```
例如：`python3 /tmp/parse_alaska.py KIX TPE 202702`
---
## 輸出格式（MANDATORY）
每次查詢完成後**立刻發 Telegram**（用 message 工具），格式：
```
📅 KIX → TPE | 2027年2月
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 有位日期（按里程排序）：
2月4日 (四) 7,500 里程 + $48.3 ⭐
👉 https://www.alaskaair.com/search/?O=KIX&D=TPE&D1=2027-02-04&A=1&RT=false&ShoppingMethod=onlineaward&locale=en-us
2月2日 (二) 10,000 里程 + $45.1
👉 https://www.alaskaair.com/search/?O=KIX&D=TPE&D1=2027-02-02&A=1&RT=false&ShoppingMethod=onlineaward&locale=en-us
（若用戶指定日期無位）
❌ 2月14日 無可用里程票
```
規則：
- 按里程數**由少到多**排序
- 最便宜加 ⭐
- 每個日期必須有 👉 直連 URL，**URL 單獨一行，前後各加空行**
- 用戶指定日期無位時明確說 ❌，不要偷換成其他日期
- **查完即發，不等其他 agent**
- **Telegram chat ID 由呼叫方提供，不寫死在此**
---
## URL 參數
```
O=KIX # 出發 IATA
D=TPE # 目的地 IATA
D1=2027-02-04 # 指定日期（直連訂票頁）
OD=2027-02-01 # 月份任意日（行事曆 API，回傳整月）
A=1 # 大人數
RT=false # 單程
ShoppingMethod=onlineaward
locale=en-us
```
## 已知開放 API
```bash
curl https://www.alaskaair.com/search/api/citySearch/getAllAirports
curl https://www.alaskaair.com/search/api/discounts
curl https://www.alaskaair.com/account/token
```
标签
skill
ai
