kschoolinfo

Find South Korean elementary, middle and high schools by name (Korean, partial names work: '상계고', '서울 대치초'). Returns eduCode and schoolCode needed by the other tools, plus school type, province and address.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "description": "School name in Korean, e.g. '상계고등학교', '효자고', '의정부 효자고'"
    },
    "region": {
      "description": "Province/metropolitan city to narrow results, e.g. '서울특별시', '경기도'",
      "type": "string",
      "maxLength": 20
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

School meal menu (breakfast/lunch/dinner) for a day, this week, next week or this month, with calories, macronutrients and allergens per dish. Pass the user's allergies to flag dishes that contain them. No meals on weekends and school holidays.

{
  "type": "object",
  "properties": {
    "eduCode": {
      "type": "string",
      "pattern": "^[A-Z]\\d{2}$",
      "description": "Office of education code from search_schools, e.g. 'B10'"
    },
    "schoolCode": {
      "type": "string",
      "pattern": "^\\d{4,12}$",
      "description": "School code from search_schools, e.g. '7010082'"
    },
    "date": {
      "description": "Date as YYYY-MM-DD or YYYYMMDD (Korea time). Omit for today.",
      "type": "string",
      "maxLength": 10
    },
    "range": {
      "description": "Instead of one day: this week (Mon–Fri), next week, or this month",
      "type": "string",
      "enum": [
        "week",
        "next_week",
        "month"
      ]
    },
    "meal": {
      "description": "Only this meal. Most schools serve lunch only.",
      "type": "string",
      "enum": [
        "breakfast",
        "lunch",
        "dinner"
      ]
    },
    "allergies": {
      "description": "Allergies to flag, in English or Korean, e.g. ['milk', 'peanut'] or ['우유', '땅콩']. 19 Korean standard allergens.",
      "maxItems": 19,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 20
      }
    }
  },
  "required": [
    "eduCode",
    "schoolCode"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Class timetable (period and subject) for a school, grade and class on a given day. Without grade/class it returns every class, so pass them when known.

{
  "type": "object",
  "properties": {
    "eduCode": {
      "type": "string",
      "pattern": "^[A-Z]\\d{2}$",
      "description": "Office of education code from search_schools, e.g. 'B10'"
    },
    "schoolCode": {
      "type": "string",
      "pattern": "^\\d{4,12}$",
      "description": "School code from search_schools, e.g. '7010082'"
    },
    "grade": {
      "description": "Grade (school year), e.g. '2'",
      "type": "string",
      "pattern": "^\\d{1,2}$"
    },
    "class_name": {
      "description": "Class (반), e.g. '3'",
      "type": "string",
      "maxLength": 10
    },
    "date": {
      "description": "Date as YYYY-MM-DD or YYYYMMDD (Korea time). Omit for today.",
      "type": "string",
      "maxLength": 10
    }
  },
  "required": [
    "eduCode",
    "schoolCode"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

School academic calendar events (exams, vacations, holidays, field trips, ceremonies) between two dates. Defaults to the next 30 days.

{
  "type": "object",
  "properties": {
    "eduCode": {
      "type": "string",
      "pattern": "^[A-Z]\\d{2}$",
      "description": "Office of education code from search_schools, e.g. 'B10'"
    },
    "schoolCode": {
      "type": "string",
      "pattern": "^\\d{4,12}$",
      "description": "School code from search_schools, e.g. '7010082'"
    },
    "from": {
      "description": "Start date YYYY-MM-DD. Omit for today.",
      "type": "string",
      "maxLength": 10
    },
    "to": {
      "description": "End date YYYY-MM-DD. Omit for 30 days after the start.",
      "type": "string",
      "maxLength": 10
    }
  },
  "required": [
    "eduCode",
    "schoolCode"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Basic school information: Korean and English name, type, address, phone, fax, homepage, founding date, public/private, coeducational or not, and the supervising office of education. For high schools, also departments/tracks.

{
  "type": "object",
  "properties": {
    "eduCode": {
      "type": "string",
      "pattern": "^[A-Z]\\d{2}$",
      "description": "Office of education code from search_schools, e.g. 'B10'"
    },
    "schoolCode": {
      "type": "string",
      "pattern": "^\\d{4,12}$",
      "description": "School code from search_schools, e.g. '7010082'"
    }
  },
  "required": [
    "eduCode",
    "schoolCode"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Registered private academies (hagwon) and tutoring centers in a South Korean district, filtered by subject keyword, from the offices of education's registration data. Returns up to 15 with field, courses, address and phone. Data in Korean.

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "description": "Province/metropolitan city, e.g. '서울', '경기', '부산'"
    },
    "district": {
      "description": "City/district (시군구) to narrow results, e.g. '강남구', '수원시'. Strongly recommended.",
      "type": "string",
      "maxLength": 20
    },
    "subject": {
      "description": "Subject keyword in Korean, e.g. '수학', '영어', '피아노', '코딩'",
      "type": "string",
      "maxLength": 20
    },
    "name": {
      "description": "Part of the academy name",
      "type": "string",
      "maxLength": 30
    }
  },
  "required": [
    "region"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}