관세청 수출입통계와 산업부 K-SURE·KOTRA 데이터, AI로 전 수출산업의 품목·국가별 시장을 스코어링·예측하는 수출 데이터 분석 플랫폼.
한국어 · English
관세청·산업부 공공데이터와 국산 AI를 결합한 수출 인텔리전스 플랫폼입니다. 반도체·자동차·2차전지·조선부터 K-Food·K-뷰티까지 전 수출산업 28개 품목 × 주요국을 다룹니다.
| 화면 | 설명 |
|---|---|
| 🧭 커맨드센터 | Top 수출 기회 · 달아오르는 시장 · 리스크 경보 · 뉴스 시그널을 한눈에 |
| 🗺️ 마켓맵 | FINVIZ 스타일 트리맵 — 타일 크기=수출액, 색=모멘텀(초록 상승 / 빨강 둔화). 분야별·국가별 |
| 📊 스코어 프로파일 | 품목별 Tradar Score·하위점수·수출 추세·국가별 구성·이벤트 타임라인·리스크 인덱스 |
| 🔎 디스커버리 | 28개 품목을 Tradar Score로 정렬·카테고리 필터(K-Food/반도체/2차전지…) |
| 📰 뉴스 인텔리전스 | 실시간 뉴스 시그널을 품목·시장에 자동 연결(감성·영향도·관련 품목) |
| 💬 AI 애널리스트 | 품목·시장·뉴스를 실제 수치 근거로 답변. ⌘K 커맨드 팔레트 |
| 📄 리포트 스튜디오 | 자연어 요청 → 선언적 Report Spec(DSL) → 관세청·산업부 데이터 리졸브 → 인터랙티브 리포트 자동 조립(app/report.html). LLM은 스펙만 설계하고 수치는 엔진이 계산(환각 차단) — 설계 문서 |
- 필수 공공데이터 — 관세청 품목별 국가별 수출입실적(공공데이터포털,
apis.data.go.kr/1220000/nitemtrade). 각 품목의 HS코드 기준으로 연동. - 파이프라인 — scripts/build_tradar_data.py 가 HS코드별 실적을 받아 연수출액·전년비·국가별 비중을 계산해
app/data/tradar.js로 굽는다.DATA_GO_KR_KEY설정 시 data.go.kr에서 실시간 동기화(server/customs_client.py).- 미설정 시 2024년 관세청 공표치 앵커(데모가 항상 동작).
- 산업통상부 공공데이터 레이어 — scripts/sync_motie_data.py(server/motie_client.py)가 산업부 산하기관 데이터를
app/data/motie.js(window.TRADAR_MOTIE)로 굽는다: 한국무역보험공사 국별신용등급·국가별 업종별 위험지수, 대한무역투자진흥공사(KOTRA) 해외시장뉴스·수입규제품목 정보. 마켓맵 K-SURE 리스크 레이어, 무역상대국 K-SURE 등급·對韓 수입규제 컬럼, 뉴스·경보에 연동. 키 미설정 시 공표치 앵커. - AI/분석(국산) — Tradar Score(시장 매력도), 수요 추세, 이상탐지 등은 앱 내 자체 로직으로 산출. 별도 국산 AI 엔진(승법 계절분해·조기경보·근거기반 상담)이 server/에 포함되어 파이프라인에 연결 가능.
관세청 수출입실적과 산업부 K-SURE·KOTRA 데이터를 함께 쓰며, 국산 AI 엔진은 예측·조기경보·근거기반 상담을 담당합니다.
관세청 품목별 국가별 수출입실적 + 산업부 K-SURE·KOTRA 데이터
│ scripts/build_tradar_data.py (인증키 시 실시간 / 미설정 시 2024 공표치 앵커)
▼
app/data/tradar.js ──▶ Tradar SPA (React + ECharts, Chartmetric 디자인시스템)
python scripts/build_tradar_data.py # 관세청 데이터 → app/data/tradar.js (인증키 시 실시간)
python scripts/sync_motie_data.py # 산업부(K-SURE·KOTRA) 데이터 → app/data/motie.js
python scripts/serve.py # 플랫폼: http://localhost:5183English repository README: README.en.md.
- 버그와 개선 제안은 GitHub Issues로 남깁니다.
- 코드 변경은 브랜치를 만든 뒤 pull request로 제안합니다. PR 전에 CONTRIBUTING.md의 테스트와 린트 명령을 실행합니다.
- 악용 가능한 취약점, 비밀값 노출, 인증 우회, 데이터 노출 가능성은 공개 이슈 대신 GitHub Security Advisory로 비공개 신고합니다.
FastAPI 서버는 정적 PWA와 함께 /api/* JSON 인터페이스를 제공합니다.
| 엔드포인트 | 입력 | 출력 |
|---|---|---|
GET /api/health |
없음 | 서비스 상태, 데이터 기간, 품목 수 |
GET /api/catalog |
없음 | 메타데이터, 국가 목록, 품목 카탈로그 |
GET /api/forecast?hs=1902.30&country=US&horizon=6 |
HS 코드, 국가 코드, 1-12개월 예측 기간 | 과거 시계열, 예측 평균·상하한, 추세, 시장 시그널 |
GET /api/radar?limit=24 |
반환 개수 | Top 수출 기회와 리스크 경보 |
GET /api/radar/product/{hs} |
HS 코드 | 품목별 국가 시장 레이더 |
POST /api/advisor |
{"question": "..."} |
질문 의도, 답변, 수치 근거 |
GET/POST /api/admin/llm-provider |
관리자 토큰, {"provider": "openrouter-solar-free"} |
서버 LLM provider 상태 조회·선택 |
POST /api/report |
{"question": "..."} |
자연어 → Report Spec 플랜 → 데이터 리졸브(리포트 스튜디오) |
POST /api/report/render |
{"spec": {...}} |
스펙 직접 리졸브 — UI 상호작용 라운드트립 |
GET /api/report/schema |
없음 | Report Spec DSL의 JSON 스키마(계약) |
관리자 UI는 /admin.html에서 제공하며, TW_ADMIN_TOKEN으로 보호된 서버 provider 선택 API만 호출합니다.
app/
index.html Tradar 플랫폼(Claude Design 원본) + PWA 메타
vendor/generated/ 디자인 런타임(dc-runtime)과 생성된 디자인 시스템 번들
_ds/ Chartmetric 디자인 시스템(토큰·스타일·컴포넌트)
data/tradar.js 관세청 연동 데이터(build_tradar_data.py 산출)
vendor/ React 18 · ECharts 5 · liquid-glass-react 1.1.1(MIT, 리퀴드 글래스 UI) — 오프라인용 로컬 벤더링
server/ 관세청 API 클라이언트 + 국산 AI 엔진(예측·스코어·상담)
scripts/ build_tradar_data.py(데이터 파이프라인) · serve · capture
packaging/android/ Android(Jetpack Compose + TWA)
deliverables/ 대회 제출물(기획서·공통양식·발표자료)
design/ Tradar.dc.html 원본(Claude Design 소스)
Tradar UI는 Chartmetric 스타일의 라이트 데이터-덴스 디자인 시스템(app/_ds)을 따릅니다 — 다크 사이드바 + 화이트 캔버스, 절제된 블루 액센트, 브랜드 그라디언트(cyan→blue→violet), 탭ular 숫자, ECharts 시각화.
별도 표기가 없는 한 프로젝트 코드, 문서, Android 리소스, 프로젝트 소유 이미지 자산은 GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later)로 배포됩니다. 이 소프트웨어를 수정해 네트워크로 서비스하는 경우, 그 이용자에게 수정본의 소스 코드를 제공해야 합니다. Android 모바일 클라이언트에는 앱스토어 배포를 위한 AGPL 7조 추가 허가가 적용되며, 서버와 웹/PWA 클라이언트는 이 예외 대상이 아닙니다. 자세한 내용은 LICENSE와 NOTICE를 참고하세요.