korean-scholarship-search（韩国奖学金搜索）

장학금 검색 및 조회

사용자에게는 장학금 검색 및 조회 라는 이름으로 안내하고, skill slug는 korean-scholarship-search 이다.

What this skill does

한국장학재단, 대학, 재단, 기업, 지자체/공공기관의 공식 장학 공고를 최신 기준으로 검색하고 아래 항목을 정리한다.

이 스킬은 공식 공고 우선 이다.

• 장학금명
• 운영기관명 / 기관 유형 (school, foundation, government, company, local-government, other)
• 지원 금액 / 등록금·생활비 구분
• 신청 기간
• 지원 조건 / 지원 자격
• 학자금 지원구간(소득구간) 조건
• 공식 공고 링크 / 신청 링크

특정 학교가 주어지면 그 학교의 본부, 학생지원처, 단과대, 학과/전공, 대학원 공지를 전수 탐색하려고 시도한다. 학교가 주어지지 않으면 *.ac.kr 전체를 기준으로 전국 대학 장학 공고를 넓게 찾는다.

필요하면 동봉된 helper(scripts/scholarship_filter.py)로 사용자 조건에 맞게 후처리 필터링하고, 지원 가능 여부를 빠르게 판정하고, KST(Asia/Seoul) 현재 날짜 기준 readable report를 만든다. --today 를 생략하거나 잘못 넣으면 host local time 이 아니라 KST 오늘 날짜를 기준일로 사용한다.

Works in both Claude Code and Codex

• 이 스킬은 특정 에이전트 전용이 아니다.
• Claude Code에서도 사용 가능하고, Codex에서도 사용 가능하다.
• 핵심은 에이전트가 최신 웹 검색을 할 수 있어야 한다는 점이다.
• 장학금 마감일과 자격은 자주 바뀌므로 항상 fresh search 를 우선한다.

When to use

• "한국 장학금 전부 찾아줘"
• "서울대 학부생이 지원 가능한 재단 장학금 찾아줘"
• "생활비 200만원 이상 주는 장학금만 골라줘"
• "학교 장학금 말고 민간재단 장학금만 보고 싶어"
• "학자금 지원구간 5구간 이하 대상 장학금만 정리해줘"
• "컴퓨터공학과 대학원생 장학금 링크까지 정리해줘"
• "내 조건으로 지원 가능한지 같이 판정해줘"

When not to use

• 장학금 신청서 직접 제출/자동 접수
• 비공개 커뮤니티/로그인 뒤에서만 보이는 모집공고 수집
• 법률 자문이나 합격 보장 판단

Source priority

항상 아래 우선순위를 따른다.

1. 한국장학재단 공식 페이지 (kosaf.go.kr)
2. 대학 공식 도메인 (*.ac.kr)의 학생지원처/장학공지/학사공지
3. 공공기관/지자체/재단 공식 페이지 (*.go.kr, *.or.kr, 공식 재단 도메인)
4. 기업 공식 CSR/재단/채용·공지 페이지
5. 비공식 모음글/블로그/커뮤니티는 lead source 로만 사용하고, 공식 공고로 교차검증되지 않으면 제외

소스별 검색 패턴은 references/source-patterns.md 를 보고, 검색 누락을 줄이려면 references/search-clues.md 의 키워드와 제목 단서를 같이 쓴다.

Inputs

• 사용자 프로필

- 학교명 / 학교 유형 - 학부/대학원/고등학생 여부 - 학년 - 전공 - GPA 또는 백분위 - 학자금 지원구간

• 선호 조건

- 기관 유형 (school, foundation, government, company, local-government) - 최소/최대 금액 - 등록금형 / 생활비형 - 마감 상태 (open, upcoming) - 특정 지역 / 특정 학교 / 특정 재단

사용자가 필터링을 원하지만 핵심 입력이 비어 있으면, 한 번에 1~3개만 짧게 보강 질문한다.

Prerequisites

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

Workflow

1. 검색 범위를 먼저 정한다

• 사용자가 "전체"를 원하면 학교/재단/공공기관을 다 포함해 넓게 찾는다.
• 사용자가 "재단만", "학교 공고만", "생활비만" 같은 제약을 주면 그 제약부터 적용한다.
• 날짜 관련 표현은 반드시 절대 날짜로 정리한다.

2. 공식 소스를 병렬 탐색한다

최소한 아래 3축을 본다.

• 한국장학재단 공식 장학 페이지
• 사용자 학교 또는 관련 대학군의 공식 장학 공지
• 재단/기업/공공기관 공식 공고

검색 제목이 장학금 이 아닐 수 있으니 장학생 모집, 외부 장학 추천, 등록금 감면, 생활비 지원, 학업장려비, 추천장학, 근로장학, 성적우수 장학 도 같이 본다.

대표 검색 예시:

• site:kosaf.go.kr 장학금 {키워드}
• site:{학교도메인} 장학 공고
• site:*.ac.kr 장학 공고 {학교명} {전공}
• site:*.or.kr 장학생 선발 {키워드}
• site:*.go.kr 장학금 공고 {지역명}

2-1. 학교/학과 완전 탐색 모드

사용자가 특정 학교를 주면 아래 순서를 빠뜨리지 않는다.

1. 학교 대표 도메인 확인
2. 학생지원처 / 장학팀 / 학사공지 게시판 확인
3. 단과대학 공지 확인
4. 학과 / 전공 / 대학원 과정 홈페이지 공지 확인
5. 첨부 PDF/HWP가 있으면 같이 열어 조건을 확인
6. 교내 장학과 외부 추천 장학을 분리해서 정리

학교 완전 탐색 체크리스트는 references/school-discovery.md 를 본다.

학교별 search plan을 만들 때는:

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

전국 대학 sweep query를 만들 때는:

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

3. 각 후보를 정규화한다

후보마다 최소한 아래 필드를 채운다.

{
  "name": "장학금명",
  "organization": {
    "name": "운영기관명",
    "type": "foundation"
  },
  "source_url": "https://official.example.com/notice/123",
  "apply_url": "https://official.example.com/apply",
  "amount": {
    "text": "학기당 250만 원",
    "per_semester_krw": 2500000,
    "category": "living"
  },
  "deadline": {
    "start": "2026-04-01",
    "end": "2026-04-20",
    "status": "open"
  },
  "eligibility": {
    "student_levels": ["undergraduate"],
    "school_names": ["서울대학교"],
    "school_kinds": ["university"],
    "majors": ["컴퓨터공학", "소프트웨어"],
    "grade_years": [2, 3, 4],
    "gpa_min": 3.0,
    "income_band_min": 0,
    "income_band_max": 8,
    "notes": ["직전학기 12학점 이상"]
  },
  "verified_at": "2026-04-14",
  "source_kind": "official"
}

4. helper로 필터링하거나 지원 가능 여부를 본다

여러 장학금 후보를 JSON으로 정리한 뒤:

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 하게 보기:

python3 scripts/scholarship_filter.py report \
  --input scholarships.json \
  --today 2026-04-14 \
  --only-open-now \
  --school-name "서울대학교"

마감 임박 공고만 보기:

python3 scripts/scholarship_filter.py report \
  --input scholarships.json \
  --today 2026-04-14 \
  --deadline-within-days 7

5. 사용자에게는 compact하게 보여준다

• 상위 매칭 장학금부터 정리
• 장학금명 / 기관 / 금액 / 신청기간 / 핵심 조건 / 링크
• 필터 불일치 이유가 있으면 한 줄로 설명
• "지원 가능", "조건 일부 미확인", "현재 조건으로는 불일치"를 짧게 표시

기본 출력 form은 아래 순서를 따른다.

1. 요약 블록: 총 후보 수 / 열린 공고 수 / 곧 마감 수
2. 지금 지원 가능
3. 곧 열림
4. 조건은 맞지만 마감됨

각 항목은 이 형식으로 정리한다.

• 장학금명
• 기관명 / 기관 유형
• 금액
• 신청기간 + KST 기준 현재 날짜 상태 (open, upcoming, closed, D-3)
• 학교/학과/학년/성적/지원구간 핵심 조건
• 공식 공고 링크
• 신청 링크

더 자세한 form 규칙은 references/report-format.md 를 본다.

Response policy

• 공식 공고 링크와 신청 링크를 반드시 남긴다.
• 금액이 숫자로 안 보이면 원문 텍스트를 그대로 남기고, 추정 금액은 임의로 만들지 않는다.
• 블로그/카페/홍보글만 발견되면 공식 공고를 다시 찾고, 못 찾으면 "미검증" 으로 표시한다.
• 장학금 마감일은 반드시 절대 날짜로 적는다.
• 사용자가 "내 조건으로 걸러줘" 라고 하면 금액, 학교/재단 여부, 학자금 지원구간, 학부/대학원 여부를 우선 필터로 사용한다.
• 학자금 지원구간은 한국장학재단 표기를 기준으로 0~10 정수 또는 범위로 정규화한다.

Keep the answer compact

• 총 후보 수
• 필터 후 남은 후보 수
• 상위 5~10개만 표 또는 리스트
• 각 항목마다 공식 링크 1개 이상
• 필요 시 "추가로 더 좁힐 수 있는 필터" 2~3개 제안

Ready-to-paste prompts

1. 전체 탐색

장학금 검색 및 조회 스킬을 사용해서 지금 신청 가능하거나 곧 열리는 한국 장학금 공고를 찾아줘. 한국장학재단, 전국 대학교, 재단, 기업, 공공기관 공식 공고만 포함하고, KST 기준 현재 날짜로 열린 공고와 곧 열릴 공고를 나눠서 보여줘. 각 항목마다 장학금명, 기관명, 기관 유형, 지원 금액, 신청 기간, 핵심 자격, 학자금 지원구간 조건, 공식 공고 링크, 신청 링크를 가독성 좋은 섹션형 form으로 정리해줘.

2. 사용자 조건 기반 필터링

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

공식 공고만 포함하고, KST 기준 현재 날짜로 마감 여부도 고려해서 지원 가능 여부를 가능/불확실/불가로 표시해줘.

3. 학교 장학 vs 재단 장학 비교

장학금 검색 및 조회 스킬을 사용해서 연세대학교 학부생이 지원할 수 있는 교내 장학금과 민간재단 장학금을 나눠서 보여줘. 학교 본부 장학공지, 단과대, 학과 홈페이지 장학 공지를 모두 확인하고, 금액, 신청 기간, 소득구간 조건, 성적 조건, 공식 링크를 같이 정리하고 어느 쪽이 내 조건에 더 맞는지 짧게 비교해줘.

4. 지원 가능 여부만 빠르게 보기

장학금 검색 및 조회 스킬을 사용해서 아래 프로필로 지원 가능성이 있는 장학금만 골라줘.
- 학교: 고려대학교
- 학생 구분: 대학원생
- 전공: 전산학
- GPA: 3.8/4.5
- 학자금 지원구간: 4구간
- 원하는 유형: 생활비 장학금

각 항목마다 왜 맞는지 또는 어떤 조건이 불확실한지 한 줄씩 붙여줘.

Done when

• 공식 공고 중심으로 후보를 모았다.
• 금액, 자격, 지원구간, 신청기간, 링크를 정리했다.
• 사용자가 준 조건으로 필터링했다.
• 지원 가능 여부를 빠르게 판단했다.
• 비공식 출처는 공식 페이지로 검증했거나 제외했다.

Notes

• 한국장학재단 공식 장학·지원구간 표면은 references/source-patterns.md 참고
• 학교별 장학 공지는 HTML 구조가 제각각이므로, 공고 제목/본문/첨부를 같이 읽어야 한다.
• 장학금 "조건" 과 "우대사항" 을 섞지 않는다.
• "등록금 전액" 같은 비정액 장학금은 amount.text 를 유지하고 수치가 없으면 *_krw 는 비워둔다.