vendor-scout
지금 이 화면(README)은 "코드 저장소" 페이지이지 사이트가 아닙니다.
실제 데모 사이트는 위 github.io 주소입니다. 위 링크를 눌러 접속하세요.
화장품 제조업체 신규처 발굴용 사전 정보 확보·검증 개인 서비스.
업체명/사업자번호 입력 → 공공 API 실시간 조회 → 조회시점 스냅샷 리포트 생성 → 방문 크로스체크.
원칙
- 범용성: 어느 업체든 입력 즉시 현시점 최신정보 조회
- 신뢰성: 필드마다 출처·신뢰도(A~D) 기록
- 무누락: 조회 실패/데이터 없음도
data_gap으로 명시 기록 (빈칸 금지)
- 최신성: 기준일 5년 초과 데이터는 자동 제외 (
MAX_AGE_YEARS=5)
구조
vendor-scout/
├── .github/workflows/
│ └── collect.yml # 수동/스케줄 실행 워크플로우
├── src/
│ ├── collectors/ # 소스별 수집기 (1소스 = 1파일)
│ │ ├── mfds.js # 식약처: 제조업 등록, 기능성 심사/보고 품목(제형!)
│ │ ├── fsc_finance.js # 금융위: 재무제표 (매출/자산/부채/자본금)
│ │ ├── nps.js # 국민연금: 사업장 피보험자수 (실인원 프록시)
│ │ └── customs.js # 관세청: 수출입 실적
│ ├── report/
│ │ ├── schema.js # 4블록 스키마 + 신뢰도 등급 로직
│ │ └── build.js # 스냅샷 리포트 생성 (JSON + MD)
│ └── index.js # 엔트리: node src/index.js "리니어코스메틱"
├── data/snapshots/ # 불변 스냅샷 누적 (vendorId_v1.json, v2...)
├── docs/API_SOURCES.md # 소스별 필드·신뢰도·갱신주기 문서
└── .env.example
셋업 (5단계)
- API 키 발급: data.go.kr 로그인 → 아래 API 활용신청 (승인 즉시~1일)
- 식약처 화장품 관련 정보 (15020628)
- 식약처 기능성화장품 보고품목 (15095680)
- 금융위 기업 재무정보 (15043459)
- 국민연금 사업장 정보
- 레포 생성: GitHub에서 private 레포 생성 → 이 파일들 push
- 시크릿 등록: 레포 Settings → Secrets and variables → Actions →
DATA_GO_KR_API_KEY 등록 (코드에는 절대 하드코딩 금지)
- 로컬 테스트:
.env.example을 .env로 복사, 키 입력 후
npm install && node src/index.js "업체명"
- 자동화: Actions 탭 → collect 워크플로우 → Run workflow에 업체명 입력
데모 사이트 (GitHub Pages)
API 키 없이 브라우저에서 리포트 UI를 검증할 수 있는 정적 데모가 저장소 루트(index.html + assets/)에 있습니다.
샘플 스냅샷 데이터로 4블록 리포트·A~D 신뢰도·크로스체크·리스크 플래그를 그대로 렌더링합니다.
배포 방법 — 앱이 루트에 있어 Settings → Pages 소스가 "GitHub Actions" 든 "Deploy from a branch (main / root)" 든 동일하게 서빙됩니다.
main에 push → 자동 배포- 배포 URL:
https://duckjin87-web.github.io/vendor-scout/
로컬 미리보기
npx http-server . -p 8099 # → http://127.0.0.1:8099
식약처 실데이터 모드 (선택) — 사이트 우측 상단 🔌 실데이터 연결
정적 사이트는 CORS·키노출·http 때문에 data.go.kr을 직접 못 부릅니다. 무료 프록시(Cloudflare Worker)를
하나 띄우면 식약처 기능성화장품 보고품목을 실시간 조회해 리포트로 렌더링합니다. 미연결 시 데모(자동 생성) 모드.
→ 배포·연결법: proxy/README.md
재무·법인 등 식약처 범위 밖 항목은 data_gap(금융위/관세청 API 추가 연동 필요)으로 표기됩니다.
배치 수집·스냅샷 저장은 collect.yml(Actions + API 키)로 실행합니다.
스냅샷 규칙
- 조회 1회 = 파일 1개 (
data/snapshots/{vendorId}_v{n}.json)
- 기존 파일 수정 금지, 재조회 시 v+1로 신규 생성
- diff는 리포트 생성 시 직전 버전과 자동 비교
