Communitygithub.com

Genius-Cai/myunsw-cli

API de myUNSW (portal de estudiantes de UNSW Sydney) automatizado mediante ingeniería inversa. Permite a agentes de IA consultar inscripciones, calificaciones, horarios, tarifas e información personal usando curl y cookies de sesión. 27 puntos finales documentados en 5 categorías.

¿Qué es myunsw-cli?

Esta habilidad proporciona una interfaz automatizada basada en curl para el portal de estudiantes myUNSW de la Universidad de Nueva Gales del Sur (UNSW Sydney), permitiendo a agentes de AI (como Claude Code, Cursor o Codex) realizar operaciones típicas del estudiante de forma programática. Utiliza ingeniería inversa del framework BSDS (un mecanismo de estado de sesión propietario) para navegar por las pantallas de myUNSW, extrayendo secuencialmente parámetros `bsdsSequence` y enviando solicitudes POST con las acciones correspondientes. Con 27 endpoints documentados en 5 categorías (inscripción, calificaciones, horario, tarifas e información personal), el agente puede consultar el estado de inscripción, descargar horarios en JSON, obtener resultados académicos, generar estados de cuenta, buscar clases, e incluso modificar datos personales y gestionar listas de espera. Todo ello partiendo de un archivo de cookies activo (`/tmp/myunsw_active.txt`). La sesión expira aproximadamente a los 30 minutos, por lo que se recomienda validarla periódicamente. Es ideal para automatizar tareas repetitivas de gestión académica directamente desde un agente de IA sin intervención humana.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

myUNSW CLI — Automatización del Portal de Estudiantes de UNSW

Automatiza operaciones de myUNSW (inscripción, calificaciones, horario, tarifas, información personal) mediante agente IA + curl.

Prerrequisitos

Archivo de cookies en /tmp/myunsw_active.txt con JSESSIONID (path=/active), AWSALB, AWSALBCORS. La sesión expira aprox. 30 min. Validar: curl -s -b /tmp/myunsw_active.txt 'https://my.unsw.edu.au/active/studentClassEnrol/years.xml' | grep -c 'bsdsSequence' (1=válido).

Patrón Principal (Framework BSDS)

Cada solicitud sigue:

  1. Obtener página GET → extraer bsdsSequence de un input oculto
  2. POST a la MISMA URL → bsdsSequence + bsdsSubmit-{accion} + parámetros
  3. Seguir redirección 302 → siguiente estado
  4. Extraer nuevo bsdsSequence, repetir

Reglas: usar siempre la secuencia más reciente. Solo secuencial. Secuencia obsoleta = ignorada silenciosamente.

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

Capacidades

AcciónCómo
Estado de inscripciónGET years.xml → POST → courses.xml → ?data=classes devuelve JSON
HorarioNavegar a ENR2.TTBL → timetable.xml?data=classes devuelve JSON
CalificacionesPOST a studentResults/results.xml con term=XXXX&bsdsSubmit-reload=Go
Estado académicoNavegar studentAcadStatement → statement.pdf
TarifasstudentFees/reset.xml → seleccionar estado
Búsqueda de clasesstudentClassSearch con parámetros subject/catalogNbr/term
Información personalstudentAddress, studentPhone, studentEmail, emergencyContact (lectura+escritura)
Lista de esperaEn ENR2.CRS, bsdsSubmit-manage-waitlist

Códigos de Período

5253=T1'25, 5256=T2'25, 5259=T3'25, 5263=T1'26, 5266=T2'26, 5269=T3'26. Patrón: +3 por período, ~+4 entre años.

Documentación Detallada

Ver docs/api-reference.md para documentación completa de endpoints, esquema JSON y los 27 endpoints. Ver docs/bsds-framework.md para notas de la ingeniería inversa de la máquina de estados BSDS.

Skills relacionados