tariff-resolver

AI 어시스턴트를 미국 수입 관세 조사 도구로 바꿔주는 MCP 서버 — 공식 USITC 통합관세율표(HTS) 데이터(미국 정부 공개 도메인, 35,000개 이상의 관세 라인)를 기반으로 합니다.

• 🔍 HTS 코드 후보 — 일반 제품 설명에서 추출, CBP CROSS 유권해석 링크 포함

• 🧮 착지비용 구성요소: MFN/FTA 기본 세율 + Chapter 99 추가 관세(IEEPA / Section 301 / 232) + MPF/HMF 수수료

• 📡 관세 변경 추적: HTS 코드를 워치리스트에 등록, HTS 개정판 간 세율 차이 비교

• 🤖 AI 최적화, 환각 저항성: 실제 Chapter 99 규정 텍스트와 파싱된 세율을 반환하므로, LLM이 2024년식 숫자를 지어내는 대신 실제 예외 체인을 근거로 추론합니다.

왜 지금인가: de minimis 면제가 종료된 이후(2025년 8월 29일), 미국으로 향하는 모든 화물에는 HTS 코드와 관세 납부가 필요하며, 2025~26년 세율은 행정명령으로 계속 변경되고 있습니다.

어떤 정부 기관과도 관련이 없습니다. 출력물은 브로커 사전 검수를 위한 후보/추정치이며 — 세관, 법률, 세무 자문이 아닙니다. 추정치는 AD/CVD 관세를 제외합니다.

설치

Node.js ≥ 18 필요.

claude mcp add tariff-resolver -- npx -y tariff-resolver

또는 MCP 클라이언트 설정에서:

{ "mcpServers": { "tariff-resolver": { "command": "npx", "args": ["-y", "tariff-resolver"] } } }

Related MCP server: mcp-sputnikx-market

💡 시도해 볼 프롬프트

• 기본 검색: "남성용 100% 면 티셔츠의 HTS 코드를 찾아줘."

• 전체 시나리오: "HTS 6109.10.00, 원산지 중국, 통관가 $5,000, 해상 운송 기준으로 관세 시나리오를 계산해줘."

• 소싱 결정: "스테인리스 진공 플라스크 $10,000어치를 수입하려고 해. 중국에서 조달할 때와 베트남에서 조달할 때의 착지비용을 비교해줘."

• 최신 유지: "내 카탈로그의 관세 변경을 추적해줘: 6109.10.00, 8507.60.00, 9617.00.10."

도구

설계

서버는 검색을 담당하고, LLM이 추론을 담당합니다. Chapter 99 규칙은 (해당되는 경우 파싱된 adder_pct와 함께) 원문 그대로 반환되므로, 모델이 블랙박스 계산을 신뢰하는 대신 실제 예외 체인을 읽습니다. 10자리 통계 접미사의 세율은 상위 세율 라인에서 상속됩니다. 종료된 조항은 필터링되어 집계됩니다.

데이터

USITC 공식 JSON API(미국 정부 공개 도메인)에서 가져온 전체 HTS 스냅샷이 포함되어 있습니다. 언제든 새로고침:

python3 scripts/fetch_hts.py   # ~2 min, fails hard rather than write a partial dataset

dataset_info는 쿼리가 실행되는 개정일을 보고합니다.

라이선스

MIT. 관세 데이터는 미국 정부의 저작물(공개 도메인)입니다.