Communitygithub.com

Genius-Cai/myunsw-cli

リバースエンジニアリングされたmyUNSW(UNSW Sydney学生ポータル)API自動化。AIエージェントがcurlとセッションCookieを使って履修登録、成績、時間割、学費、個人情報を確認できるようにします。5カテゴリにわたる27の文書化されたエンドポイントを提供します。

myunsw-cli とは?

このスキルは、UNSW Sydneyの学生ポータル「myUNSW」をAIエージェントから自動操作するためのCLIツールです。リバースエンジニアリングにより、myUNSWが内部的に使用するBSDS(ステートフルフォーム送信)フレームワークを解明し、curlコマンドとセッションCookieを使って履修登録状況の確認、成績照会、時間割取得、学費・個人情報の管理など計27のエンドポイントを5カテゴリにわたって利用可能にします。主にClaude CodeやCursorなどのAIエージェントがコマンドライン経由で学生情報を取得・操作するために設計されており、毎回のリクエストで最新のbsdsSequenceを取得・使用するというステートフルなパターンに従います。セッションは約30分で切れるため、事前にCookieファイルを用意し、必要に応じて再取得する必要があります。

対応✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓Windsurf
npx skills add Genius-Cai/myunsw-cli

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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フレームワーク)

すべてのリクエストは以下の手順に従います:

  1. ページをGET → hidden inputから bsdsSequence を抽出
  2. 同じURLにPOST → 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 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 を参照。

関連スキル