Communitygithub.com

Genius-Cai/myunsw-cli

myUNSW (UNSW 시드니 학생 포털) API 리버스 엔지니어링 자동화 도구입니다. AI 에이전트가 curl과 세션 쿠키를 사용하여 수강 신청, 성적, 시간표, 등록금, 개인 정보를 확인할 수 있도록 지원합니다. 5개 카테고리에 걸쳐 27개의 문서화된 엔드포인트를 제공합니다.

myunsw-cli란 무엇인가요?

이 스킬은 UNSW 시드니 대학교의 학생 포털인 myUNSW의 API를 리버스 엔지니어링하여 AI 에이전트가 자동화된 작업을 수행할 수 있도록 합니다. 수강 신청 상태 확인, 성적 조회, 시간표 확인, 등록금 납부 상태 확인, 개인 정보 조회 및 수정 등 학생 생활에 필요한 핵심 기능을 curl 명령어와 세션 쿠키 기반으로 제공합니다. 27개의 엔드포인트가 5개 카테고리로 문서화되어 있으며, BSFS라는 상태 기계 프레임워크를 기반으로 동작합니다. BSFS는 각 요청마다 숨겨진 `bsdsSequence` 값을 추출하여 POST 요청에 포함시켜야 하는 독특한 패턴을 따릅니다. 쿠키 파일은 `/tmp/myunsw_active.txt`에 저장되어야 하며, 세션은 약 30분 동안 유효합니다. 이 스킬은 Claude Code, Cursor, Codex 등 셸 명령어를 실행할 수 있는 모든 AI 에이전트에서 사용 가능하며, UNSW 재학생의 포털 작업을 자동화하여 시간을 절약해 줍니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓Windsurf
npx skills add Genius-Cai/myunsw-cli

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

myUNSW CLI — UNSW 학생 포털 자동화

AI 에이전트 + curl을 통해 myUNSW 작업(수강 신청, 성적, 시간표, 등록금, 개인 정보)을 자동화합니다.

사전 요구 사항

/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 → 숨겨진 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"; }

기능

동작방법
수강 신청 상태years.xml GET → POST → courses.xml → ?data=classes로 JSON 반환
시간표ENR2.TTBL로 이동 → timetable.xml?data=classes로 JSON 반환
성적studentResults/results.xml로 POST, 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를 참조하세요.

관련 스킬