k-skill/docs/features/korean-scholarship-search.md

장학금 검색 및 조회 가이드

이 기능으로 할 수 있는 일

• 한국장학재단, 전국 대학교, 재단, 기업, 공공기관의 최신 장학 공고 검색
• 장학금별 금액, 지원 자격, 학자금 지원구간, 신청 기간, 링크 정리
• 사용자 조건(학교, 학부/대학원, 전공, 학과, 금액, 기관 유형) 기반 필터링
• KST(Asia/Seoul) 현재 날짜 기준으로 지금 지원 가능, 곧 열림, 마감됨 구분
• 정규화된 JSON 목록에 대해 지원 가능 여부 빠른 판정
• readable markdown report 출력

가장 중요한 규칙

이 기능은 공식 공고 우선 이다.

• kosaf.go.kr, *.ac.kr, *.go.kr, *.or.kr, 공식 재단/기업 도메인을 우선 본다.
• 블로그/커뮤니티/모음글은 lead source 로만 쓰고, 공식 공고로 검증되지 않으면 결과에서 제외한다.
• 신청 기간은 반드시 절대 날짜로 적는다.
• 최종 결과에는 공식 공고 링크와 신청 링크를 함께 남긴다.

먼저 필요한 것

• 인터넷 연결
• 최신 웹 검색 가능 에이전트
• 선택: python3 3.8+ (scripts/scholarship_filter.py helper 사용 시)

추천 검색 순서

1. 한국장학재단에서 전국 단위 장학/지원구간 관련 공고를 먼저 본다.
2. 사용자 학교가 있으면 해당 학교 공식 장학 공지를 본다.
3. 재단/기업/공공기관 공식 페이지를 추가로 찾는다.
4. 각 공고에서 금액, 자격, 지원구간, 기간, 신청 링크를 정규화한다.
5. 필요하면 helper로 필터링하고 지원 가능 여부를 본다.

특정 학교를 지정하면 학교 본부 장학공지, 학생지원처, 단과대, 학과/전공 홈페이지 공지를 순서대로 확인한다. 학교를 지정하지 않으면 전국 대학 *.ac.kr 공고를 넓게 탐색한다.

검색할 때는 장학금 만 보지 말고 장학생 모집, 외부 장학 추천, 등록금 감면, 생활비 지원, 학업장려비, 추천장학, 근로장학 같은 제목 단서도 같이 본다.

공식 표면 예시

• 한국장학재단 푸른등대 기부장학금: https://www.kosaf.go.kr/ko/scholar.do?pg=scholarship05_11_01
• 한국장학재단 학자금 지원구간 산정절차: https://www.kosaf.go.kr/ko/tuition.do?pg=tuition04_09_01&type=tuition
• 한국장학재단 학자금 지원구간 경곗값: https://www.kosaf.go.kr/ko/tuition.do?naviParam=JH%2C01%2C01%2C03&pg=tuition04_09_07
• 삼성꿈장학재단: https://www.sdream.or.kr/w/web60gV
• 대학 장학 공지: 각 대학 공식 *.ac.kr 학생지원처/장학공지

helper 사용 예시

정규화된 장학금 JSON 파일(scholarships.json)이 있다고 가정:

재단 장학금만 + 학부생 + 5구간 이하 + 200만원 이상

python3 scripts/scholarship_filter.py filter \
  --input scholarships.json \
  --org-type foundation \
  --student-level undergraduate \
  --income-band 5 \
  --min-amount 2000000

내 조건으로 지원 가능 여부 판정

python3 scripts/scholarship_filter.py eligibility \
  --input scholarships.json \
  --school-name "서울대학교" \
  --student-level undergraduate \
  --grade-year 2 \
  --gpa 3.5 \
  --income-band 5

KST 기준 readable report:

python3 scripts/scholarship_filter.py report \
  --input scholarships.json \
  --today 2026-04-14 \
  --only-open-now

학교별 exhaustive query plan 생성:

python3 scripts/university_search_plan.py \
  --school-name "부산대학교" \
  --department "컴퓨터공학과" \
  --year 2026

전국 대학 sweep query 생성:

python3 scripts/university_search_plan.py --nationwide --year 2026

바로 쓸 프롬프트 예시

장학금 검색 및 조회 스킬을 사용해서 지금 신청 가능하거나 곧 열리는 한국 장학금 공고를 찾아줘. 한국장학재단, 전국 대학교, 재단, 기업, 공공기관 공식 공고만 포함하고, KST 기준 현재 날짜로 열린 공고와 곧 열릴 공고를 나눠서 가독성 좋은 form으로 정리해줘.

장학금 검색 및 조회 스킬을 사용해서 내 조건에 맞는 장학금만 찾아줘.
- 학교: 서울대학교
- 학생 구분: 학부생
- 학년: 2학년
- 전공: 컴퓨터공학
- 학과: 컴퓨터공학부
- 학자금 지원구간: 5구간
- 최소 금액: 200만원
- 기관 유형: 재단

지원 가능 여부도 같이 표시해줘.

결과 form 권장

1. 요약: 총 후보 수 / 열린 공고 수 / 곧 열릴 공고 수
2. 지금 지원 가능
3. 곧 열림
4. 마감됨

각 항목은 아래 순서로 보여주면 읽기 좋다.

• 장학금명
• 기관 / 기관 유형
• 금액
• 신청기간
• KST 기준 현재 날짜 상태
• 핵심 조건
• 공식 공고 링크
• 신청 링크

조건이 불명확한 항목은 숨기지 말고 미확인 으로 남긴다.

답변 템플릿 권장

• 장학금명
• 운영기관 / 기관 유형
• 지원 금액
• 신청 기간
• 핵심 자격 요건
• 학자금 지원구간 조건
• 공식 공고 링크
• 신청 링크
• 내 조건 기준 간단 판정

주의 사항

• scripts/scholarship_filter.py 에서 --today 를 생략하거나 잘못 넣으면 host local time 이 아니라 KST 오늘 날짜를 기준으로 마감 상태를 계산한다.
• "등록금 전액" 같이 금액이 정액이 아닌 공고는 원문 텍스트를 그대로 유지한다.
• 성적 조건이 4.5 만점인지 100점 만점인지 공고마다 다르므로 원문 기준을 같이 적는다.
• 장학금은 학기별/연도별로 반복되더라도 조건과 마감일이 달라질 수 있으니, 과거 공고를 최신 공고로 착각하지 않는다.
• 학자금 지원구간 관련 설명은 한국장학재단 기준을 우선 참고한다.