Communitygithub.com

Genius-Cai/myunsw-cli

对 myUNSW(新南威尔士大学悉尼校区学生门户)进行反向工程实现的 API 自动化。使 AI 代理能够通过 curl 与会话 Cookie 检查注册、成绩、课程表、费用和个人信息,共包含 5 大类 27 个文档化的端点。

myunsw-cli 是什么?

这是一个专门用于自动化新南威尔士大学(UNSW)悉尼校区学生门户 myUNSW 的 AI 代理技能。它通过对 myUNSW 底层 API 进行反向工程,使 AI 代理能够直接通过 curl 命令与会话 Cookie 来执行一系列操作,包括查询注册状态、成绩、课程表、费用和个人信息。该技能基于 BSDS 框架,每个请求都需要遵循“GET 页面 → 提取 bsdsSequence → POST 请求 → 处理重定向”的固定模式,并始终使用最新的序列号。它支持 Linux/macOS 环境,依赖 curl 和 grep 命令,并且需要用户提供有效的会话 Cookie 文件。该技能文档中详细列出了 27 个覆盖 5 大类的端点,非常适合开发者或高级用户通过命令行或 AI 代理批量、自动化地管理 UNSW 学生账号信息,避免了手动登录网页的繁琐流程。

兼容平台✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓Windsurf
npx skills add Genius-Cai/myunsw-cli

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

myUNSW CLI — UNSW 学生门户自动化

通过 AI 代理加 curl 实现 myUNSW 操作自动化(注册、成绩、课程表、费用、个人信息)。

前提条件

Cookie 文件位于 /tmp/myunsw_active.txt,包含 JSESSIONID(路径为 /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 页面 → 从隐藏输入中提取 bsdsSequence
  2. POST 到同一 URL → 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 到 studentResults/results.xml,参数为 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。

详细文档

参见 docs/api-reference.md 获取完整的端点文档、JSON 模式以及全部 27 个端点。 参见 docs/bsds-framework.md 获取 BSDS 状态机反向工程的笔记。

相关技能