Communitygithub.com

Genius-Cai/myunsw-cli

反向工程 myUNSW(UNSW Sydney 學生入口網站)API 自動化。讓 AI 代理可以透過 curl 和 session cookie 檢查選課、成績、課表、費用和個人資訊。共 27 個已記錄的端點,涵蓋 5 大類別。

myunsw-cli 是什麼?

myUNSW CLI 是一個反向工程工具,專門自動化 UNSW Sydney 學生入口網站 myUNSW 的操作。它允許 AI 代理(如 Claude Code、Cursor、Codex 等)透過 curl 和 session cookie 來執行選課、成績、課表、費用查詢以及個人資訊管理等任務。該技能基於 BSDS(Base State Data Skeleton)框架,這是一個基於階段的狀態機,每個請求需要先 GET 頁面取得 bsdsSequence 隱藏輸入值,再 POST 到相同 URL 提交該序列與其他參數,並跟隨 302 重定向以推進流程。它支援 27 個已記錄的端點,涵蓋 5 大類別,包括選課狀態、課表、成績、學術聲明、費用、課程搜尋、個人資訊(讀寫)和等候清單。使用時需要一個包含 JSESSIONID、AWSALB、AWSALBCORS 的 cookie 檔案(約 30 分鐘過期),並依賴 curl 命令與 shell 函數(如 extract_seq)來解析 bsdsSequence。此技能對於需要自動化學生入口網站操作的開發者、AI 代理使用者或整合測試者非常有用。

相容平台✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓Windsurf
npx skills add Genius-Cai/myunsw-cli

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 框架)

每個請求遵循以下步驟:

  1. GET 頁面 → 從隱藏輸入中提取 bsdsSequence
  2. POST 到同一個 URL → 帶上 bsdsSequence + bsdsSubmit-{action} 和其他參數
  3. 跟隨 302 重定向 → 進入下一個狀態
  4. 提取新的 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 狀態機的反向工程筆記。

相關技能