Communitygithub.com

Genius-Cai/myunsw-cli

Interface CLI pour le portail étudiant myUNSW (UNSW Sydney) par rétro-ingénierie de l'API. Permet aux agents IA de consulter les inscriptions, notes, emploi du temps, frais et informations personnelles via curl et cookies de session.

Qu'est-ce que myunsw-cli ?

Ce skill permet à un agent IA (comme Claude Code, Cursor ou Codex) d'interagir automatiquement avec le portail étudiant myUNSW de l'Université de Nouvelle-Galles du Sud (UNSW Sydney) en utilisant une API reverse-engineered. Il expose 27 endpoints documentés répartis en 5 catégories : état d'inscription, notes, emploi du temps, frais et informations personnelles. Le fonctionnement repose sur le framework BSDS (une machine d'état propriétaire du portail) : chaque interaction nécessite d'extraire un jeton `bsdsSequence` depuis une page, de le soumettre avec l'action souhaitée en POST, puis de suivre la redirection. Une session valide, stockée sous forme de fichier cookie, est indispensable (durée de vie d'environ 30 minutes). Le skill fournit un pattern CLI simple avec curl, des commandes d'extraction et une documentation détaillée des endpoints dans `docs/api-reference.md`.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

myUNSW CLI — Automatisation du portail étudiant UNSW

Automatisez les opérations myUNSW (inscriptions, notes, emploi du temps, frais, informations personnelles) via agent IA + curl.

Prérequis

Fichier cookie à l'emplacement /tmp/myunsw_active.txt contenant JSESSIONID (path=/active), AWSALB, AWSALBCORS. La session expire au bout d'environ 30 min. Validation : curl -s -b /tmp/myunsw_active.txt 'https://my.unsw.edu.au/active/studentClassEnrol/years.xml' | grep -c 'bsdsSequence' (1 = valide).

Pattern de base (Framework BSDS)

Chaque requête suit ces étapes :

  1. GET une page → extraire bsdsSequence depuis un champ caché
  2. POST vers la MÊME URL → bsdsSequence + bsdsSubmit-{action} + paramètres
  3. Suivre la redirection 302 → état suivant
  4. Extraire un nouveau bsdsSequence, répéter

Règles : toujours utiliser la séquence la plus récente. Exécution séquentielle uniquement. Une séquence obsolète est ignorée silencieusement.

COOKIE="/tmp/myunsw_active.txt"
BASE="https://my.unsw.edu.au/active"
extract_seq() { grep -oP 'bsdsSequence" value="\K[0-9]+' "$1"; }

Fonctionnalités

ActionComment
État d'inscriptionGET years.xml → POST → courses.xml → ?data=classes retourne du JSON
Emploi du tempsNaviguer vers ENR2.TTBL → timetable.xml?data=classes retourne du JSON
NotesPOST vers studentResults/results.xml avec term=XXXX&bsdsSubmit-reload=Go
Relevé académiqueNaviguer studentAcadStatement → statement.pdf
FraisstudentFees/reset.xml → sélectionner le relevé
Recherche de coursstudentClassSearch avec paramètres subject/catalogNbr/term
Infos personnellesstudentAddress, studentPhone, studentEmail, emergencyContact (lecture+écriture)
Liste d'attenteDans ENR2.CRS, bsdsSubmit-manage-waitlist

Codes de période

5253=T1'25, 5256=T2'25, 5259=T3'25, 5263=T1'26, 5266=T2'26, 5269=T3'26. Motif : +3 par période, ~+4 entre années.

Documentation détaillée

Consultez docs/api-reference.md pour la documentation complète des endpoints, le schéma JSON et les 27 endpoints. Consultez docs/bsds-framework.md pour les notes de rétro-ingénierie de la machine d'état BSDS.

Skills associés