단일 도착지를 기준으로 여러 출국일·귀국일·숙박일수 조합을 훑어보고, 저렴한 직항 후보를 비교하는 도구입니다. 최저가를 검색하기만 하고, 실제 예약은 다른 곳(여행사·항공사 홈페이지·다른 비교 사이트 등)에서 수행해도 됩니다.
A. GitHub 클라우드 환경 (Codespaces) 추천
GitHub 계정만 있으면 됩니다. 노트북에 아무것도 설치할 필요 없이 브라우저에서 바로 시작할 수 있습니다.
- 위 초록
Open in GitHub Codespaces버튼 클릭 - GitHub 로그인 (또는 가입)
- 다음 화면에서 초록
Create codespace on main버튼 한 번 클릭 - 2~3분 기다리기 — 자동으로 모든 게 깔리고 앱이 시작됩니다 (
npm run dev자동 실행) - 화면 아래쪽
PORTS탭에5173이 뜨면 → 그 줄의 주소를 복사해서 새 탭 주소창에 붙여넣기 (또는 자동으로 새 탭이 열림)
→ 새 탭에 앱이 열립니다.
⚠️ 앱이 안 뜨거나 새 탭이 안 열릴 때
- 아래쪽 시커먼 터미널 칸을 클릭한 뒤
Ctrl + C→ 다시npm run dev입력하고 Enter- 그래도 안 되면, 브라우저 탭을 닫고 https://github.com/codespaces 로 가서 같은 codespace를 다시 클릭해 들어간 뒤 위 1~2번 fallback을 다시 시도
🔎 화면 보면서 따라가고 싶다면 → 단계별 화면 가이드
💡 다 쓰면 꼭 꺼주세요 (1초)
탭만 닫으면 백그라운드에서 30분 동안 시간 차감이 계속 됩니다. 깔끔히 끄려면:
- https://github.com/codespaces 접속
- 방금 사용한 codespace 우측의
⋯(점 세 개) 클릭 Stop codespace선택 → 즉시 중지
⚠️ 결제 수단 등록 안 된 무료 계정은 한 달 60시간 한도를 넘으면 그냥 멈춥니다 (청구 X). 다만 결제 수단을 등록해둔 계정은 한도 초과 시 자동으로 과금될 수 있으니, 사용 후 반드시Stop을 눌러주세요. 30분 idle 자동 중지를 믿지 말고 직접 끄는 습관이 안전합니다.
B. 내 노트북에서 직접 로컬 PC에서 사용
- Node.js 설치 (처음 한 번만) — https://nodejs.org 에서 LTS 다운로드 후 설치
- 이 저장소 받기 — GitHub 페이지 초록
Code버튼 →Download ZIP→ 압축 풀기 - 실행:
- Windows —
scripts폴더의start.bat더블클릭 - macOS / Linux — 터미널에서
bash scripts/start.sh
- Windows —
스크립트가 알아서 설치하고 브라우저까지 열어줍니다.
혹시 브라우저가 자동으로 안 열리면, 검은 창에 뜬
http://localhost:5173/주소를 직접 브라우저 주소창에 입력하세요.
종료할 땐 검은 창에서 Ctrl + C (또는 그냥 창 닫기).
C. 개발자용 명령어로 직접 실행
npm install
npx playwright install chromium
npm run dev
npm run typecheck
npm test
npm run build
- 출발지 / 도착지 — 인기 공항 카드 또는 검색창에 도시명·IATA 코드 (예:
ICN인천,GMP김포,PUS부산,FUK후쿠오카,NRT도쿄/나리타,BKK방콕) - 검색 시작일 / 마지막일 — 이 범위 안에서 여러 출국·귀국 조합을 시도 (예: 2026-08-10 ~ 2026-08-31)
- 최소 / 최대 숙박일수 — 찾으려는 여행 기간 범위 (예: 3박 ~ 7박)
검색 폼 바로 아래에 진행 화면이 뜨고 Trip.com / Kayak / Momondo에서 가격을 모읍니다. 결과가 나오는 즉시 같은 자리에 결과 표가 등장합니다. 검색이 완료될 때까지 계속 업데이트됩니다.
- 가격 오름차순으로 정렬
- 출발 날짜, 숙박일수, 항공사, 위탁 수하물 여부로 필터링
- 항공사가 자동 확인되지 않으면
상세 확인 필요로 표시
- 출국·귀국 시각, 비행시간, 항공사, 가격 원문, 예약 링크 정리
- 예약 화면으로 바로 이동 가능
결과 카드 우측 상단의 ↑ 새 검색 버튼 → 모두 리셋
- 개인 용도 도구.
- 가격은 실제 예약 시 다를 수 있음. 참고용.
- 위탁 수하물, 좌석 선택, 결제 수수료는 예약 사이트에서 재점검 필요.
- 다른 사이트(현재 조사하는 것 이외)에서 더 쌀수도 있음.