k-auction

대한민국 법원경매정보(courtauction.go.kr) 매각공고 및 사건정보 크롤링 프로젝트.

⚠️ 시작하기 전에 반드시 BLOCKED.md 를 먼저 읽으세요.
이 사이트는 자동화 호출에 매우 민감하여 정책을 위반하면 IP가 약 1시간 차단됩니다.

참고

• k-skill court-auction-notice-search — 원본 Node.js 패키지

지원 기능

Workflow	설명	상태
A	매각공고 브라우징 (날짜/법원/기일별)	✅
B	사건번호 직접 조회	✅
C	부동산 물건 자유 조건검색	🔧 (canonical body 확정 필요)
법원코드 조회	전국 법원사무소 코드	✅

기술 스택

• Python 3.12+
• uv 패키지 관리
• requests + BeautifulSoup4
• MariaDB (pymysql)

시작하기

git clone https://github.com/ajujoa/k-auction.git
cd k-auction
uv sync

사용법

# 매각공고 목록 (2026년 5월, 서울중앙지법, 기일입찰)
uv run python -m src.main notices --date 2026-05 --court B000210

# 사건번호 직접 조회
uv run python -m src.main case --court B000210 --case 2024타경100001

# 법원사무소 코드 조회
uv run python -m src.main courts

# 호출 budget 조정 (기본 5회)
uv run python -m src.main notices --date 2026-05 --max-calls 10

🚫 BLOCKED 정책 요약

규칙	값
호출 간 대기	3초 + 0~1초 jitter
세션당 budget	5회 (최대 10회)
차단 감지	ipcheck=false, "차단" 문자열, HTTP 403/429
차단 시 행동	즉시 중단, 자동 재시도 금지
차단 복구	약 1시간 대기

상세: BLOCKED.md

프로젝트 구조

k-auction/
├── src/
│   ├── main.py            # CLI 진입점
│   ├── crawler.py         # 법원경매 크롤러
│   ├── blocked_policy.py  # 🚫 BLOCKED 정책 모듈
│   └── db.py              # MariaDB 연결
├── config/
│   └── settings.ini       # 설정
├── BLOCKED.md             # 🚫 차단 정책 상세 (필독)
├── pyproject.toml
├── .gitignore
└── README.md

라이선스

MIT