Repository avatar
Other Tools
v0.1.4
active

clns

io.github.CLNS-KR/clns

Korea import pre-check: clearance requirements, MFDS history, recalls, RRA conformity, statutes.

Documentation


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 /) 포함: 품목명만 넣고 10초 안에 확인 항목·근거 조문·리콜 이력을 본다. 화면은 CLNS Check · CLNS Intelligence · CLNS API & MCP 세 축으로 나뉜다.
  • 품목별 무료 체크 페이지(pSEO) 35개: /p/ 인덱스와 /p/{slug} — 무선 미니 선풍기·보조배터리·오메가3·선크림·반려동물 사료 등. JS 없이 크롤러가 읽는 서버 렌더 HTML에 H1·대표 HS·세관장확인 요건 표·규제 축(소관 기관·확인 카드·MCP 툴)·KC·전파·식약처 항목·핵심 함정·근거·면책·API/MCP 연결 안내·실시간 조회 링크를 담는다(sitemap.xml 동적 생성, 얇은 페이지는 noindex).
  • 익명 일별 통계: GET /v1/stats — IP·User-Agent 원문·쿠키·개인 식별자를 저장하지 않고 날짜별 경로/툴/verdict.code/0건·오류 수만 집계
  • 규제 카드 22개(0.1.4) — 기존 20개 쟁점에 의료기기법(TRAP-21)·위생용품 관리법(TRAP-22) 카드를 법제처 실조회 검증으로 추가. 미래 시행일 개정 조문(의료기기법 2026-10-20 공포분, 본문 2027-10-21 시행)은 인용하지 않고 현재 시행 중인 조문만 쓴다
  • 대표 100개 품목 테스트셋 — 8개 분야(전기·전자 KC / 무선·전파 / 배터리 / 어린이제품 / 식품·건기식 / 화장품 / 생활화학·차량용 방향제 / 의료기기·위생용품) 100건으로 분야별 정확도와 중대 규제 누락(FN) 0건을 검증(--check-testset). 의료기기·위생용품 12건은 카드에 맞춰 필수 태그를 승격하고, 생리대(의약외품) 2건은 must_not_find로 오분류를 막는다
  • 응답 스키마 0.1.3(0.1.4에서도 유지) — 기존 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)

문서

파일내용
01-api-sources-and-legal.md실제 쓸 공공 API 목록, 신청 방법, 확인한 약관 원문, 상업적 가공 안전성 판정, 2026-11-18 실호출 검증 결과
02-ai-trap-corpus-20.md일반 AI가 틀리는 함정 22개(상황·오답·정답·근거·판정 로직). 파일명은 초기 20건 기준이며, 0.1.4에서 TRAP-21·22를 더해 tools/build_corpus_doc.py로 재생성했다
03-mvp-spec-and-risk-mitigation.md5대 리스크 대응, 아키텍처, 캐시 DB, 8개 툴, 무료/유료 경계, 면책
live-api-verification-2026-11-18.json라이브 검증 산출물(정규화 샘플·상태, 키 없음)
live-scenario-results-2026-11-18.json대표 3품목 라이브 판정 산출물(응답시간·요건·리콜 포함, 키 없음)
04-live-scenario-report-2026-11-18.md대표 3품목 라이브 판정 사람용 리포트
.env.example키 템플릿(.env는 커밋 금지)
LICENSEMIT 라이선스(Copyright (c) 2026 CLNS-KR)
.github/workflows/test.ymlCI: --check-corpus + --check-testset + 전체 테스트 + stdio MCP 스모크(Python 3.11·3.12)

출시 전 감사·성장 계획(05), 테스트셋·스키마 설계(06), 0.1.4 변경 상세(07), 법령 조문 검증 산출물은 내부 문서로 두고 공개 저장소에는 포함하지 않는다.

실행

cd src
python3 -m import_compliance.cli --check-corpus
python3 -m import_compliance.cli --check-testset     # 100건 분야별 정확도·규제 누락 FN
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)apis.data.go.kr/1220000/retrieveCcctLworCd/getRetrieveCcctLworCdlookup_hs_requirements.hs_requirements_live
식약처 수입식품 허가정보(15058273)apis.data.go.kr/1471000/ImportFoodPrmisnInfoService05/getImrtsCnfirmList05check_food_cosmetics.food_import_live
식약처 수입식품 제품DB(15073949)apis.data.go.kr/1471000/IprtFoodPrdtDBService02/getIprtFoodPrdtDBInq02check_food_cosmetics.food_import_live
법제처 국가법령정보(lawSearch/lawService)www.law.go.kr/DRF/lawSearch.do, lawService.doget_legal_basis.law_live
국립전파연구원 적합성평가 DB정보(3034183)emsit.go.kr/openapi/service/AuthenticationInfoService/getAuthInfo.do (키 불필요)assess_import_case.rra_conformity_live, check_kc_certification.rra_conformity_live

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

같은 8개 툴을 두 가지 전송으로 제공합니다(로직은 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"}}}
JSON

MCP 클라이언트 설정 예시(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 을 바로 보내도 동작합니다.

툴 8종

툴하는 일주요 인자
assess_import_case품목·상황 자연어 → 수입요건·인증·표시·통관 함정 3단계 판정 + 근거·면책query(필수), facts, limit
lookup_hs_requirementsHS 10자리 → 세관장확인대상 여부·법령·기관·확인시점hs_code(필수), direction
check_kc_certification전기용품·생활용품·어린이제품·전파 적합성평가 중 걸리는 절차 판정product_name, target_age, rf_tx, battery, ac_plug
check_food_cosmetics식품·건기식·화장품·기구용기: 수입신고·영업등록·한글표시·광고심의product_name, kind(필수)
lookup_recall브랜드·모델명·제품명으로 국내 리콜 이력(국표원 15040696 로컬 인덱스)brand, model, product_name, category
get_legal_basis코퍼스 수록 법령 조항 요지·시행일·원문 URLlaw(필수), article
explain_trap함정 케이스(TRAP-01~20) 시나리오·흔한 오답·정답·근거case_id(필수)
get_service_meta코퍼스 버전·판정 등급·무료/유료 경계·잔여 호출–

무료 한도는 브라우저/클라이언트 ID 당 월 250회이며 get_service_meta 는 차감되지 않습니다.

응답 스키마 0.1.3 — 표준 상태 · 누락 정보 · 공통 필드

기존 3단계 verdict(check_likely/info_needed/low_risk)는 그대로 두고, 판정 상태·빠진 스펙·지리 정보를 추가했다. 필드만 늘었으므로 기존 클라이언트는 수정 없이 동작한다.

필드값설명
assessment_statusAPPLICABLE · NOT_APPLICABLE · POTENTIALLY_APPLICABLE · REVIEW_REQUIRED · UNKNOWN표준 판정 상태(verdict·findings 수·누락 정보에서 계산)
missing_information["hs_10_code", "intended_age", ...]판정을 좁히려면 필요한 표준 스펙명 목록
missing_information_detail[{field, prompt, allowed_values, case_id}]같은 목록의 상세(질문·허용값·케이스)
destination"KR"통관 목적국
jurisdiction"KR"적용 법역(법령 카드가 한국법 기준)
origin"CN" · null원산지 ISO 3166-1 alpha-2. 확인되지 않으면 null(추측하지 않음)
origin_source"query" · "facts" · null원산지를 어디서 확인했는지
regulation_tags["ELECTRICAL_KC", ...]케이스·응답 단위 규제 태그(20종 어휘)
schema_version"0.1.3"응답 스키마 버전

상태와 기존 판정의 대응: 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)**으로 센다.

분야케이스예
전기·전자 KC16USB-C 65W 충전기, 노트북 어댑터, 에어프라이어 8516.60
무선기기·전파법12블루투스 스피커, 와이파이 공유기, 적외선 리모컨(저위험)
배터리12보조배터리, 전동공구 배터리 팩, 드론 배터리
어린이제품12PPSU 젖병, 유모차, 카시트, 무선 RC 완구
식품·건강기능식품16구매대행 과자, 건강기능식품 광고, 식품용 도마
화장품10수딩크림, 선크림(기능성), 향수
생활화학제품·차량용 방향제10주방 세정제, 차량용·겔 방향제, 디퓨저
의료기기·위생용품12전자혈압계·체온계·생리대 HS 요건, 소액 직구

검증 결과: 분야별 판정 정확도 100%(100/100), 중대 규제 누락 0건, NOT_APPLICABLE 오판 0건(2026-11-18, 네트워크 없이). 의료기기·위생용품 전용 규제 카드는 아직 없어 이 분야는 세관장확인·목록통관 축에서만 검증하며, 그 한계는 응답의 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                   # 테스트셋 재생성
경로내용
GET /사람용 웹 UI(CLNS Check · CLNS Intelligence · CLNS API & MCP)
GET /p/품목별 수입 요건 인덱스(35개, 크롤러 진입점)
GET /p/{slug}품목별 무료 체크 페이지(서버 렌더 HTML · JS 없음 · 얇은 페이지는 noindex). 없는 slug 는 404
GET /v1/stats익명 일별 통계 JSON(?days=7). IP·User-Agent·쿠키·개인 식별자 미저장
GET /healthz헬스체크
POST /mcp · POST /v1/mcpMCP JSON-RPC 2.0: initialize·notifications/initialized·ping·tools/list·tools/call. notification은 202(본문 없음), 표준 에러 코드(-32700/-32600/-32601/-32602), SSE 스트리밍 없음
GET /.well-known/mcp/server-card.jsonMCP 서버 카드(인증 없음·툴 8종 스키마)
GET /v1/mcp툴 매니페스트(사람이 읽는 JSON). GET /mcp 는 405(스트리밍 미지원)
POST /v1/tools/{tool}REST JSON 8종
GET /robots.txt·/llms.txt·/sitemap.xml검색·AI 크롤러용 공개 파일(sitemap.xml 은 / + /p/ + 전 품목 URL 동적 생성)
GET /static/og.png공유 미리보기 이미지(1200×630)
GET /<확인파일>.html검색엔진 소유확인 파일(SITE_VERIFICATION_FILES 로만 열린다. 없으면 404)
OPTIONS *CORS preflight 204. 모든 응답에 Access-Control-Allow-Origin: *

브라우저로 http://localhost:8787/ 을 열면 사람용 화면(CLNS Check · CLNS Intelligence · CLNS API & MCP)이 나온다.

환경변수

변수기본값설명
HOST0.0.0.0바인드 주소(--host 로 덮어쓰기)
PORT8787포트. Render/Koyeb는 이 값을 자동 주입한다(--port 로 덮어쓰기)
IMPORT_COMPLIANCE_DBdata/app.sqlite작업 SQLite(판정 이력·쿼터·캐시). 없으면 기동 시 생성
IMPORT_COMPLIANCE_LIVE01이면 .env 또는 환경변수의 키로 실API 조회
PUBLIC_BASE_URLhttps://clns-kr.onrender.comrobots·llms·sitemap·pSEO canonical 의 공개 주소
GOOGLE_SITE_VERIFICATION–구글 서치콘솔 소유확인 토큰 → <meta name="google-site-verification">
NAVER_SITE_VERIFICATION–네이버 서치어드바이저 소유확인 토큰 → <meta name="naver-site-verification">
SITE_VERIFICATION_FILES–소유확인 HTML 파일(JSON). 예: {"google1a2b.html":"google-site-verification: google1a2b.html"} — 루트 경로로 서빙
DATA_GO_KR_SERVICE_KEY–공공데이터포털 인증키(Decoding)
LAW_GO_KR_OC–법제처 OC 값

기동 시 data/recalls.sqlite(리콜 로컬 인덱스)를 작업 DB로 복사한다 — 원본 인덱스 파일은 쓰지 않는다.

무료 클라우드 배포

Dockerfile(python:3.12-slim, 비루트 실행, 헬스체크 포함)과 render.yaml(Render Blueprint)이 준비되어 있다.

Render 무료 플랜 — 서비스 이름 clns-kr

  1. 이 프로젝트를 GitHub 저장소에 올린다(.env는 .gitignore로 제외, data/recalls.sqlite는 커밋 대상).
  2. Render → New > Blueprint → 저장소 선택 → render.yaml 인식 → Apply.
  3. 대시보드에서 DATA_GO_KR_SERVICE_KEY, LAW_GO_KR_OC 입력(sync: false라 저장소에는 값이 없다. 비워 두면 코퍼스 모드로 뜬다).
  4. 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(판정 이력·쿼터 카운터·일별 통계)는 재시작 시 초기화된다. 리콜 인덱스는 이미지에 있어 매 기동마다 다시 적재된다.
  • 미접속 시 슬립되어 첫 요청이 30~60초 걸릴 수 있다.
  • .dockerignore가 .env·__pycache__·테스트·도구·원본 CSV를 제외하므로 이미지에 API 키가 들어가지 않는다.
  • 페이지는 외부 CDN 없이 인라인 CSS/JS만 쓰고 CSP(default-src 'none')로 외부 로드를 막는다.
  • 무료 쿼터는 브라우저별 클라이언트 ID(localStorage)당 250회/월이다. IP 단위 제한은 없으므로, 공개 트래픽이 커지면 리버스 프록시 단계의 레이트리밋이 필요하다.

테스트

cd src
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_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단계·누락 정보·지리 필드·규제 태그·하위 호환·익명성)

합계 247건. 네트워크 없이 전부 통과한다(실호출은 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단계·규제 태그 20종·표준 스펙명·국가코드(ISO)
    policy.py     면책·금지 표현·티어 경계
    store.py      SQLite 캐시·쿼터·폴백·TTL 캐시·실API 게이트웨이·일별 카운터
    live_api.py   공공 API 4종 어댑터(파싱·정규화·재시도·키 리댁션)
    recall_index.py  국표원 리콜 파일데이터(15040696·15054301) 적재·검색
    api.py        8개 툴 + MCP 매니페스트·툴 정의(병렬 호출·7일 캐시·provenance 보정·툴 호출 계측)
    mcp_http.py   MCP Streamable HTTP(JSON-RPC 2.0) 처리기
    mcp_stdio.py  같은 로직을 쓰는 stdio 엔트리포인트(줄 단위 JSON-RPC)
    pseo.py       품목별 페이지(35개) 서버 렌더러 · noindex/사이트맵 규칙
    usage.py      익명 일별 카운터(경로·툴·판정·0건/오류) + /v1/stats 페이로드
    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   함정 22케이스(의료기기·위생용품 추가, corpus 1.0.5)
  testset_100.json 대표 100품목 테스트셋(8분야·필수 규제 태그)
  pseo_items.json 품목 35개 카탈로그(1.0.1) + 관세청 실조회 요건 표(2026-11-18)
  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를 다시 생성하고, 세 테스트를 모두 통과시킨 뒤 반영합니다.

No installation packages available.