myUNSW CLI — UNSW学生ポータル自動化
AIエージェントとcurlを使ってmyUNSWの操作(履修登録、成績、時間割、学費、個人情報)を自動化します。
前提条件
Cookieファイルを /tmp/myunsw_active.txt に配置し、JSESSIONID(path=/active)、AWSALB、AWSALBCORSを含めること。
セッションは約30分で失効します。検証:curl -s -b /tmp/myunsw_active.txt 'https://my.unsw.edu.au/active/studentClassEnrol/years.xml' | grep -c 'bsdsSequence'(1=有効)。
コアパターン(BSDSフレームワーク)
すべてのリクエストは以下の手順に従います:
- ページをGET → hidden inputから
bsdsSequenceを抽出 - 同じURLにPOST →
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 to studentResults/results.xml with 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。
詳細ドキュメント
完全なエンドポイントドキュメント、JSONスキーマ、全27エンドポイントについては docs/api-reference.md を参照。
BSDSステートマシンのリバースエンジニアリングノートについては docs/bsds-framework.md を参照。