🎰 Lotto Auto Purchase

동행복권 자동구매 시스템 - 로또 6/45 및 연금복권 720 자동화

Important

동행복권 구매지원 도구이며, 자동구매 설정시 신중한 확인 필요 모든 구매 결과 및 예치금 사용 책임은 사용자 본인에게 있음

복권 과몰입 및 중독 예방 제도 준수 동행복권 제공 제도(구매 한도, 충전 제한, 이용 시간 등) 범위 내에서만 동작하도록 설계됨. 해당 제도를 우회하거나 무력화하는 기능 미포함.

📋 목차

기능
프로젝트 구조
설치
사용법
Systemd 타이머 설정
환경 변수
스크립트 설명

✨ 기능

자동화된 로또 구매 워크플로우

잔액 확인 - 구매가능 금액 조회
조건부 충전 - 잔액 부족 시 자동 충전 (10,000원)
연금복권 720 구매 - 자동 구매
로또 6/45 구매 - 자동/수동 번호 선택 구매

주요 기능

✅ 완전 자동화 - Playwright 기반 브라우저 자동화
✅ OCR 키패드 인식 - 랜덤 키패드 자동 입력 (Tesseract)
✅ 결제 금액 검증 - 구매 전 금액 확인
✅ Systemd 타이머 - 매주 일요일 자동 실행 로직
✅ 유연한 설정 - 커맨드라인 인자 또는 .env 파일 지원

📁 프로젝트 구조

lotto/
├── src/                          # Python 스크립트
│   ├── balance.py               # 잔액 조회
│   ├── charge.py                # 예치금 충전 (간편 충전)
│   ├── login.py                 # 로그인 모듈
│   ├── lotto645.py              # 로또 6/45 구매
│   └── lotto720.py              # 연금복권 720 구매
├── scripts/                      # 실행 스크립트
│   ├── purchase.sh              # 메인 워크플로우 스크립트
│   ├── setup-env.sh             # 환경 설정 (venv, pip)
│   ├── install-systemd.sh       # Systemd 타이머 설치
│   └── systemd/                 # Systemd 설정 파일
│       ├── lotto.service        # 서비스 정의
│       └── lotto.timer          # 타이머 정의 (매주 일요일 09:00)
├── .env                          # 환경 변수 (비공개)
├── .env.example                  # 환경 변수 예시
├── requirements.txt              # Python 의존성
└── README.md                     # 설명 문서

🚀 시작하기

두 가지 사용 방식 지원, 상황에 맞는 방법 선택

Option A: 개인 서버/로컬 컴퓨터 - 내 컴퓨터나 Linux 서버(EC2, 홈서버 등)에서 직접 실행
Option B: GitHub Actions - 서버 없이 GitHub 클라우드에서 자동 실행

🖥️ Option A: 개인 서버/로컬 컴퓨터

1. 설치

저장소 클론:

git clone https://github.com/yoonbae81/lotto.git
cd lotto

환경 설정:

cd scripts
./setup-env.sh

Python 가상환경 생성, 의존성 설치, 브라우저 설치, .env 파일 자동 생성

2. 환경 변수 설정

.env 파일 편집하여 로또 계정 정보 입력

nano ../.env

3. 수동 실행 (테스트)

설정 확인을 위한 수동 실행

cd ~/GitHub/lotto
source .venv/bin/activate

잔액 확인: ./src/balance.py
전체 워크플로우 실행:

./scripts/purchase.sh

4. 자동화 설정 (Systemd 타이머)

Linux 서버 Systemd 이용 매주 일요일 아침 자동 실행 설정

설치:

cd scripts
./install-systemd.sh

관리 명령어:

systemctl --user status lotto.timer      # 상태 확인
systemctl --user list-timers lotto.timer # 다음 실행 시간 확인
journalctl --user -u lotto.service -f    # 로그 확인

☁️ Option B: GitHub Actions (서버 없음)

개인 서버 없이 GitHub Actions 이용 매주 자동 실행 가능, 컴퓨터 상시 가동 불필요

1. Fork 하기

이 저장소를 본인의 GitHub 계정으로 Fork 수행

2. Secrets 설정

Fork한 리포지토리의 Settings > Secrets and variables > Actions에서 New repository secret 클릭 후 변수 추가

Name	Value	설명
`USER_ID`	`your_id`	동행복권 아이디
`PASSWD`	`your_password`	동행복권 비밀번호
`CHARGE_PIN`	`123456`	충전용 PIN 6자리
`AUTO_GAMES`	`3`	(선택) 자동 게임 수
`MANUAL_NUMBERS`	`[[1,2,3,4,5,6]]`	(선택) 수동 번호 JSON

3. 실행 확인

자동 실행: 매주 일요일 09:00 (KST) 자동 실행
수동 실행: 상단 Actions 탭 > Lotto Purchase 워크플로우 선택 > Run workflow 버튼 클릭

🔧 환경 변수

필수 변수

변수	설명	예시
`USER_ID`	동행복권 아이디	`your_id`
`PASSWD`	동행복권 비밀번호	`your_password`
`CHARGE_PIN`	충전용 6자리 PIN	`123456`

선택 변수

변수	설명	기본값	예시
`AUTO_GAMES`	로또 6/45 자동 게임 수	`0`	`5`
`MANUAL_NUMBERS`	로또 6/45 수동 번호 (JSON)	`[]`	`[[1,2,3,4,5,6]]`

.env 파일 예시

# 동행복권 계정 정보
USER_ID=myid
PASSWD=mypassword

# 간편충전 PIN (6자리)
CHARGE_PIN=123456

# 로또 6/45 설정
AUTO_GAMES=1
MANUAL_NUMBERS=[]

# 또는 수동 번호 지정
# MANUAL_NUMBERS=[[1,2,3,4,5,6], [7,8,9,10,11,12]]

📜 스크립트 설명

Python 스크립트 (`src/`)

`balance.py`

예치금 잔액 및 구매가능 금액 조회
반환값: {'deposit_balance': int, 'available_amount': int}

`charge.py`

간편충전 기능 (가상계좌 입금 아님)
OCR 활용 랜덤 키패드 자동 인식
지원 금액: 5,000원, 10,000원, 20,000원

`login.py`

공통 로그인 모듈
타 스크립트 import 사용

`lotto645.py`

로또 6/45 구매
자동/수동 번호 선택 가능
결제 금액 검증

`lotto720.py`

연금복권 720 구매
임의 번호 모든 조(組) 자동 선택
고정 금액: 5,000원
결제 금액 검증

Shell 스크립트 (`scripts/`)

`setup-env.sh`

환경 설정 스크립트:

Python 가상환경 생성
pip 및 의존성 설치
Playwright 브라우저 설치
.env 파일 생성

`purchase.sh`

메인 워크플로우 스크립트:

잔액 확인
조건부 충전 (10,000원 미만 시)
로또 720 구매
로또 645 구매

`install-systemd.sh`

Systemd 타이머 설치:

서비스/타이머 파일 복사
경로 자동 설정 ({{PROJECT_ROOT}} 치환)
타이머 활성화 및 시작

🛠️ 기술 스택

Python 3.9+
Playwright - 브라우저 자동화
Tesseract OCR - 키패드 숫자 인식
Pillow - 이미지 처리
python-dotenv - 환경 변수 관리
Systemd - 스케줄링 (Linux)

⚠️ 주의사항

간편 충전 사용: [간편충전] 기능 사용, [가상계좌 입금] 미지원
OCR 정확도: 키패드 숫자 인식률 약 90-95%, 실패 시 재시도 또는 수동 확인 요망
Linux 전용: Systemd 타이머 Linux 전용, macOS launchd 사용 필요
보안: .env 파일 커밋 금지 (.gitignore 포함)
테스트: 실제 사용 전 수동 스크립트 테스트 권장

🐛 트러블슈팅

OCR 인식 실패

# Tesseract 재설치 (macOS)
brew reinstall tesseract

# Tesseract 재설치 (Ubuntu/Debian)
sudo apt-get install --reinstall tesseract-ocr

Playwright 브라우저 오류

# 브라우저 재설치
.venv/bin/playwright install chromium

환경 변수 로드 안됨

# .env 파일 위치 확인
ls -la .env

# 권한 확인
chmod 600 .env

Systemd 타이머 작동 안함

# 사용자 세션 유지 (로그아웃 후에도 실행)
loginctl enable-linger $USER

# 타이머 재시작
systemctl --user daemon-reload
systemctl --user restart lotto.timer

GitHub Actions 자동 실행 활성화

기본적으로 .github/workflows/purchase.yml 자동 실행 스케줄 주석 처리됨 자동 실행 희망 시 해당 파일 schedule 부분 주석(#) 제거 요망

Cron 설정 참고:

시간: UTC 기준 (한국 시간 -9시간)
- 예: 30 0 * * 1 → UTC 00:30 (한국 시간 월요일 오전 09:30)
요일: 0 (일요일) ~ 6 (토요일)

# 수정 전
# schedule:
#   - cron: '0 0 * * 0'

# 수정 후
schedule:
  - cron: '30 0 * * 1'

Name		Name	Last commit message	Last commit date
Latest commit History 13 Commits
.github/workflows		.github/workflows
scripts		scripts
src		src
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
requirements.txt		requirements.txt

Folders and files

Latest commit

History

Repository files navigation

🎰 Lotto Auto Purchase

📋 목차

✨ 기능

자동화된 로또 구매 워크플로우

주요 기능

📁 프로젝트 구조

🚀 시작하기

🖥️ Option A: 개인 서버/로컬 컴퓨터

1. 설치

2. 환경 변수 설정

3. 수동 실행 (테스트)

4. 자동화 설정 (Systemd 타이머)

☁️ Option B: GitHub Actions (서버 없음)

1. Fork 하기

2. Secrets 설정

3. 실행 확인

🔧 환경 변수

필수 변수

선택 변수

.env 파일 예시

📜 스크립트 설명

Python 스크립트 (src/)

balance.py

charge.py

login.py

lotto645.py

lotto720.py

Shell 스크립트 (scripts/)

setup-env.sh

purchase.sh

install-systemd.sh

🛠️ 기술 스택

⚠️ 주의사항

🐛 트러블슈팅

OCR 인식 실패

Playwright 브라우저 오류

환경 변수 로드 안됨

Systemd 타이머 작동 안함

GitHub Actions 자동 실행 활성화

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages