nomadamas__k-skill/docs/features/nts-tax-delinquency.md

국세 체납 명단공개 검색 (nts-tax-delinquency)

nts-tax-delinquency 스킬은 국세청 누리집의 고액·상습체납자 명단공개(국세기본법 제85조의5)를 무인증 공개 검색으로 직접 조회한다.

제공 기능

• 법인 명단: 법인명으로 검색 — 공개년도·법인명·대표자·업종·소재지·총 체납액·세목·체납건수·체납요지
• 개인 명단: 상호로 검색 — 공개년도·성명·연령·상호·직업·주소·총 체납액·세목·체납요지

인증/시크릿

없다. 인증 없이 동작하는 공개 read-only 검색이므로 프록시를 거치지 않고 사용자 머신에서 직접 호출한다. helper는 stdlib만 쓴다(추가 의존성 없음).

동일성 경계

명단공개 자료에는 사업자등록번호가 수록되지 않는다. 상호·법인명 문자열 일치 후보의 공개 사실만 나열하며, 동명 상호 가능성은 사용자가 판단한다.

예시

npx -y @nomadamas/k-skill@0 exec nts-tax-delinquency scripts/nts_tax_delinquency.py -- --name "○○건설"

실패 모드

• unavailable + 안내: 상호 미입력, 네트워크 오류, 페이지 구조 변경 추정 — 수동 확인 URL 제공. HTML 스크래핑이라 마커가 어긋나면 즉시 강등한다.
• 0건: 두 명단 모두 매치 없음.

공식 출처

• 명단공개 검색: https://www.nts.go.kr/nts/ad/openInfo/selectList.do