| name | igobot-k-school |
| description | (한국 사용자 전용) 학교알리미와 컴시간을 이용하여 전국 학교 시간표와 급식을 가져옵니다. 이 스킬에는 브라우저를 이용한 웹 크롤링과 비공식 API 호출 방법 및 컴시간 난독화 우회 방법이 모두 포함되어 있습니다. |
학교 급식 및 시간표 조회 스킬
공통: 학교 이름 파악
우선순위 순서대로 학교 이름을 파악한다:
- 사용자 메시지에 학교 이름이 포함된 경우 → 그 이름으로 바로 조회한다. 즉시 진행, 절대 다시 묻지 않는다.
memory_list로 확인한 저장된 학교 정보 → 저장된 이름으로 진행한다.- 위 둘 다 없는 경우에만 사용자에게 학교 이름을 질문한다.
학교 이름을 새로 파악했으면 저장한다:
memory_save(name="school-info", content="# 학교 정보\n\n학교명: OO고등학교\n학년: X학년\n반: X반")
검색 결과 동명이교가 여러 개 나올 때만 지역을 추가로 질문한다.
날짜가 메시지에 포함된 경우(예: "20250307", "2025-03-07", "내일", "어제") → 해당 날짜로 조회한다. 없으면 오늘.
오늘 급식 정보가 없는 경우 다음 급식 정보를 조회하고 사용자에게 알린다.
급식 조회 — 학교알리미 (schoolinfo.go.kr)
Step 1: 학교 검색 페이지 접속
browser_fetch 또는 browser_interact로 아래 학교알리미 검색 URL에 접속한다:
https://www.schoolinfo.go.kr/ei/ss/Pneiss_a01_s0.do
검색창에 학교명을 입력하고 검색 버튼을 클릭한다.
Step 2: 학교 선택
검색 결과 목록에서 정확한 학교를 선택한다. 동명이교가 있을 경우 사용자에게 지역을 물어본다.
학교 선택 후 학교 상세 페이지로 이동하면, 상단 탭에서 "급식" 또는 "학교급식" 탭을 찾아 클릭한다.
Step 3: 날짜 선택 및 메뉴 추출
- 오늘 날짜이면 기본 표시된 급식을 확인
- 다른 날짜이면 날짜 선택기에서 해당 날짜로 이동
- 조식/중식/석식 메뉴를 모두 추출
- 알레르기 번호(괄호 안 숫자)는 제거하고 메뉴명만 정리
- 칼로리 정보가 있으면 함께 표시
시간표 조회
Step 1: 컴시간 사용 여부 확인
memory_list로 저장된 정보를 확인한다.
- 컴시간 코드가 저장된 경우 → Step 3으로 바로 이동
- "미사용"으로 저장된 경우 → 시간표를 가져올수 없으므로 사용자에게 알림
- 저장 없음 → Step 2 진행
Step 2: 컴시간알리미에서 학교 검색
browser_interact로 컴시간 사이트에 접속한다:
http://컴시간학생.kr/
comci.net은 기존 웹사이트며 현재는 API 호출 외에는 사용이 불가능하다.
오류 발생시
만약 웹페이지에 502 오류가 발생한다면 컴시간 웹사이트의 문제이기 때문에 직접 API를 호출하는 방법으로 대체한다. API 호출 방법은 다음과 같다:
-
http://comci.net:4082/36179?17384l{학교명을 EUR-KR로 인코딩한 값} 으로 GET하여 학교 검색 결과를 받아온다. 검색 결과에서 학교명이 일치하는 항목을 찾아 해당 학교의 고유 코드를 추출한다.
예를들어 컴시간을 검색하려면 http://comci.net:4082/36179?17384l%C4%C4%BD%C3%B0%A3 을 사용하면 되며 이러면 응답으로 {"학교검색":[[24966,"강원","컴시간고등학교",24966]]} 와 같이 학교 검색 결과가 반환된다. 여기서 "컴시간고등학교"의 고유 코드인 24966을 추출한다.
-
http://comci.net:4082/36179?{학교코드_학급코드_0_1 를 base64로 인코딩한 값} 으로 GET하여 시간표 데이터를 받아온다.
예를들어 컴시간고등학교 1학년 1반의 시간표는 디코딩된 상태로 보면 http://comci.net:4082/36179?73629_24966_0_1 이고 이를 base64로 인코딩하여 보낼 준비가 완료된 값은 http://comci.net:4082/36179?NzM2MjlfMjQ5NjZfMF8x 이다.
오류가 발생하지 않을시
오류가 발생하지 않는다면 공식적인 방법인 웹사이트에서 학교명으로 검색한다.
-
학교가 검색되면: 해당 학교의 고유 코드(URL의 파라미터 또는 학교 ID)를 추출하여 저장:
memory_save(name="comcigan-code", content="# 컴시간 학교 코드\n\n코드: XXXXX")
→ Step 3으로 이동
-
학교가 검색되지 않으면: 미사용 표시 후 사용자에게 알림:
memory_save(name="comcigan-code", content="# 컴시간 학교 코드\n\n상태: 미사용")
Step 3: 컴시간 시간표 조회
저장된 학교 코드로 컴시간 시간표 페이지에 접속한다.
학년/반은 다음 우선순위로 파악한다:
- 사용자 메시지에 포함된 경우 (예: "2학년 3반") → 바로 사용
memory_list로 확인한 저장된 학교 정보 → 저장값 사용- 위 둘 다 없을 때만 질문한다
해당 날짜 요일의 시간표를 추출한다.
