Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas Iniciar sesión

CLNS — Korea Import Compliance

de CLNS-KRversión 0.2.0i★ 0iSe ejecuta en la nubeSitio oficial ↗
Nombre en el registroio.github.CLNS-KR/clns

Cómo instalar

Qué hace

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

Texto original del autor

  • Conexión Se ejecuta en la nube
  • Cuenta o clave No necesita clave
  • Categoría Derecho y datos públicos

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso20/100

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala CLNS — Korea Import Compliance. Sigue https://mcp.popnx.com/i/clns-kr-clns.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (clns-kr.onrender.com) · ✓ Comandos revisados el 18 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreCLNS — Korea Import Compliance
    Remote MCP server URL · Direcciónhttps://clns-kr.onrender.com/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsCLNS — Korea Import Compliance

  4. Pruébalo

    Usa CLNS — Korea Import Compliance y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando CLNS — Korea Import Compliance o muestra una herramienta de CLNS — Korea Import Compliance en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreCLNS — Korea Import Compliance
    Connection · Direcciónhttps://clns-kr.onrender.com/mcp
  3. Elige CLNS — Korea Import Compliance en un chat

    Abre un chat nuevo y elige CLNS — Korea Import Compliance en tus plugins antes de escribir

  4. Pruébalo

    Usa CLNS — Korea Import Compliance y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando CLNS — Korea Import Compliance o muestra una herramienta de CLNS — Korea Import Compliance en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user clns https://clns-kr.onrender.com/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver CLNS — Korea Import Compliance en la lista como conectado

  4. Pruébalo

    Usa CLNS — Korea Import Compliance y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando CLNS — Korea Import Compliance o muestra una herramienta de CLNS — Korea Import Compliance en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa CLNS — Korea Import Compliance y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando CLNS — Korea Import Compliance o muestra una herramienta de CLNS — Korea Import Compliance en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa CLNS — Korea Import Compliance y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando CLNS — Korea Import Compliance o muestra una herramienta de CLNS — Korea Import Compliance en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://clns-kr.onrender.com/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa CLNS — Korea Import Compliance💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user clns https://clns-kr.onrender.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "clns": {
      "url": "https://clns-kr.onrender.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "clns": {
      "type": "http",
      "url": "https://clns-kr.onrender.com/mcp"
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Conexión
Se ejecuta en la nube
Transporte
streamable-http
Última versióni
0.2.0
Publicado en el registroi
19 nov 2026
Último cambio de códigoi
19 nov 2026
Última revisión
18 nov 2026
Creador
CLNS-KR
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 18 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • assess_import_case

    품목·상황을 자연어로 받아 수입요건·인증·표시·통관 함정을 3단계로 판정하고 근거 조항과 면책을 반환합니다.

  • lookup_hs_requirements

    HS 코드로 세관장확인대상 여부·법령·기관을 판정합니다. 6자리는 요건 판정에 부족합니다.

  • check_kc_certification

    전기용품·생활용품·어린이제품·전파 적합성평가 중 어떤 절차가 걸리는지 판정합니다.

  • check_food_cosmetics

    수입신고·영업등록·한글표시·광고심의 등 식약처 요건을 판정합니다.

  • lookup_recall

    브랜드·모델명·제품명으로 국내 리콜 이력을 조회합니다. 로컬 인덱스(국표원 15040696) 우선, 없으면 소스 미연결을 그대로 알립니다.

  • get_legal_basis

    코퍼스에 수록된 법령 조항의 요지·시행일·원문 URL을 반환합니다.

  • explain_trap

    케이스 ID(TRAP-01~20)의 시나리오, 흔한 AI 오답, 정답, 근거를 반환합니다.

  • get_service_meta

    코퍼스 버전, 3단계 판정 정의, 무료/유료 경계, 잔여 호출 수를 반환합니다.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub CLNS-KR, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: ayer

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 393 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 8 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/clns-kr-clns.svg)](https://mcp.popnx.com/en/servers/clns-kr-clns)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Derecho y datos públicosi

  • Más estrellas que el 0% de los otros 1961 servidores de esta categoría
  • Publicado en el registro más recientemente que el 97% de los otros 1961 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 1961 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro CLNS — Korea Import Compliance?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez ayer, y la última versión (0.2.0) llegó al registro ayer.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

de lexifinaMuy usado★ 2,1 milActualizado hace 10 días

Se ejecuta en la nube✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

de librejusticeInicial★ 38Actualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

de street1983nkInicial★ 18Actualizado hace 5 meses

Se ejecuta en la nube✓ del servicio · infranode.dev

Fedlex Connector

Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.

de JayTheSkierInicial★ 8Actualizado hace 7 meses

Se ejecuta en la nube✓ del servicio · fedlex-connector.ch
Comparado con otros parecidos
Este
CLNS — Korea Import Compliance
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
Dónde se ejecutaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas5/54/44/44/44/44/4
LicenciaMITNOASSERTIONMITApache-2.0Apache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.


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](https://clns-kr.onrender.com) (무료 베타 · Render free Web Service)
  • 결제 없음 · 100% 무료 베타 · 회원가입 없음
  • 외부 API 키가 없어도 동작(코퍼스 기반). 키를 넣으면 관세청·식약처·법제처 공공 API를 실시간 호출하고, 실패 시 캐시로 폴백. 전파 적합성평가(국립전파연구원)는 키가 필요 없는 공개 API라 번호만 있으면 바로 조회한다
  • 원본 API 재전송 없음 — 결합·정규화한 판정만 출력
  • 브라우저에서 바로 쓰는 사람용 화면(GET /) 포함: 품목명만 넣고 10초 안에 확인 항목·근거 조문·리콜 이력을 본다. 화면은 CLNS Check · CLNS Intelligence · CLNS Ad & Label · 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건·오류 수만 집계
  • 규제 카드 24개(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·요힘빈·실데나필 등 시드) 여부와 ④ 자가사용 인정기준(총 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.json` 14건(--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)

문서

파일내용
01-api-sources-and-legal.md실제 쓸 공공 API 목록, 신청 방법, 확인한 약관 원문, 상업적 가공 안전성 판정, 2026-11-18 실호출 검증 결과
02-ai-trap-corpus-20.md일반 AI가 틀리는 함정 24개(상황·오답·정답·근거·판정 로직). 파일명은 초기 20건 기준이며, 0.1.5에서 TRAP-23·24를 더해 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품목 라이브 판정 산출물(응답시간·요건·리콜 포함, 키 없음)
09-ad-labeling-0.2.0.md0.2.0 설계 — 유형별 광고 기준 차이, 탐지 규칙 16종, 한글표시 체크리스트, 행정처분 연동·폴백·개인정보 처리
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), 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)은 내부 문서로 두고 공개 저장소에는 포함하지 않는다.

실행

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)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
식약처 의약품 계열 5종(15058963·15058041·15095677·15075057·15059486)apis.data.go.kr/1471000/...이 계정은 활용승인 전(코드 30) → drug_screening.api_candidates 에 approval_required 로 표시. 성분 대조는 시행령 별표 로컬 사전으로 수행

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"}}} 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 을 바로 보내도 동작합니다.
툴 11종
툴하는 일주요 인자
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(필수)
check_drug_import의약품·영양제 성분 대조: 마약류·원료물질·국내 전용 성분 + 자가사용 인정기준(6병·3개월분)product_name(필수), channel, quantity, unit, prescription, purpose
check_ad_labeling상세페이지·상품명 문구와 라벨 문구를 유형별 기준으로 검수: 위험 표현·근거·대체 표현 + 한글표시사항 누락product_type, ad_copy, label_text, label_items, functional, imported
lookup_mfds_disposition식약처 행정처분 이력(식품제조가공업·식품판매업) + 업종별 빈발 위반 패턴(개인정보 필드 폐기)industry, keyword, license_no, confirmed_on, rows, limit
lookup_recall브랜드·모델명·제품명으로 국내 리콜 이력(국표원 15040696 로컬 인덱스)brand, model, product_name, category
get_legal_basis코퍼스 수록 법령 조항 요지·시행일·원문 URLlaw(필수), article
explain_trap함정 케이스(TRAP-01~24) 시나리오·흔한 오답·정답·근거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", ...]케이스·응답 단위 규제 태그(25종 어휘)
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}, "assess

Solo se muestra el principio; lee el resto en el repo