Court Auction Notice Search
Query South Korea court real-estate auction notices and case details from courtauction.go.kr as structured JSON while your agent researches buy-side opportunities.
Overview
Court Auction Notice Search is an agent skill for the Idea phase that queries South Korea’s official court auction portal and returns structured JSON for sale notices, property search, and case status.
Install
npx skills add https://github.com/nomadamas/k-skill --skill court-auction-notice-searchWhat is this skill?
- Three workflows: sale notices by date/court, expanded notice fields, and free-condition property search plus direct case
- Maps WebSquare JSON XHR endpoints to agent-friendly JSON with no official OPEN API
- Read-only with ~2s jitter per call, default 10-call session budget, and immediate stop on ipcheck=false
- Playwright fallback only for Workflow C when raw HTTP returns WAF-style 400
- Court office code reference for disambiguating 법원 identifiers
- Minimum ~2 seconds jitter between calls
- Default session call budget of 10 requests
- Site may block an IP for about one hour after roughly 16 calls in 30 seconds
Adoption & trust: 1.1k installs on skills.sh; 5.4k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need court auction listings and case facts in a machine-readable form, but courtauction.go.kr has no public API and blocks aggressive scraping.
Who is it for?
Korean-market solo builders or analysts who want agent-assisted read-only research on 부동산 경매 without writing scrapers themselves.
Skip if: Non–South Korea workflows, movable-asset auctions, automated 입찰 submission, or anyone who will treat JSON output as legal or bidding authority without re-reading the court notice.
When should I use this skill?
User asks about today’s or tomorrow’s 부동산 경매, a specific court’s 매각기일, notice fields, 사건번호 status, conditioned property search, or court office codes on courtauction.go.kr.
What do I get? / Deliverables
Your agent returns JSON summaries of notices, expanded fields, or search hits so you can shortlist assets and then verify details on the court’s original documents outside the skill.
- JSON bundles of sale notices and bid-type splits
- Expanded notice records with appraisal and minimum sale price fields
- Property search result sets or direct case lookup payloads
Recommended Skills
Journey fit
Canonical shelf is Idea because the skill supports early opportunity and asset research before you commit to building or bidding workflows. Research subphase fits calendar-based sale notices, free-condition property search, and direct case lookup by court and case number.
How it compares
Use as a read-only court-portal adapter instead of generic web scraping skills that ignore IP budgets and site-specific XHR contracts.
Common Questions / FAQ
Who is court-auction-notice-search for?
It is for solo builders and researchers working in ko-KR real-estate context who want Claude Code, Cursor, or similar agents to browse court auction notices and cases via structured JSON.
When should I use court-auction-notice-search?
Use it during Idea research when you ask which auctions open on a date, want notices split by bid type, need full fields on a notice, search 강남-style filters, or look up 진행 상황 by 사건번호—always as reference before any real bid.
Is court-auction-notice-search safe to install?
It is read-only but triggers external calls to a government site with strict bot limits; review the Security Audits panel on this page and keep call volume within the skill’s budget before relying on it in production research.
SKILL.md
READMESKILL.md - Court Auction Notice Search
# Court Auction Notice Search ## What this skill does 대한민국 법원이 운영하는 공식 **법원경매정보** 사이트(`courtauction.go.kr`) 의 매각공고와 사건정보를 에이전트가 활용할 수 있는 JSON 형태로 변환해서 돌려준다. - 공식 OPEN API가 없어 사이트 내부의 WebSquare JSON XHR endpoint를 그대로 호출한다. - 1차 transport 는 직접 HTTP다. Workflow C 자유검색에서 raw-HTTP WAF성 HTTP 400이 날 때만 Playwright fallback 으로 전환하며, 명시적 차단(`BLOCKED`/`ipcheck=false`)은 기본적으로 중단한다 (`rebrowser-playwright` 또는 `playwright-core` 가 있을 때만). - 사이트는 **IP 단위 봇 차단** 이 매우 공격적이다 (16회/30초 정도면 1시간 차단). 이 패키지는 호출 간 최소 2초 jitter, 세션당 호출 budget(기본 10회), `data.ipcheck === false` 즉시 throw 로 보수적으로 동작한다. - **참고용 도구**다. 실제 입찰 전에는 반드시 법원 원문 매각공고를 다시 확인해야 한다. ## When to use - "오늘/내일 어디서 부동산 경매 열려?" - "서울중앙지방법원 2026-04-27 매각공고 보여줘" - "기일입찰 vs 기간입찰만 나눠서 보여줘" - "이 매각공고 안의 사건번호/용도/주소/감정평가액 다 보여줘" - "사건번호 2024타경100001 진행 상황 알려줘" - "서울 강남구 아파트 최저가 5억 이하 유찰 1회 이상 물건 찾아줘" - "법원사무소 코드 표 줘" ## When not to use - 동산(자동차·중기) 경매 (이번 v1 범위 밖) - 특정 매각기일 날짜의 모든 법원 일정을 한 번에 (Workflow D 별도 follow-up 이슈) - 매각물건 사진(전경/개황/내부) URL 노출 (별도 follow-up 이슈) - 매각물건명세서 / 현황조사서 / 감정평가서 PDF 다운로드 (별도 follow-up 이슈) - 입찰서 자동 작성·자동 제출 (지원하지 않는다, 입찰은 반드시 법원에서 사람이 직접) ## Inputs - `date` — 매각기일 월(YYYY-MM 또는 YYYYMM) 또는 특정일(YYYY-MM-DD 또는 YYYYMMDD). 필수. 실제 사이트 검색 버튼은 월(YYYYMM) 단위로 조회하므로 특정일 입력은 월 조회 후 해당 일자만 필터링한다. - `courtCode` — 법원사무소코드 (예: `B000210` = 서울중앙지방법원). 비우면 전체. `getCourtCodes()` 또는 `codes courts` 로 받아온다. - `bidType` — `date` (= 기일입찰, code 000331) 또는 `period` (= 기간입찰, code 000332). 빈값이면 둘 다. - `caseNumber` — 사건번호. `2024타경100001` 형식 권장. `2024-100001` 도 받아서 `2024타경100001` 로 정규화한다. ## Mandatory honest framing 이 스킬은 사용자에게 다음 사실을 항상 알려야 한다. 1. 데이터는 법원경매정보 사이트의 공개 정보를 그대로 옮긴 것이며 **실제 입찰 전에 법원 원문을 재확인**해야 한다. 2. 사이트는 자동화 호출에 매우 민감해서 **빠른 연속 조회 시 IP가 1시간 차단**될 수 있다. 차단되면 같은 IP에서는 약 1시간을 기다려야 한다. 3. 가격(감정평가액·최저매각가격)·매각기일·매각장소는 **공고 시점 기준** 이며 정정·취하·연기로 변경될 수 있다 (`correctionCount`, `cancellationCount` 필드를 참고). 4. 본 스킬은 **read-only**다. 입찰 자체는 자동화하지 않는다. ## Official surfaces - 법원경매정보 메인: `https://www.courtauction.go.kr` - 부동산매각공고 진입: `https://www.courtauction.go.kr/pgj/index.on?w2xPath=/pgj/ui/pgj100/PGJ143M01.xml&pgjId=143M01` - 경매사건검색 진입: `https://www.courtauction.go.kr/pgj/index.on?w2xPath=/pgj/ui/pgj100/PGJ159M00.xml&pgjId=159M00` - 직접 호출 endpoint (이 스킬이 사용하는 것): - `POST /pgj/pgj143/selectRletDspslPbanc.on` — 매각공고 목록 - `POST /pgj/pgj143/selectRletDspslPbancDtl.on` — 매각공고 상세 (사건/물건 펼치기) - `POST /pgj/pgj15A/selectAuctnCsSrchRslt.on` — 사건 단건 조회 - `POST /pgj/pgjsearch/searchControllerMain.on` — 물건 자유 조건검색 (PGJ151F00 → PGJ151M01) - `POST /pgj/pgjComm/selectCortOfcCdLst.on` — 법원사무소코드 전체 ## Workflow A — 매각공고 → 사건/물건 펼치기 1. 사용자에게 **매각기일(YYYY-MM-DD)** 과 (선택) 법원·입찰구분을 받는다. 2. `searchSaleNotices({ date, courtCode, bidType })` 호출 → 그 날·그 법원의 매각공고 카드 목록. 3. 사용자가 카드를 고르면 카드 객체(또는 `raw`)를 그대로 `getSaleNoticeDetail(notice)` 에 넘긴다. 4. 응답의 `items[]` 가 `caseNumber`, `usage`, `address`, `appraisedPrice`, `minimumSalePrice`, `remarks` 를 가진다 (이슈 본문이 명시한 4필드 모두 포함). 5. 가격은 원 단위 정수다. 사용자에게 보여줄 때는 한국식 천단위 콤마 + 억/만 단위 환산을 같이 제시한다. ## Workflow B — 사건번호 직접 조회 1. 사용자에게 **법원사무소코드** + **사건번호(2024타경100001)** 를 받는다. 2. `getCaseByCaseNumber({ courtCode, caseNumber })` 호출. 3. `found:false / status:204` 면 사건이 존재하지 않거나 비공개. 사건번호 형식·법원이 맞는지 사용자에게 다시 확인한다. 4. `found:true` 면 `caseInfo`(사건명·접수일·청구액·재판부·진행상태), `items[]`(매각목적물 — 주소/배당요구종기), `schedule[]`(매각기일별 최저가/감정가/결과), `claimDeadline`, `relatedCases`, `stakeholders` 가 채워진다. ## Workflow C — 부동산 물건 자유 조건검색 1. 사용자의 조건을 `searchProperties()` 입력으로 매핑한다. - `region: { sido, sigungu, dong }` — 코드 또는 대표 정적 sido 코드테이블의 한국어명. 지역을 주면 지번주소 검색(`cortStDvs:"2"`)으로, 지역이 없으면 매각공고 모드(`c