CLNS
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
title: "CLNS — PRODUCT COMPLIANCE INTELLIGENCE · KOREA"
CLNS
PRODUCT COMPLIANCE INTELLIGENCE · KOREA
Clearance, simplified.
복잡한 한국 수입 규제를 10초 만에 확인
Korea Import Compliance MCP & API — 한국 수입·구매대행·유통 실무에서 범용 AI가 자주 틀리는 요건을 3단계로 판정하고, 근거 법령 조항·시행일·원문 URL과 국/영문 면책을 함께 반환하는 경량 엔진입니다.
라이브: https://clns-kr.onrender.com (무료 베타 · Render free Web Service)
결제 없음 · 100% 무료 베타 · 회원가입 없음
외부 API 키가 없어도 동작(코퍼스 기반). 키를 넣으면 관세청·식약처·법제처 공공 API를 실시간 호출하고, 실패 시 캐시로 폴백. 전파 적합성평가(국립전파연구원)는 키가 필요 없는 공개 API라 번호만 있으면 바로 조회한다
원본 API 재전송 없음 — 결합·정규화한 판정만 출력
브라우저에서 바로 쓰는 사람용 화면(
GET /) 포함: 첫 화면은 "무엇을 수입·판매하시나요?" 입력창 하나 +규제·인증 확인버튼 하나이고, HS·원산지·품목군 같은 세부 조건은세부 조건 선택(선택)으로 접혀 있다. 결과 맨 위에는 "이 상품, 핵심 체크리스트 N가지"(필수 인증·주의할 점·예상 비용·기간) 요약 한 장이 오고, 판정 요지·근거 조문·리콜 이력은 그 아래 접힌 카드로 내려간다. 한글표시사항·HS·리콜·API 는 첫 화면 아래 보조 도구 한 줄(CLNS Check·CLNS Label·CLNS Intelligence·CLNS API & MCP)에서 연다.품목별 무료 체크 페이지(pSEO) 35개:
/p/인덱스와/p/{slug}— 무선 미니 선풍기·보조배터리·오메가3·선크림·반려동물 사료 등. JS 없이 크롤러가 읽는 서버 렌더 HTML에 H1·대표 HS·세관장확인 요건 표·규제 축(소관 기관·확인 카드·MCP 툴)·KC·전파·식약처 항목·핵심 함정·근거·면책·API/MCP 연결 안내·실시간 조회 링크를 담는다(sitemap.xml동적 생성, 얇은 페이지는noindex).고지 페이지·헬스체크·트래픽 구분(0.5.6): ①
/privacy(개인정보 처리방침)·/terms(이용약관)·/about(서비스 소개)을 서버 렌더 정적 HTML로 열었다 — JS·외부 CDN 없이 CSP 그대로, canonical·og:image·구조화 문구를 갖추고 홈·품목·가이드 푸터와sitemap.xml에서 이어진다. 문의 연락처는 회신 목적 180일 보관 후 파기, 삭제 요청은 서비스 내 문의(POST /v1/inquiry)와 공개 저장소 Issues 로 받으며, 운영자 개인 연락처·실명·직업은 어디에도 쓰지 않는다(익명 운영). ②/healthz응답에version키를 넣어 배포·레지스트리 버전 확인을 한 번에 할 수 있게 했다. ③/v1/stats에 트래픽 구분(traffic.by_channel: 사람이 여는 페이지·크롤러 파일·REST API·MCP·정적 자산·없는 주소,traffic.by_client: 브라우저·봇·기타)을 익명 카운트로 더했다 — User-Agent 원문·IP·쿠키는 종전처럼 저장하지 않고, 요청 순간에 종류만 셉니다(봇 판별은 문자열 표식 기준의 참고 수치)첫 화면 단순화·결과 결론 요약(0.5.10, 2026-11-22): 실사용 피드백("가독성이 떨어지고, 선택해야 될 게 많고, 어디서 어떻게 봐야 될지 모르겠다")에 따라 사람용 화면을 다시 짰다. ① 첫 화면: 질문 하나(
무엇을 수입·판매하시나요?)·입력창 하나·큰 버튼 하나(규제·인증 확인)만 두고, HS 코드·원산지·품목군·수입 목적·무선·어린이·광고·전성분 등 세부 조건은세부 조건 선택(선택)접기로 내렸다(예시 5종은 한 줄 가로 스크롤). ② 탭 정리: 첫 화면 위의 2×2 탭 바를 없애고, 첫 화면 아래 보조 도구 한 줄(규제·인증 / 한글표시사항 / HS·리콜 / API·MCP)로 옮겼다. 영문 축 이름은 툴팁·/v1/meta의service_axes로 유지한다. ③ 결과: 맨 위에 "이 상품, 핵심 체크리스트 N가지" 요약 카드 — 필수 인증(regulation_tags를 표준어휘 라벨로), 주의할 점, 예상 관세·부가세·인증 심사 — 를 놓고, N 은 아래 접힌 체크리스트 항목 수와 정확히 일치시켰다. 판정 요지·쟁점·세관장확인·식약처 이력·리콜·근거 법령·면책은+접힌 카드로 내렸다(금지 성분·사료 검수처럼 그 품목의 핵심 축은 펼쳐 둔다). ④ 푸터는 한 화면 분량의 문단 더미에서 서비스 한 줄·링크 5개·면책·데이터 출처·개인정보 안내접기로 줄였다./v1/*·/mcp·/healthz·고지 3장·JSON-LD·og:image·리콜 기준일(2022-07-26)·공유 바 3개·폼 필드 id 는 그대로다. 회귀 테스트src/tests/test_v0510_ui_simplify.py18건을 더했고, 화면 계약을 바꾼 3건(탭 모바일 규칙·예시 라벨)은 테스트를 새 화면에 맞춰 정비했다(810건 전부 통과, 익명성 스캔 0건)스냅샷 성격 구분·리콜 색인 기준일 표시(0.5.9, 2026-11-22): ①
data/snapshots/의 2026-10-2311-19 28장은origin: "backfilled"(이벤트 날짜로 되살린 누적 건수만,items없음)이고 2026-11-20 이후만 실제 관측분이다. 예전 코드는 이 요약 파일을unreadable(읽기 실패)로 분류해 손상 파일과 구분되지 않았고, 이제counts_only로 따로 센다(/v1/meta의persistence.counts_only_days·counts_only_note_ko). 폴더 성격은data/snapshots/README.md에 표로 적었다 — 실관측 파일(11-20)은 지우거나 합치지 않는다. ② 국내 리콜 로컬 색인은 2022-07-26 에서 멈춘 정적 파일데이터(15040696, 2023-08-09 배포본)다. 응답 문장 안에만 묻혀 있던 기준일을index_as_of·coverage_label_ko(「과거 색인(2022-07-26 기준) · 최신 리콜 미포함」)·basis_note_ko값으로 드러내고, 웹 결과 섹션 제목(「로컬 리콜 참고 (국표원 · 2022-07-26 기준)」)과llms.txt·툴 설명에도 같은 기준일을 적었다. 회귀 테스트src/tests/test_v059_snapshot_recall_labels.py12건을 더해 788건 전부 통과, 익명성 스캔 0건전수조사 결함 보완(0.5.8, 2026-11-22): 라이브·로컬 실사용 점검에서 나온 결함을 고쳤다. ①
/healthz는 요청 제한에서 제외했다 — 헬스체크가 429(ok:false)를 받으면 정상 서비스가 장애로 읽히고 재시작 대상이 된다(다른 경로의 분당 제한은 그대로). ②robots.txt의 봇별 그룹에도Disallow: /v1/을 넣었다 — robots.txt 는 크롤러마다 가장 구체적으로 일치하는 그룹 하나만 적용하므로,User-agent: Googlebot블록에Allow: /만 있으면*그룹의/v1/차단이 사라져 API JSON 이 색인 대상이 됐다. ③ 일일 스냅샷 체인 복구: 매일 새 DB 로--take하던 GitHub Actions·로컬 스케줄이 전일을 몰라 매일 1,415건을 ‘신규’ 로 기록했다(2026-11-21 파일이 그랬고/v1/trends가 매일 급증으로 읽혔다). 이제--seed로 커밋된 스냅샷을 먼저 복원하고--include-items로 내보내 다음 날 비교가 이어진다. 첫 관측일은diff.baseline: true로 표시하고, 추이 안내가 그 총량을 신규로 세지 않는다. ④ 세관장확인 요건 표 머리말 불일치: 같은 요건을 기관별로 묶어 표에는 2행만 나오는데 머리말은 원본 6건을 ‘요건 6건’으로 적었다. 이제요건 2종(기관별 응답 6건)처럼 묶은 수와 원본 수를 함께 밝힌다. ⑤/v1/meta의service_axes가 화면 탭 4개(CLNS Check·CLNS Label·CLNS Intelligence·CLNS API & MCP)와 일치. ⑥ GET/mcp는 405 를 유지하되 빈 본문 대신 쓰는 법(POST 전용, 툴 목록은GET /v1/mcp)을 적은 JSON 을 준다. ⑦ 근거 인용 정리: 트랩 코퍼스가 제3자 요약 사이트(govbrief.kr·lawplayer.com·albup.co.kr)를 가리키던 10건을 법제처 국가법령정보센터 본문(법령·행정규칙admRulInfoP)으로 바꾸고, ‘관세청 유권해석’으로 적혀 있던 병행수입 불가 사유를 실제 조문(지식재산권 보호를 위한 수출입통관 사무처리에 관한 고시 제5조제2항)으로 바로잡았다(코퍼스 1.0.8). ⑧HEAD가GET과 같은 상태를 돌려준다(/v1/meta·/v1/mcp는 404 였고, 없는/p/·/guides/슬러그는 200 이었다 — 크롤러·모니터가 HEAD 로 먼저 확인할 때 어긋났다). ⑨ DUR 성분명 표시(멜라토닌,,,밀리그램,별규,→멜라토닌, 밀리그램, 별규),llms.txt의 오타(조회 실패은→조회 실패는)·누락 툴 2종(explain_trap·get_service_meta)·고지 3장 링크·툴 개수 자동 계산. 회귀 테스트src/tests/test_v058_regressions.py14건을 더해 776건 전부 통과하고, 익명성 스캔은 두 저장소 모두 0건이다AI 검색 구조화 데이터 보강(0.5.7): ① 홈에
Organization·WebSite(SearchAction?q=)를 더해WebApplication과@id(#app·#org·#website)로 연결했다 — AI 검색·검색엔진이 서비스 성격과 검색 진입점을 한 덩어리로 읽는다. ②/p/인덱스에ItemList(품목 35개, 각 페이지 URL)를 넣고,/p/{slug}에BreadcrumbList를 더했다(Article·FAQPage유지). ③robots.txt에 Bingbot·OAI-SearchBot·ChatGPT-User·Claude-SearchBot·Perplexity-User·Applebot-Extended·CCBot 을 더하고,llms.txt에 '구조화 데이터(JSON-LD)' 안내(페이지별 타입·인용 규칙)를 넣었다. ④ 익명성 스캔이 법령 API 주소의 13자리 숫자(admRulSeq=…)와 자리표시자 번호(국번 뒤가 모두 0 인 류)를 개인정보로 오탐하던 것을 바로잡았다 — URL 속 숫자·예약 시험 도메인·자리표시자 국번은 넘기고, 주민등록번호는 생년월일·성별 자리·검증 숫자가 맞을 때만 센다(스캔 0건 유지, 진짜 발견은 그대로 잡는다)질문형 가이드 100종·공개 문안 익명성 정리(0.5.5): ① 가이드를 90종 → 100종으로 늘렸다(카탈로그 1.6.0). 새 10종은 셀러·수입업자가 실제로 검색하는 질문이다 — 알리·테무 사입 후 국내 판매(자가사용 목록통관과 판매용 통관의 차이), 구매대행 전자제품의 KC 인증 주체·구매대행 고지사항, 크라우드펀딩(와디즈) 리워드 해외 배송의 수입자·통관, 건강기능식품 고시형·개별인정형 원료 구분, 수입 반려동물 간식의 단미사료 성분등록, 통관 보류·반송 상품의 환불·고지 의무, 개인통관고유부호 대여·차용, 화장품책임판매업 등록, 수입 식품 영양표시 제외·생략 조건, KC 인증표시 임의 변경·제거(리셀·재포장). 새 항목도 기존처럼 검증 조문 키(
basis_keys)와 함정 코퍼스(cases)만 참조하고, 얇은 페이지는noindex로 남는다. ② 공개 저장소 문안에서 외부 협업자 표기를 중립 표현("외부 코드 검수 제보") 으로 바꿨다(README.md, 테스트 파일 주석). ③sitemap.xml색인 URL 은 138개(홈 1 + 품목 인덱스·35 + 가이드 100 + 가이드 인덱스 1)로 늘었고(0.5.6에서 고지 3장을 더해 현재 141개)/guides/인덱스·llms.txt·/v1/meta가 새 카탈로그를 그대로 반영한다무료 베타 유입 태그ㆍ3종 생태계 링크 정리(0.5.4):
POST /v1/inquiry에 선택 필드cohort(별칭source)를 더했다.{"cohort":"beta_pilot"}처럼 무료 베타·소개 글(예:citechart) 유입을 40자 이내 태그로 붙이면 DBinquiries.cohortㆍ접수 저널ㆍ웹훅ㆍstdout 로그에 함께 남고, 관리자 요약(GET /v1/inquiry/summary)의by_cohort에서 태그별 건수를 센다. 태그가 없으면 종전 요청과 100% 같게 동작한다(하위 호환, 기존 테이블은 기동 시cohort열만 자동 추가). 웹 문의 폼은?cohort=beta_pilot처럼 태그가 붙은 링크로 들어오면 그 값을 같이 보내고(형식이 틀리면 보내지 않는다), 웹 화면의같이 쓰는 서비스카드ㆍ푸터에서 GRNT(정부지원금)ㆍFRNC(프랜차이즈)로 한 줄씩 이어진다광고 검수 조사 누락ㆍ판정 축 분리ㆍ운영 보안(0.5.3): ① 과대광고 엔진의
AD-01~AD-16패턴이치매\s*(예방|치료)처럼 조사 없는 어간만 받아, "치매를 예방합니다"ㆍ"당뇨를 개선해 줍니다"ㆍ"혈압을 낮춰 줍니다"ㆍ"탈모를 방지합니다" 같은 실제 상세페이지 문구를 놓쳤다. 명사와 서술어 사이에 을/를/이/가/은/는/의 가 들어가도 이어서 대조하도록 모든 규칙을 고쳤다(같은 조사 규칙으로 '질병의 예방 및 치료를 위한 의약품이 아닙니다' 고지문은 오탐하지 않게 예외도 보강). ②check_ad_labeling이 만든 문장('수입 판매 표시 광고 한글표시')을 수입 절차 트랩 질의로 넣어, 준수 문구("비타민C는 항산화 작용을 합니다")만 넣어도TRAP-01/09/10이 붙어 판정이 늘check_likely였다. 이제 광고 문구ㆍ국내 판매페이지ㆍ한글표시사항 축만verdict에 합산하고, 수입 절차 축은 품목명이 있을 때만 따로 대조해import_procedure블록에 분리 표시한다. ③ 클라이언트가 보낸X-Tier헤더만으로 무료 월 250회 한도를 우회하던 경로를 없애고(서버 발급 키CLNS_PRO_API_KEYS+X-Api-Key/Bearer 가 일치할 때만 티어 인정, 한도 면제 티어는UNLIMITED_TIERS에 명시), HTTP 요청 제한(일반 분당 120ㆍ툴ㆍMCPㆍ문의 분당 60ㆍ툴 경로 전체 분당 600 상한)을 추가했다. 제한 키는 프로세스 salt + 주소의 일시 해시로만 메모리에 두고 원문 주소는 저장하지 않는다(429 에Retry-After,/v1/stats에는rate_limited플래그만). ④get_legal_basis의 실시간 조회가 법령명이 정확히 일치하지 않으면 그 후보의 조문 본문을 인용하지 않고name_mismatch에 이름만 담는다(종전에는 '관세법'을 찾다 나온 '관세법 시행규칙'의 조문이 근거처럼 붙었다). ⑤/v1/inquiry는 접수 저널(data/inquiries.jsonl)ㆍ웹훅 알림ㆍstdout 로그ㆍ관리자 요약(/v1/inquiry/summary)으로 유실을 막는다웹 UI 결함 수정(0.5.2): 탭 4개가 모두 열리도록
panels매핑에label을 넣고showTab에 null 방어를 넣었다(0.5.1에서는CLNS Label버튼에서 스크립트가 멈춰 나머지 탭과/?q=·?item=유입까지 먹통이었다). 결과 화면에 그대로 나오던 내부 스펙명(functional_cosmetic·battery_type·energy_density·product_name등)과 영문 상태·오류 코드·반입 경로 값을 한국어 라벨·안내로 바꿔, 내부 키는 화면에 노출되지 않는다. 다크 모드 버튼·로고 대비를 WCAG AA(4.5:1) 이상으로 올리고(--brand-fill/--on-brand),CLNS Label결과에도 요약 복사·공유 링크를 붙였으며, API 탭 툴 표에check_feed_import를 채워 실제 15종과 맞췄다. 없는 페이지(/nope-xyz, 없는/p/·/guides/slug)는 홈·가이드로 돌아가는 안내 HTML 404를 돌려주고/v1/…은 종전 JSON 404를 유지한다수입품 한글표시사항(라벨링) 1초 체크(0.5.1): 통관 다음으로 과태료가 많은 한글표시사항을 5개 품목군 — 화장품(화장품법 제10조ㆍ제12조), 식품ㆍ건강기능식품(식품등의 표시ㆍ광고에 관한 법률 제4조ㆍ제5조), 전기ㆍ생활용품 KC(전기용품 및 생활용품 안전관리법 제9ㆍ18ㆍ25ㆍ29조, 시행규칙 별표 9), 반려동물 사료(사료관리법 제13조, 시행규칙 별표 4), 일반 공산품(통일된 한글표시 법 없음 + 대외무역법 원산지ㆍ전자상거래법 판매자 정보) — 으로 나눠 법정 표시항목 체크리스트를 근거 조문(시행일ㆍ원문 URL)과 함께 돌려준다. 라벨 문구를 넣으면 항목 존재만 대조해 누락 의심 항목을 짚고, 비우면 체크리스트 + 흔한 과태료 사례(한글 스티커 훼손, 전성분 누락, 소비기한/제조일자 혼동, KC 표시ㆍ인증번호 누락, 원산지 미표시 등)를 보여 준다. 항목을 찾지 못한 것은 입력에 없다는 뜻이며 0건이 라벨 적법을 확정하지 않는다.
check_korean_labeling툴(15종) +POST /v1/tools/check_korean_labeling+ 웹 UI CLNS Label 탭(예시 4종) + 가이드 5종반려동물 사료·간식 사료관리법·동물검역(0.5.0): 강아지·고양이 사료ㆍ간식(동결건조ㆍ육포), 단미사료, 반려동물 영양제를 수입ㆍ판매할 때 걸리는 축을 정리한다. 사료 성분등록(사료관리법 제12조)ㆍ통관 전 사료 수입신고(제19조)ㆍ용기ㆍ포장 표시사항(제13조, 시행규칙 별표 4)ㆍ유해물질ㆍ유통기한(제14조)ㆍ제조업 등록(제8조, 제조ㆍ재포장할 때)과, 동물성 원료가 있을 때의 지정검역물ㆍ검역증명서ㆍ수입검역(가축전염병 예방법 제31ㆍ34ㆍ36ㆍ39조)ㆍ반려동물 사료 수입위생조건(고시 제2025-124호)을 확인 항목 13종으로 나눈다. 판매/자가소비, 동물성 원료 여부, 영양제의 보조사료/동물용의약품 경계에 따라 항목이 갈린다. 사료관리법에 '수입업 등록' 제도는 없다(제8조는 제조업 등록만)는 점을 명시하고 기존
/p/문구도 바로잡았다.check_feed_import툴 +assess_import_case원스톱 + 웹 UI 예시 버튼웹 UI 원클릭 대표 품목 프리셋 + 롱테일 가이드 17종(카탈로그 1.4.0):
CLNS Check입력창 위에 대표 체험 버튼 5개(멜라토닌 직구·강아지 간식·수입 화장품·블루투스 이어폰·유아용 의류)를 두어, 누르면 품목명·품목군·원산지·수입 목적이 채워지고 곧바로 통합 점검이 실행된다(멜라토닌 직구는 해외직구 2병 조건으로 식약처 의약품 API 실시간 대조까지 함께 보여 준다)(모바일 터치 38px·키보드 포커스 표시). 가이드는 17종을 더해 85종이 되었고, 향수 60mL 기준과 직구 면세·목록통관, 와인·주류 세금, 주문 분할과 합산과세, 중고 명품 상표권·세관 유치, 콘택트렌즈 의료기기, 전자담배 기기·액상 분리, 육포·치즈 지정검역물, 유모차·카시트 KC, LED 조명·멀티탭 KC, 110V 주방 전기제품, 웨어러블 의료기기·전파, 원두·차 수입신고, 텀블러 식품용 기구, 수입 화장품 품질검사, 수입식품 구매대행업 등록, 원포장 식품 한글 소비기한, 구매대행 청약철회를 다룬다. 새 항목도 기존 코퍼스·검증 상수만 참조한다재배포 영속화(0.5.0, 0원): 무료 플랜은 영구 디스크가 없어 재배포ㆍ슬립 때 작업 DB가 비고
/v1/trendsㆍ/v1/stats가 0부터 시작했다. 이제 저장소에 커밋한 일일 스냅샷(data/snapshots/*.json)과 익명 사용 통계(data/usage/stats.json)를 기동 시 자동 복원한다(DB에 없는 날짜만 채우고 카운터는 큰 값만 유지 — 멱등)..github/workflows/daily-snapshot.yml이 매일 04:00 KST 에 스냅샷을 만들어 커밋하고 라이브/v1/stats를 함께 저장한다. DB 경로는CLNS_DB_PATH→IMPORT_COMPLIANCE_DB→DATABASE_URL(sqlite://)순으로 읽고,postgres://는 조용히 무시하지 않고 미지원 사실을 로그로 밝힌다(영구 볼륨 + 시드 조합 권장). 복원 상태는/v1/meta의persistence에 그대로 나온다국내 이커머스 공정위·전자상거래법 검수(0.4.0): 쿠팡·스마트스토어·자사몰 상세페이지 문구를 넣으면 표시·광고의 공정화에 관한 법률(허위 정가·상시 마감임박·대가성 미표기 후기·근거 없는 최저가/1위·거짓 인증·과장 보장)과 전자상거래법(청약철회·환불 제한, 배송·품절 환급 회피, 구독·자동결제 고지 누락, 총금액 일부만 표시하는 UI, 취소·해지 방해, 판매자 정보 고지 누락)을 함께 검수한다. 규칙 14종 + 판매자 정보·거래조건 고지 9항목, 위험도·근거 조문(시행일·원문 URL)·수정 전→후 문구를 돌려주는
check_ecommerce_compliance툴·CLNS Check원스톱·check_ad_labeling·assess_import_case연동질문형·규제별 가이드 100개(0.5.5, 카탈로그 1.6.0):
/guides/인덱스와/guides/{slug}— "해외직구 영양제는 몇 병까지", "면세 한도는 150달러인가요 200달러인가요", "5V 저전압 제품은 KC 인증이 필요 없나요" 처럼 검색창·AI 챗봇에 실제로 입력되는 질문으로 들어오는 페이지. 질문을 H1로 두고 한 줄 답변·대표 체크포인트·자주 틀리는 답·근거 조문(시행일·원문 URL)·규제 축·/?q=웹 체크·/mcp연결을 담으며,FAQPage구조화 데이터가 같은 질문·답변을 그대로 싣는다. 근거 조문은 카탈로그에 직접 쓰지 않고 이 저장소에서 법제처 현행본으로 검증한 상수만 키로 참조한다(해석되지 않는 키가 있으면 서버가 뜨지 않는다). 총 색인 URL 138개(0.5.6에서/about·/privacy·/terms3장을 더해 현재 141개: 홈 1 + 품목 인덱스 1·품목 35 + 가이드 인덱스 1·가이드 100 + 고지 3)일일 시계열 스냅샷·추이(0.3.0): 리콜·식약처 행정처분·화장품 배합금지/한도 원료·마약류 성분 사전의 항목별 지문을
compliance_snapshots에 일자 단위로 적재하고(python -m import_compliance.snapshots --take), 전일 대비 신규/변경/삭제 건수와 최근 7·30일 급증 품목군·위해유형·위반법령을get_compliance_trends툴·GET /v1/trends로 돌려준다. 이벤트가 0건인 기간에는 '급증 없음'으로 단정하지 않고 데이터 기준일 참고 창을 따로 계산해 함께 보여준다익명 일별 통계:
GET /v1/stats— IP·User-Agent 원문·쿠키·개인 식별자를 저장하지 않고 날짜별 경로/툴/verdict.code/0건·오류 수만 집계규제 카드 25개(0.5.0) — 반려동물 사료ㆍ간식ㆍ영양제 카드(TRAP-25)를 더했다. 0.1.5에서는 0.1.4의 의료기기법(TRAP-21)·위생용품 관리법(TRAP-22)에 이어, 의약품 반입 카드 2개(TRAP-23 마약류·향정·대마 반입 제한, TRAP-24 6병 기준과 성분 제한의 구분) 를 추가. 마약류·원료물질 목록은 마약류 관리에 관한 법률 시행령 별표 1~8을 법제처 API로 받아 파싱한 로컬 사전(마약류 493건 + 원료물질 55건)으로 대조하고, 미래 시행일 개정 조문은 인용하지 않는다
의약품·성분 체크(한글·영문) —
check_drug_import툴과 웹 화면에서 성분명·제품명(예: 졸피뎀/Zolpidem, Adderall, CBD)을 넣으면 ① 마약류(마약·향정신성의약품·대마 및 합성품) ② 마약류 원료물질(에페드린·슈도에페드린·에르고타민 등) ③ 국내 전용 성분(멜라토닌·DHEA·요힘빈·실데나필 등 시드) 여부를 대조하고, ④ 식약처 의약품 제품 허가정보·DUR·e약은요·마약류 오남용 정보 API를 실시간으로 함께 조회해 국내 허가 품목 수·전문/일반 구분·효능군을 보여 주며, ⑤ 자가사용 인정기준(총 6병, 초과 시 용법상 3개월 복용량)을 함께 대조한다. 휴대 반입 소량 일반의약품은 과탐 없이low_risk, 6병 초과·직구는check_likely과대광고·한글표시 검수(0.2.0) —
check_ad_labeling툴과 웹 화면에서 상세페이지 문구와 라벨 문구를 넣으면 품목 유형(일반식품·건강기능식품·화장품·기능성화장품)별 기준으로 질병 효능·의약품 오인·건기식 오인·거짓과장·체험기·비교·비방·보증·기능성 오인·디톡스 표현을 잡고, 근거 법령(식품표시광고법 제8조·화장품법 제13조)·위험도(높음/주의)·대체 표현을 함께 준다. 같은 문구가 유형별로 어떻게 달라지는지 나란히 보여준다한글표시사항 체크리스트(0.2.0) — 수입식품·건강기능식품·화장품별 필수 표시항목(제품명·원재료명·영업소·소비기한·섭취방법·"건강기능식품" 문자·의약품 아님 표현·전성분·제조번호·가격 등)을 조문 근거와 함께 대조해 누락 항목을 짚는다
식약처 행정처분 연동(0.2.0) —
lookup_mfds_disposition툴로 행정처분결과(식품제조가공업 15124560 · 식품판매업 15124559)를 조회한다. 승인 전파 전·오프라인이면 2026-11-19 스냅샷에서 집계한 업종별 빈발 위반 패턴으로 폴백한다. 원본의 업소명·대표자·연락처·주소·인허가번호는 읽지 않고 버린다대표 100개 품목 테스트셋(1.0.1 그대로) — 8개 분야(전기·전자 KC / 무선·전파 / 배터리 / 어린이제품 / 식품·건기식 / 화장품 / 생활화학·차량용 방향제 / 의료기기·위생용품) 100건으로 분야별 정확도와 중대 규제 누락(FN) 0건을 검증(
--check-testset). 0.1.5에서 의약품 기능을 더해도 이 100건 세트는 손대지 않았고(1.0.1·100건·FN 0 유지), 의약품은 별도drug_testset.json14건(--check-drugs)으로 관리한다응답 스키마 0.1.3(0.1.5에서도 유지) — 기존 3단계
verdict위에 표준 5단계assessment_status(APPLICABLE·NOT_APPLICABLE·POTENTIALLY_APPLICABLE·REVIEW_REQUIRED·UNKNOWN),missing_information,destination·jurisdiction·origin(ISO),regulation_tags를 추가MCP 두 가지 전송: HTTP(
POST /mcp) + stdio(python -m import_compliance.mcp_stdio) — 로컬 실행형 MCP 디렉터리(Glama·mcp.so 등) 등록용무료 클라우드 배포 사본 제공:
Dockerfile(python:3.12-slim) +render.yaml(Render free Web Service)GitHub Actions CI(
.github/workflows/test.yml) — Python 3.11·3.12 에서--check-corpus+--check-testset+ 전체 테스트 자동 실행라이선스: MIT (
LICENSE,Copyright (c) 2026 CLNS-KR)
Related MCP server: korean-law-mcp
문서
파일 | 내용 |
| 실제 쓸 공공 API 목록, 신청 방법, 확인한 약관 원문, 상업적 가공 안전성 판정, 2026-11-18 실호출 검증 결과 |
| 일반 AI가 틀리는 함정 24개(상황·오답·정답·근거·판정 로직). 파일명은 초기 20건 기준이며, 0.1.5에서 TRAP-23·24를 더해 |
| 5대 리스크 대응, 아키텍처, 캐시 DB, 8개 툴, 무료/유료 경계, 면책 |
| 라이브 검증 산출물(정규화 샘플·상태, 키 없음) |
| 대표 3품목 라이브 판정 산출물(응답시간·요건·리콜 포함, 키 없음) |
| 0.5.1 설계 — 품목군 5개(화장품·식품/건기식·KC·사료·일반 공산품) 한글표시 체크리스트, 누락 대조 규칙, 흔한 과태료 사례, 툴 15종·웹 UI CLNS Label·가이드 5종, 법령 실조회 결과 |
| 0.5.0 설계 — 사료관리법ㆍ동물검역 확인 항목 13종, "사료 수입업 등록" 오답 교정, 반려동물 가이드 3종, 0원 영속화(시드 복원ㆍ일일 워크플로ㆍDB 경로 우선순위), 법령 검증 결과 |
| 0.4.0 설계 — 공정위 표시광고법·전자상거래법 규칙 14종, 판매자 정보·거래조건 고지 9항목, 원스톱 연동, 국내 셀러 가이드 14종, 법령 검증 결과 |
| 0.3.0 설계 — 질문형 가이드 36종 구조·근거 참조 방식·FAQPage, 일일 스냅샷 테이블·전일 대비·추이 API, 한계(정적 리콜 데이터·무료 플랜 휘발성) |
| 0.2.0 설계 — 유형별 광고 기준 차이, 탐지 규칙 16종, 한글표시 체크리스트, 행정처분 연동·폴백·개인정보 처리 |
| 대표 3품목 라이브 판정 사람용 리포트 |
| 키 템플릿( |
| MIT 라이선스( |
| CI: |
| 0.5.0 사료관리법ㆍ가축전염병 예방법ㆍ시행규칙 조문 실조회 결과(법제처 OPEN API, 시행일 이하 최신 판본만 채택) |
| 매일 04:00 KST 일일 스냅샷 생성ㆍ커밋, 라이브 |
| 스냅샷 파일 성격 표 — 2026-10-23 |
출시 전 감사·성장 계획(05), 테스트셋·스키마 설계(06), 0.1.4 변경 상세(07), 0.1.5 변경 상세(08), 법령·API 실조회 검증 산출물(medical-hygiene-law-verification.json·drug-law-verification.json·drug-api-verification-2026-11-18.json·ad-label-law-verification.json·food-sanitation-law-verification.json·disposition-api-verification-2026-11-19.json·ecommerce-ftc-law-verification.json)은 내부 문서로 두고 공개 저장소에는 포함하지 않는다.
실행
cd src
python3 -m import_compliance.cli --check-corpus
python3 -m import_compliance.cli --check-testset # 100건 분야별 정확도·규제 누락 FN
python3 -m import_compliance.cli --check-drugs # 의약품·영양제 14건(금지성분·자가사용 기준)
python3 -m import_compliance.cli --drug 졸피뎀 --channel online --quantity 30
python3 -m import_compliance.cli --drug-schedules # 성분 사전 상태(별표 개정일·건수·미승인 API)
python3 -m import_compliance.cli "중국산 블루투스 스피커를 수입해 판매하려고 해"
python3 -m import_compliance.cli "150달러 이하 의류 목록통관"
python3 -m import_compliance.cli --trap TRAP-15
python3 -m import_compliance.cli --mcp
# 국표원 리콜 파일데이터 적재·조회(인증키 불필요, 네트워크 필요)
python3 -m import_compliance.cli --fetch-recalls # data/raw CSV + data/recalls.sqlite
python3 -m import_compliance.cli --db ../data/recalls.sqlite --recall "전지"
python3 -m import_compliance.cli --db ../data/recalls.sqlite --recall-stats실API 모드 (.env 키 필요)
.env(프로젝트 루트)에 DATA_GO_KR_SERVICE_KEY, LAW_GO_KR_OC를 넣으면 실호출이 켜집니다.
.env는 .gitignore에 들어 있고, 코드·문서·로그·응답에는 키가 남지 않습니다.
cd src
python3 tools/verify_live_apis.py --encoding-check # 4개 엔드포인트 라이브 검증
python3 tools/verify_live_apis.py --hs 8507609000 --law-query 관세법 --law-article 226 \
--out ../live-api-verification.json
python3 -m import_compliance.cli --live --hs 3307903000 # HS 10자리 세관장확인 실조회
IMPORT_COMPLIANCE_LIVE=1 python3 -m import_compliance.server # HTTP 서버도 live 모드실API 소스 | 엔드포인트 | 툴에서 보이는 곳 |
관세청 세관장확인대상물품(15101589) |
|
|
식약처 수입식품 허가정보(15058273) |
|
|
식약처 수입식품 제품DB(15073949) |
|
|
법제처 국가법령정보(lawSearch/lawService) |
|
|
국립전파연구원 적합성평가 DB정보(3034183) |
|
|
식약처 의약품 계열 5종(15058963·15058041·15095677·15075057·15059486) |
| 2026-11-21 활용승인(실호출 200) → |
HTTP 서버(웹 UI + JSON API + MCP):
cd src
python3 -m import_compliance.server # http://0.0.0.0:8787 · 작업 DB는 ../data/app.sqlite
python3 -m import_compliance.server --port 9000 --db /tmp/tck.sqlite
curl -s localhost:8787/v1/mcp | head # 툴 매니페스트(사람이 읽는 JSON)
curl -s -X POST localhost:8787/v1/tools/assess_import_case \
-H 'Content-Type: application/json' \
-d '{"query":"합성니코틴 액상형 전자담배를 수입해 판매"}'
# MCP(JSON-RPC 2.0) — POST /mcp 또는 POST /v1/mcp
curl -s -X POST localhost:8787/mcp -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}'
curl -s -X POST localhost:8787/mcp -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"assess_import_case","arguments":{"query":"중국산 무선 선풍기를 수입해 판매"}}}'
curl -s localhost:8787/.well-known/mcp/server-card.json | head
curl -sI -X OPTIONS localhost:8787/v1/tools/assess_import_case # 204 + CORS
curl -s localhost:8787/robots.txt; curl -s localhost:8787/llms.txt; curl -s localhost:8787/sitemap.xml
curl -s localhost:8787/p/ | head -40 # 품목별 페이지 인덱스(35개)
curl -s localhost:8787/p/usb-mini-fan | head -60 # 품목별 무료 체크(서버 렌더 HTML)
curl -s localhost:8787/v1/stats | head -60 # 익명 일별 통계(IP·UA 미저장)MCP 연결 — HTTP 와 stdio
같은 9개 툴을 두 가지 전송으로 제공합니다(로직은 mcp_http.py 한 곳).
# 1) HTTP(Streamable HTTP · JSON-RPC 2.0, 무인증, application/json 한 덩어리)
# POST https://clns-kr.onrender.com/mcp (= /v1/mcp)
# 2) stdio(로컬 실행형 MCP 디렉터리용) — 한 줄에 JSON-RPC 한 건
cd src
python3 -m import_compliance.mcp_stdio \
<<'JSON'
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}
{"jsonrpc":"2.0","id":2,"method":"tools/list"}
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"lookup_hs_requirements","arguments":{"hs_code":"8414519000"}}}
JSONMCP 클라이언트 설정 예시(claude_desktop_config.json 등):
{
"mcpServers": {
"clns": {
"command": "python",
"args": ["-m", "import_compliance.mcp_stdio"],
"env": { "PYTHONPATH": "/path/to/clns/src" }
}
}
}stdio 는 stdout 에 JSON-RPC 응답만 쓰고 로그는 stderr 로 보냅니다. notification 에는 아무것도 쓰지 않습니다.
상태를 저장하지 않으므로
initialize없이tools/call을 바로 보내도 동작합니다.
툴 15종
툴 | 하는 일 | 주요 인자 |
| 품목·상황 자연어 → 수입요건·인증·표시·통관 함정 3단계 판정 + 근거·면책 |
|
| HS 10자리 → 세관장확인대상 여부·법령·기관·확인시점 |
|
| 전기용품·생활용품·어린이제품·전파 적합성평가 중 걸리는 절차 판정 |
|
| 식품·건기식·화장품·기구용기: 수입신고·영업등록·한글표시·광고심의 |
|
| 의약품·영양제 성분 대조: 마약류·원료물질·국내 전용 성분 + 자가사용 인정기준(6병·3개월분) |
|
| 상세페이지·상품명 문구와 라벨 문구를 유형별 기준으로 검수: 위험 표현·근거·대체 표현 + 한글표시사항 누락. 판정은 광고 문구ㆍ국내 판매페이지ㆍ한글표시사항 축만 합산하고, 수입 절차(신고ㆍ영업등록ㆍ심의) 축은 품목명이 있을 때 따로 대조해 |
|
| 국내 판매페이지 문구를 공정위 표시광고법·전자상거래법으로 검수: 허위 정가·마감임박·뒷광고·청약철회 제한·배송 회피·인증/수상·최저가/1위·구독 자동결제·가격/해지 다크패턴 + 판매자 정보 고지 누락 |
|
| 품목군별 한글표시사항(라벨) 체크리스트 + 라벨 문구 누락 대조 + 흔한 과태료 사례(스티커 훼손·전성분 누락·소비기한/제조일자 혼동·KC 표시 누락·원산지 미표시) |
|
| 반려동물 사료·간식·영양제: 사료 성분등록·수입신고·표시·유해물질·제조업 등록 + 지정검역물·반려동물 사료 수입위생조건 확인 항목(사료관리법에 수입업 등록은 없음) |
|
| 식약처 행정처분 이력(식품제조가공업·식품판매업) + 업종별 빈발 위반 패턴(개인정보 필드 폐기) |
|
| 브랜드·모델명·제품명으로 국내 리콜 이력(국표원 15040696 로컬 인덱스, 2022-07-26 기준 과거 색인 — 최신 리콜 미포함. 최신은 safetykorea.kr 확인) |
|
| 코퍼스 수록 법령 조항 요지·시행일·원문 URL |
|
| 함정 케이스(TRAP-01~25) 시나리오·흔한 오답·정답·근거 |
|
| 일일 스냅샷 전일 대비 신규/변경/삭제 + 최근 N일 급증 품목군·위해유형·위반법령 |
|
| 코퍼스 버전·판정 등급·무료/유료 경계·잔여 호출 | – |
무료 한도는 브라우저/클라이언트 ID 당 월 250회이며 get_service_meta 는 차감되지 않습니다.
응답 스키마 0.1.3 — 표준 상태 · 누락 정보 · 공통 필드
기존 3단계 verdict(check_likely/info_needed/low_risk)는 그대로 두고, 판정 상태·빠진 스펙·지리 정보를 추가했다. 필드만 늘었으므로 기존 클라이언트는 수정 없이 동작한다.
필드 | 값 | 설명 |
|
| 표준 판정 상태( |
|
| 판정을 좁히려면 필요한 표준 스펙명 목록 |
|
| 같은 목록의 상세(질문·허용값·케이스) |
|
| 통관 목적국 |
|
| 적용 법역(법령 카드가 한국법 기준) |
|
| 원산지 ISO 3166-1 alpha-2. 확인되지 않으면 |
|
| 원산지를 어디서 확인했는지 |
|
| 케이스·응답 단위 규제 태그(25종 어휘) |
|
| 응답 스키마 버전 |
상태와 기존 판정의 대응: check_likely → APPLICABLE(빠진 스펙이 있으면 POTENTIALLY_APPLICABLE), info_needed → REVIEW_REQUIRED, low_risk → NOT_APPLICABLE, 쟁점 0건 → UNKNOWN. 상태·누락 정보는 판정 툴(assess 계열) 응답에 실리고, 나머지 툴은 공통 지리 필드만 갖는다. 실제 판정은 인증·통관 확정이 아니므로 verdict.determinative 는 항상 false 다.
{
"schema_version": "0.1.3", "destination": "KR", "jurisdiction": "KR",
"origin": "CN", "origin_source": "query",
"verdict": {"code": "check_likely", "label_ko": "확인 대상 가능성 높음", "determinative": false},
"assessment_status": "POTENTIALLY_APPLICABLE",
"assessment_status_label_ko": "적용 가능성 있음",
"missing_information": ["rated_power", "ac_plug"],
"regulation_tags": ["ELECTRICAL_KC"]
}대표 100개 품목 테스트셋
src/testset_100.json — 8개 분야 100건. 각 케이스는 domain(분야) · expected_verdict(기대 판정) · required_findings(필수 규제 태그)를 가지며, 필수 태그가 응답에서 빠지면 **중대 규제 누락(FN)**으로 센다.
분야 | 케이스 | 예 |
전기·전자 KC | 16 | USB-C 65W 충전기, 노트북 어댑터, 에어프라이어 8516.60 |
무선기기·전파법 | 12 | 블루투스 스피커, 와이파이 공유기, 적외선 리모컨(저위험) |
배터리 | 12 | 보조배터리, 전동공구 배터리 팩, 드론 배터리 |
어린이제품 | 12 | PPSU 젖병, 유모차, 카시트, 무선 RC 완구 |
식품·건강기능식품 | 16 | 구매대행 과자, 건강기능식품 광고, 식품용 도마 |
화장품 | 10 | 수딩크림, 선크림(기능성), 향수 |
생활화학제품·차량용 방향제 | 10 | 주방 세정제, 차량용·겔 방향제, 디퓨저 |
의료기기·위생용품 | 12 | 전자혈압계·체온계·생리대 HS 요건, 소액 직구 |
검증 결과: 분야별 판정 정확도 100%(100/100), 중대 규제 누락 0건, NOT_APPLICABLE 오판 0건(2026-11-18, 네트워크 없이). 의료기기·위생용품은 0.1.4에서 TRAP-21·22 카드로, 의약품은 0.1.5에서 TRAP-23·24 카드와 별도 14건 세트로 검증한다. 남은 한계(공개 API 부재·활용승인 전)는 응답의 scope_limits_ko 에도 표시한다.
cd src
python3 -m import_compliance.cli --check-testset # 분야별 정확도·FN
python3 tests/test_testset_100.py # 구조·정확도·FN 18건
python3 tools/build_testset_100.py # 테스트셋 재생성의약품·영양제 반입 체크 (0.1.5)
해외직구·휴대 반입하려는 의약품·영양제의 성분을 기준으로 판정한다. 질의문·성분명은 한글·영문 모두 대조한다(예: 졸피뎀/Zolpidem, CBD/칸나비디올/Cannabidiol, 제품명 Adderall→암페타민).
축 | 데이터·근거 | 판정 |
마약류(마약·향정신성의약품·대마 및 합성품) | 마약류 관리에 관한 법률 제2조·제4조·제18조, 시행령 별표 1~7의2(로컬 사전 493건) |
|
마약류 원료물질(에페드린·슈도에페드린·에르고타민 등) | 같은 법 제2조제6호·제6조의2, 시행령 별표 8(55건), 「수입통관 사무처리에 관한 고시」 별표 11 |
|
국내 전용 성분(멜라토닌·DHEA·요힘빈·실데나필 등) | 고시 별표 11·약사법 제42조(대표 시드 목록) |
|
자가사용 인정기준(총 6병, 초과 시 용법상 3개월 복용량) | 고시 제67조·별표 11 | 휴대 반입 소량 일반의약품 |
성분 사전은
src/tools/fetch_drug_schedules.py가 법제처 API로 시행령 별표 1~8을 파싱해 생성한다(src/drug_schedules.json, 출처: 법제처 국가법령정보센터). 손으로 적은 추정 목록이 아니며, 별표에 없다고 마약류가 아니라고 단정하지 않는다(임시마약류·개정 시차).식약처 의약품 허가정보·e약은요·DUR·마약류 API(15058963·15058041·15095677·15075057·15059486)는 2026-11-21 활용승인(코드 30 해소, 실호출 HTTP 200) 후
check_drug_import가 실시간으로 조회한다. 결과는drug_live(허가정보·DUR·e약은요·마약류 오남용)와drug_import_check.live_api_summary_ko에 나오고, 키가 없거나 실패하면coverage_ko에 그 사실을 밝힌다. 15058041(마약류 및 원료물질 정보)은 제품이 아니라 취급업소 승인 목록이라 성분 대조에 쓰지 않는다. 11-18 시점 검증 기록은drug-api-verification-2026-11-18.json.의약품 테스트셋:
src/drug_testset.json14건(마약류 6·원료물질 2·국내 성분 1·직구 1·자가사용 경계 2·과탐 방지 2). 판정 일치 14/14, 금지 태그 0.
과대광고·한글표시 검수 (0.2.0)
상세페이지 문구와 라벨(한글표시사항) 문구를 품목 유형별 기준으로 본다. 같은 문구도 유형에 따라 허용 범위가 다르므로, 엔진은 4개 유형에 각각 적용해 결과를 나란히 보여준다.
문구 | 일반식품 | 건강기능식품 | 일반화장품 | 기능성화장품 |
"체지방 감소에 도움을 줄 수 있음" | 금지 위험(건기식 오인) | 인정 원료·함량 범위 내 허용 | – | – |
"미백", "주름개선", "자외선 차단" | – | – | 금지 위험(기능성 오인) | 심사·보고 범위 내 허용 |
"아토피 치료", "항암 효과" | 금지 위험 | 금지 위험 | 금지 위험 | 금지 위험 |
"100%", "즉시", "최고" | 과장 위험 | 과장 위험 | 과장 위험 | 과장 위험 |
규칙 16종(
AD-01~AD-16)을 위험도(높음/주의)와 함께 적용하고, finding마다 근거 조문(식품표시광고법 제8조제1항 각 호, 화장품법 제13조, 건강기능식품법 제15조제2항 등)·시행일·원문 URL·대체 표현을 붙인다.화장품은 2026-10-20 시행 화장품법 제13조제1항제4호(AI 생성 전문가 보증 광고)를 별도 규칙으로 잡는다.
한글표시사항은 유형별 필수항목(식품 9·건기식 13·화장품 8, 조건부 3~3·2)을 조문 근거와 대조하고, 조건부 항목(영양표시·알레르기·수입 한글표시·기능성 표시·1차 포장)은 해당 제품에만 적용한다. 세부 서식은 「식품등의 표시기준」·「화장품법 시행규칙」 확인 대상으로 남긴다.
라벨 사진 인식(OCR)은 하지 않는다. 텍스트로 옮긴 라벨 또는 항목 체크만 대조하며, "누락"은 입력에서 그 항목을 찾지 못했다는 뜻이다.
curl -s -X POST https://clns-kr.onrender.com/v1/tools/check_ad_labeling \
-H 'Content-Type: application/json' \
-d '{"product_type":"general_food","ad_copy":"먹기만 하면 100% 다이어트, 항암 효과 입증",
"label_text":"제품명 다이어트 환 / 소비기한 2027.03.15"}'식약처 행정처분 이력 (0.2.0)
데이터셋 | 업종 | 상태(2026-11-19) |
| 식품제조가공업(주류 포함) | 실호출 성공( |
| 식품판매업 | 승인 후 전파 전(코드 30) — 붙으면 자동 사용 |
조회 순서: 실시간 API → 로컬 적재분(
disposition_items) → 내장 대표 적발 패턴. 승인 전파 전·키 없음·오프라인에서도 같은 형태로 답한다.내장 패턴은 2026-11-19 스냅샷 249건의 위반법령 분포(시설기준 94·영업허가 변경 37·자가품질검사 16·표시기준 4·부당광고 1 등)를 집계한 것으로, 개별 업소 이력을 담지 않는다.
원본의 업소명·대표자명·전화번호·주소·인허가번호는 읽지 않고 버린다. 위반내용의 전화번호·주민번호·긴 숫자도 마스킹한다. 인허가번호는 조회 조건으로만 쓰고 응답·저장에 남기지 않는다.
경로 | 내용 |
| 사람용 웹 UI(CLNS Check · CLNS Label · CLNS Intelligence · CLNS API & MCP) |
| 품목별 수입 요건 인덱스(35개, 크롤러 진입점) |
| 품목별 무료 체크 페이지(서버 렌더 HTML · JS 없음 · 얇은 페이지는 |
| 익명 일별 통계 JSON( |
| 헬스체크 |
| MCP JSON-RPC 2.0: |
| MCP 서버 카드(인증 없음·툴 15종 스키마) |
| 툴 매니페스트(사람이 읽는 JSON). |
| REST JSON 15종 |
| CLNS Pro 사전 신청·도입 문의 접수( |
| 관리자용 문의 건수 요약( |
| 검색·AI 크롤러용 공개 파일( |
| 공유 미리보기 이미지(1200×630) |
| 검색엔진 소유확인 파일( |
| CORS preflight 204. 모든 응답에 |
브라우저로 http://localhost:8787/ 을 열면 사람용 화면(CLNS Check · CLNS Label · CLNS Intelligence · CLNS API & MCP)이 나온다.
환경변수
변수 | 기본값 | 설명 |
|
| 바인드 주소( |
|
| 포트. Render/Koyeb는 이 값을 자동 주입한다( |
|
| 작업 SQLite(판정 이력·쿼터·캐시). 없으면 기동 시 생성 |
|
|
|
|
|
|
|
| robots·llms·sitemap·pSEO·가이드 canonical 의 공개 주소 |
| – | 구글 서치콘솔 소유확인 토큰 → |
| – | 네이버 서치어드바이저 소유확인 토큰 → |
| – | 소유확인 HTML 파일(JSON). 예: |
| – | 공공데이터포털 인증키(Decoding) |
| – | 법제처 OC 값 |
| DB 옆 | 문의 접수 저널 경로(연락처가 평문 → 커밋ㆍ이미지 포함 금지). 비우면 기본값, |
| – | 새 문의 접수 시 JSON 을 POST 할 운영자 채널(http/https만). 실패해도 접수는 그대로 저장된다 |
|
|
|
| – |
|
| – | 서버 발급 티어 키(쉼표 구분). |
|
| 일반 경로 HTTP 요청 제한(분당, 클라이언트별) |
|
| 툴ㆍMCPㆍ문의 경로 요청 제한(분당). 툴 경로 전체에는 이 값의 10배 상한이 하나 더 걸린다 |
보안 설정 (0.5.3)
티어는 서버 키로만:
X-Tier헤더만으로는 무료 월 250회 한도가 풀리지 않는다.CLNS_PRO_API_KEYS에 넣은 키를X-Api-Key(또는Authorization: Bearer)로 제시할 때만 해당 티어가 인정되고, 한도 면제는store.UNLIMITED_TIERS에 등록한 티어만 해당한다(현재는 비어 있음 = 모두 무료 한도).요청 제한: 클라이언트별 슬라이딩 윈도(일반 120/분, 툴 60/분) + 툴 경로 전체 상한. 초과하면
429와Retry-After,/v1/stats에는rate_limited플래그만 더한다. 제한 키는 프로세스가 기동 때 만든 salt + 주소의 짧은 BLAKE2b 해시로만 메모리에 두고, 주소 원문은 DBㆍ로그ㆍ통계 어디에도 남기지 않는다.법령 조문 정확도:
get_legal_basis의 실시간 조회에서 법령명이 정확히 일치하지 않으면 그 후보의 조문 본문을 비우고name_mismatch(후보 이름)만 돌려준다.
기동 시 data/recalls.sqlite(리콜 로컬 인덱스)를 작업 DB로 복사한다 — 원본 인덱스 파일은 쓰지 않는다.
무료 클라우드 배포
Dockerfile(python:3.12-slim, 비루트 실행, 헬스체크 포함)과 render.yaml(Render Blueprint)이 준비되어 있다.
Render 무료 플랜 — 서비스 이름 clns-kr
이 프로젝트를 GitHub 저장소에 올린다(
.env는.gitignore로 제외,data/recalls.sqlite는 커밋 대상).Render → New > Blueprint → 저장소 선택 →
render.yaml인식 → Apply.대시보드에서
DATA_GO_KR_SERVICE_KEY,LAW_GO_KR_OC입력(sync: false라 저장소에는 값이 없다. 비워 두면 코퍼스 모드로 뜬다).https://<서비스>.onrender.com/접속 → 웹 UI,/healthz→ 헬스체크.
Docker로 직접
docker build -t clns-kr .
docker run -p 8787:8787 -e IMPORT_COMPLIANCE_LIVE=1 \
-e DATA_GO_KR_SERVICE_KEY=*** -e LAW_GO_KR_OC=*** clns-kr무료 플랜 주의
영구 디스크가 없어 작업 DB(판정 이력·쿼터 카운터·일별 통계·일일 스냅샷)는 재시작 시 초기화된다. 리콜 인덱스는 이미지에 있어 매 기동마다 다시 적재된다. 시계열 스냅샷을 자산으로 남기려면
--export data/snapshots로 JSON 을 내보내 영구 볼륨·외부 저장소에 보관해야 한다.미접속 시 슬립되어 첫 요청이 30~60초 걸릴 수 있다.
.dockerignore가.env·__pycache__·테스트·도구·원본 CSV를 제외하므로 이미지에 API 키가 들어가지 않는다.페이지는 외부 CDN 없이 인라인 CSS/JS만 쓰고 CSP(
default-src 'none')로 외부 로드를 막는다.무료 쿼터는 브라우저별 클라이언트 ID(
localStorage)당 250회/월이다. IP 단위 제한은 없으므로, 공개 트래픽이 커지면 리버스 프록시 단계의 레이트리밋이 필요하다.
테스트
cd src
python3 tests/test_ad_labeling.py # 37 tests (유형별 광고 기준 차이·위험도·근거 조문·한글표시 체크리스트·웹 UI)
python3 tests/test_mfds_disposition.py # 20 tests (15124560·15124559 연동·개인정보 제거·폴백 3단계·코드 30·스키마·HTTP)
python3 tests/test_engine.py # 27 tests
python3 tests/test_http.py # 3 tests (실제 소켓)
python3 tests/test_live_api.py # 24 tests (네트워크 없이 고정 응답)
python3 tests/test_recall_index.py # 12 tests (리콜 CSV 파싱·적재·검색·인덱스 복사)
python3 tests/test_web.py # 30 tests (브랜드·웹 UI·별칭·환경변수·모듈 엔트리포인트·키 비노출·UI 계약·레거시 브랜드 잔재)
python3 tests/test_patches_p0_p1.py # 41 tests (MCP JSON-RPC·CORS·크롤러 파일·HS 10자리 판정·식약처 캐시·head 메타·모바일 탭)
python3 tests/test_pseo_stats.py # 25 tests (pSEO 35개 페이지·동적 sitemap·익명 카운터·stdio MCP·MIT·CI·시크릿 미포함)
python3 tests/test_guides_trends.py # 31 tests (가이드 36종 렌더·FAQPage·참조 무결성·sitemap/llms·스냅샷 멱등·전일 대비·추이·/v1/trends·CLI·익명성)
python3 tests/test_site_verification.py # 11 tests (검색엔진 소유확인 파일 서빙)
python3 tests/test_testset_100.py # 18 tests (100건 구조·분야별 정확도·중대 규제 누락 FN·결정성)
python3 tests/test_medical_hygiene_rra.py # 25 tests (의료기기·위생용품 카드·현행 조문 검증·적합성평가 실연동·pSEO 연결)
python3 tests/test_schema_013.py # 31 tests (표준 상태 5단계·누락 정보·지리 필드·규제 태그·하위 호환·익명성)합계 388건. 네트워크 없이 전부 통과한다(실호출은 tools/verify_live_apis.py로 따로 검증).
CI 에서는 같은 스위트를 python3 -m unittest discover -s tests 로 한 번에 돌리고, 그 앞에 --check-corpus·--check-testset 자기검증을 둔다.
익명 통계 (GET /v1/stats)
무엇을 저장하는가 — 날짜(YYYY-MM-DD, Asia/Seoul) · 경로 · 툴 이름 · verdict.code · 0건/오류 여부의 호출 수뿐입니다.
무엇을 저장하지 않는가 — IP(및 X-Forwarded-For 같은 전달 헤더), User-Agent 원문, 쿠키, Referer, 세션 ID, 질의문 원문. 알 수 없는 경로는 /404 한 칸으로 합산해 임의 문자열이 통계에 남지 않게 합니다.
curl -s 'https://clns-kr.onrender.com/v1/stats?days=7'{
"ok": true, "timezone": "Asia/Seoul", "window_days": 7,
"privacy": {"stores_ip": false, "stores_user_agent": false,
"stores_cookies": false, "stores_identifiers": false},
"days": [{"date": "2026-11-18", "requests": 42,
"paths": {"/": 12, "/p/usb-mini-fan": 5, "/mcp": 3},
"tools": {"lookup_hs_requirements": 7},
"verdicts": {"check_likely": 4, "info_needed": 3},
"flags": {"zero_results": 1, "errors": 0}}],
"totals": {"requests": 42, "paths": {}, "tools": {}, "verdicts": {}, "flags": {}}
}이 카운터가 상품 개선의 입력입니다 — “어떤 품목을 넣다가 0건을 맞는지”가 pSEO 우선순위, “어떤 툴이 실패하는지”가 장애 감지입니다.
라이선스
MIT — LICENSE 참고. 저작권자는 익명 운영 주체 CLNS-KR 하나만 표기합니다(개인 이름·연락처 없음).
구조
src/
import_compliance/
engine.py 판정 파이프라인(3단계·표준 상태·신선도·가드·강한 신호 매칭)
corpus.py 코퍼스 로드·정규화
models.py 데이터 모델(strong_signals·exclude_signals 포함)
standards.py 표준 상태 5단계·규제 태그 25종·표준 스펙명·국가코드(ISO)
policy.py 면책·금지 표현·티어 경계
store.py SQLite 캐시·쿼터·폴백·TTL 캐시·실API 게이트웨이·일별 카운터
live_api.py 공공 API 6종 어댑터(파싱·정규화·재시도·키 리댁션)
recall_index.py 국표원 리콜 파일데이터(15040696·15054301) 적재·검색
api.py 15개 툴 + MCP 매니페스트·툴 정의(병렬 호출·7일 캐시·provenance 보정·툴 호출 계측)
advertising.py 과대광고·부당표시 탐지 규칙 16종(유형별 적용·위험도·대체 표현·근거 조문)
labeling.py 한글표시사항 필수항목 체크리스트(식품·건기식·화장품·KC 전기/생활용품·반려동물 사료·일반 공산품)와 누락 판정·과태료 사례
ecommerce.py 국내 이커머스 공정위·전자상거래법 규칙 14종 + 판매자 정보·거래조건 고지 9항목(수정 전→후 문구)
mfds_dispositions.py 식약처 행정처분(15124560·15124559) 연동·개인정보 제거·캐시·패턴 폴백
mcp_http.py MCP Streamable HTTP(JSON-RPC 2.0) 처리기
mcp_stdio.py 같은 로직을 쓰는 stdio 엔트리포인트(줄 단위 JSON-RPC)
pseo.py 품목별 페이지(35개) 서버 렌더러 · noindex/사이트맵 규칙
guides.py 질문형·규제별 가이드(100개) 서버 렌더러 · FAQPage · 검증 조문 키 참조
snapshots.py 일일 리콜·행정처분·금지성분 스냅샷 적재 · 전일 대비 · 추이(7/30일 급증)
usage.py 익명 일별 카운터(경로·툴·판정·0건/오류) + /v1/stats 페이로드 + 문의 요약(관리자)
inquiry_alert.py 문의 접수 알림(웹훅ㆍstdout 로그ㆍ연락처 마스킹) — 유실 대비
ratelimit.py HTTP 요청 제한(메모리 슬라이딩 윈도ㆍsalt 해시 키ㆍ주소 원문 미저장)
static_files.py robots.txt·llms.txt·동적 sitemap.xml·MCP 서버 카드·og 이미지
web_ui.py 사람용 단일 HTML 화면(외부 CDN 0, 인라인 CSS/JS)
server.py stdlib HTTP 서버(웹 UI·pSEO·JSON API·MCP·CORS·요청 제한·관리자 요약·배포용 환경변수)
cli.py CLI·코퍼스 자기검증·`--serve`
traps_20.json 함정 24케이스(의료기기·위생용품·의약품 포함, corpus 1.0.6)
testset_100.json 대표 100품목 테스트셋(8분야·필수 규제 태그)
pseo_items.json 품목 35개 카탈로그(1.0.1) + 관세청 실조회 요건 표(2026-11-18)
guides_items.json 질문 50개 카탈로그(1.1.0) — 검증 조문·케이스·툴·태그 참조
schema.sql Postgres 이관용 DDL
tests/
tools/verify_live_apis.py 실API 4종 라이브 검증
tools/run_live_scenarios.py 대표 3품목 라이브 실전 테스트 러너
tools/refresh_pseo_hs.py pSEO 카탈로그의 HS 요건 표만 실API로 재적재
tools/build_corpus_doc.py 문서 자동 생성
tools/build_testset_100.py 대표 100개 테스트셋 생성·구조 검증
tools/make_og_image.py 공유 미리보기 PNG 생성(Pillow, 생성 시점에만)
static/og.png 1200×630 공유 미리보기(og:image)
LICENSE MIT (Copyright (c) 2026 CLNS-KR)
.github/workflows/test.yml CI(3.11·3.12, --check-corpus + --check-testset + 전체 테스트 + stdio 스모크)
Dockerfile 무료 클라우드 배포 이미지(python:3.12-slim)
render.yaml Render Blueprint(free Web Service, 키는 sync:false)
.dockerignore .env·캐시·테스트 제외(키가 이미지에 구워지지 않게)갱신 규칙
코퍼스를 고치면 python3 tools/build_corpus_doc.py로 02-ai-trap-corpus-20.md를 다시 생성하고, 세 테스트를 모두 통과시킨 뒤 반영합니다.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Korea import requirements by HS code, plus Korean company lookup by name, status and KYB checks.
Korean customs permits and certificates required per HS code: law, document, agency (Korea Customs)
Korea Government Procurement MCP — KONEPS (나라장터 / g2b) open bids and procurement vendors, via BOIM…
Korean tax-office and fair-trade registries, HS codes, landed cost. Two tools need no API key.
Related MCP Servers
- AlicenseCqualityCmaintenanceSearch, compare, and analyze Korean national laws and public institution internal regulations via MCP.10082 npm2MIT
- AlicenseBqualityAmaintenanceMCP server for Korean law data (statutes, precedents, regulations) with citation verification, impact analysis, and time comparison tools.105,181 npm2,911MIT
- AlicenseAqualityCmaintenanceMCP server that enables searching Korean patents, trademarks, and designs via KIPRIS Plus open APIs. Supports keyword, advanced, applicant, and rightholder searches with detailed bibliographic lookup.764MIT
- AlicenseAqualityDmaintenanceMCP server providing comprehensive Korean legal data access (laws, precedents, regulations, ordinances) with citation verification, temporal comparison, impact graphs, and legal research workflows.10MIT