Get the current student's profile: full name (ФИО), group, student book number, institute, specialty, study form, education level, and enrollment status.

Get information about a teacher by their numeric profile ID. Returns full name (ФИО), academic degree/rank, and list of positions (each with position title, department, and organization). Teacher IDs are available in list_tasks, get_task, and list_materials results.

Get detailed information about a specific subject/discipline by its numeric ID. Returns name, department (кафедра), year and semester, control type (экзамен/зачёт/КП etc.), current grade, total hours, and the assigned teacher with their position. Subject IDs are available in list_tasks, get_task, and list_materials results.

Get the current student's order number (порядковый номер) in the group list. Also returns the total number of students in the group, the student's full name, and the group name.

List tasks assigned to the student. Returns task id, discipline, name, status, points (earned/max), type, deadline, and teacher. All filters are optional and default to showing everything for the current semester. semester: numeric semester ID (e.g. 27 = '2025/2026 весенний'). subject_id: numeric discipline ID to show tasks for one subject only. task_type: 0=все, 1=Курсовой проект, 2=Лабораторная работа, 3=Реферат, 4=Контрольная работа, 5=Расчетно-графическая работа, 6=Расчетное задание, 7=Эссе, 8=Отчет о практике, 9=Проверочная работа, 10=Индив. задание по ин. яз., 11=Текущее тестирование, 12=Научный доклад, 13=Отчет о науч. исслед., 14=Индивидуальное задание, 15=Практические задания, 16=Работа на занятии. show_status: 0=все, 1=только без отчета, 2=ожидающие проверки, 3=только принятые, 4=только непринятые, 5=все кроме принятых.

Get full details for a specific task by its numeric ID. Includes: description, allowed file extensions for the report, extra materials links, deadline, and the list of already submitted reports with their statuses.

List learning materials available to the student. Each material has a name, discipline, date added, teacher, and either a download URL (for files hosted on pro.guap.ru) or an external URL (Google Drive, etc.). All filters are optional and default to the current semester. semester: numeric semester ID (e.g. 27 = '2025/2026 весенний'). subject_id: numeric discipline ID to show materials for one subject only.

Download a material file by URL. Works for three kinds of URLs: (1) pro.guap.ru internal links — authenticated automatically via the session cookie; (2) Google Drive share links (drive.google.com/file/d/...) — handles the confirmation page; (3) any other direct download URL (PDF, ZIP, etc.). The file is saved to ~/Downloads/guap-materials/ by default. Returns the local file path, filename, size in bytes, and content type.

Submit a report file for a specific task. The file must already exist on the local filesystem. Allowed extensions depend on the task — check get_task first. An optional comment can be included with the submission.

Authenticate with GUAP via browser automation. Opens a browser window, navigates to pro.guap.ru login page, waits for you to enter credentials, and saves session cookies. The cookies are saved to a file and will be used automatically for subsequent requests. Timeout is 120 seconds by default.

Check if current authentication cookies are valid. Returns whether cookies are valid and can access the GUAP profile.