kr-marathon-schedule 0.1.1

A Python package for scraping marathon and running event schedules in Korea

Korean Marathon Schedule Scraper

국내 마라톤, 러닝 대회 스케줄 정보를 수집하고 제공하는 Python 패키지입니다.

설치

pip install kr-marathon-schedule

사용법

프로그래밍 방식

from kr_marathon_schedule import get_marathons

# 현재 년도 마라톤 정보 가져오기
marathons = get_marathons()
print(f"총 {len(marathons)}개의 마라톤 대회")

# 특정 연도 지정
marathons_2024 = get_marathons("2024")

CLI 사용

# 기본 사용 (JSON 형식)
kr-marathon-schedule

# CSV 형식으로 저장
kr-marathon-schedule --format csv --output ./data --verbose

# 특정 연도 지정
kr-marathon-schedule --year 2024

# 도움말
kr-marathon-schedule --help

데이터 형식

{
  "year": "2025",
  "date": "1/1",
  "month": 1,
  "day": 1,
  "day_of_week": "수",
  "event_name": "2025 선양맨몸마라톤",
  "tags": ["7km"],
  "location": "대전 엑스포과학공원 물빛광장",
  "organizer": ["(주)선양소주"],
  "phone": "042-580-1823"
}

개발

git clone https://github.com/yourusername/kr-marathon-schedule.git
cd kr-marathon-schedule
pip install -e .

라이센스

MIT License

데이터 소스

https://raw.githubusercontent.com/pilyeooong/kr-marathon-schedule/refs/heads/master/marathon_data/latest-marathon-schedule.json