myUNSW CLI — UNSW 學生入口網站自動化
透過 AI 代理 + curl 自動化 myUNSW 操作(選課、成績、課表、費用、個人資訊)。
必要條件
位於 /tmp/myunsw_active.txt 的 cookie 檔案,需包含 JSESSIONID(路徑為 /active)、AWSALB、AWSALBCORS。
Session 約 30 分鐘過期。驗證方式:curl -s -b /tmp/myunsw_active.txt 'https://my.unsw.edu.au/active/studentClassEnrol/years.xml' | grep -c 'bsdsSequence'(回傳 1 表示有效)。
核心模式(BSDS 框架)
每個請求遵循以下步驟:
- GET 頁面 → 從隱藏輸入中提取
bsdsSequence - POST 到同一個 URL → 帶上
bsdsSequence+bsdsSubmit-{action}和其他參數 - 跟隨 302 重定向 → 進入下一個狀態
- 提取新的
bsdsSequence,重複步驟
規則:永遠使用最新的序列。僅能依次進行。過期的序列會被靜默忽略。
COOKIE="/tmp/myunsw_active.txt"
BASE="https://my.unsw.edu.au/active"
extract_seq() { grep -oP 'bsdsSequence" value="\K[0-9]+' "$1"; }
功能
| 動作 | 方式 |
|---|---|
| 選課狀態 | GET years.xml → POST → courses.xml → ?data=classes 回傳 JSON |
| 課表 | 導航至 ENR2.TTBL → timetable.xml?data=classes 回傳 JSON |
| 成績 | POST 到 studentResults/results.xml,帶上 term=XXXX&bsdsSubmit-reload=Go |
| 學術聲明 | 導航至 studentAcadStatement → statement.pdf |
| 費用 | studentFees/reset.xml → 選擇帳單 |
| 課程搜尋 | studentClassSearch 帶上 subject/catalogNbr/term 參數 |
| 個人資訊 | studentAddress, studentPhone, studentEmail, emergencyContact(讀取+寫入) |
| 等候清單 | 在 ENR2.CRS 中,bsdsSubmit-manage-waitlist |
學期代碼
5253=T1'25, 5256=T2'25, 5259=T3'25, 5263=T1'26, 5266=T2'26, 5269=T3'26。規律:每學期 +3,跨年約 +4。
詳細文件
請參閱 docs/api-reference.md 以獲得完整的端點文件、JSON schema 以及全部 27 個端點。
請參閱 docs/bsds-framework.md 以獲得 BSDS 狀態機的反向工程筆記。