직구각

해외직구 최종 체감가(상품가 + 국제 배송비 + 관부가세)를 국내 최저가와 비교해 직구할 각인지 판정해 주는 사이트입니다.

페이지

주소	내용
/	홈 · 오늘의 직구각, 카테고리·판정 필터, 검색
/p/상품주소	판정 상세 · 체감가 영수증, 면세 신호등, 리스크, 구매 버튼
/search?q=검색어	검색 · 판정한 상품 + 네이버쇼핑 실시간 국내 최저가, 해외 가격 넣고 바로 판정
/calculator	관세 계산기
/calendar	세일 캘린더 (구글 캘린더 추가, .ics 구독)
/guide	직구 가이드 · 영문 주소, 통관부호, 면세 한도, 합산과세
/disclosure, /privacy	광고·제휴 고지, 개인정보처리방침

내용 고치는 곳 (코딩 없이)

모든 내용은 data 폴더의 파일 3개에서 바뀝니다. GitHub 웹에서 파일을 열고 연필 아이콘으로 고친 뒤 저장(Commit)하면 Vercel이 1~2분 안에 사이트를 다시 만듭니다.

data/products.json · 상품

{
  "slug": "multivitamin-120",        // 주소에 쓰일 영문 이름 (/p/multivitamin-120)
  "name": "종합비타민 120정",
  "store": "iherb",                  // iherb · amazon · aliexpress · coupang
  "category": "supplement",          // it · home · apparel · supplement · book
  "origin": "us",                    // us(미국) · other(그 외)
  "method": "express",               // express(특송·직배송) · post(우편)
  "priceUsd": 22.40,                 // 해외 가격(달러). 아마존은 null로 두기
  "shipUsd": 3.90,                   // 국제 배송비(달러)
  "domesticKrw": 54900,              // 국내 최저가(원)
  "domesticSource": "네이버쇼핑 최저가",
  "domesticStore": "쿠팡",           // 국내 구매 버튼에 표시할 쇼핑몰 이름
  "domesticUrl": "",                 // 국내 제휴 링크(쿠팡 파트너스 단축 링크 등)
  "buyUrl": "",                      // 해외 제휴 링크. 둘 다 비어 있으면 '구매 링크 준비 중'
  "domesticCheckUrl": "",            // 가격 확인용 일반 쿠팡 주소 (제휴 링크 아님, 자기 클릭 방지)
  "overseasCheckUrl": "",            // 가격 확인용 일반 해외 상품 주소 (아마존은 비움)
  "sample": true,                    // 실제 가격으로 바꾸면 false
  "risks": ["목록통관 배제 품목"],
  "summary": ["직구 전에 알아둘 3줄"]   // {be}는 달러 손익분기, {beKrw}는 원화 손익분기로 자동 계산돼요
}

판정이 국내가 나음이면 국내 구매 버튼이 위(빨간 버튼)에, 아니면 해외 구매 버튼이 위에 나옵니다.

아마존 상품은 priceUsd를 null로 두세요. 아마존 규정상 가격은 API(Creators API) 승인 전까지 직접 적을 수 없어서, 사이트는 국내 최저가로 계산한 손익분기 가격만 보여 주고 방문자가 아마존 가격을 직접 넣어 판정하게 합니다.

data/settings.json · 사이트 설정

• fx.usdKrw, fx.label: 관세청 과세환율. DATA_GO_KR_KEY가 있으면 빌드 때 자동으로 받아요. 없거나 실패할 때 쓰는 기본값이에요.
• rule: 직구각 판정 기준 (기본: 20% 이상, 10,000원 이상 저렴)
• contactEmail, operator: 문의 메일과 운영자 이름 (지금은 [ ] 빈칸)
• ga4Id: 구글 애널리틱스 측정 ID (G-로 시작)
• affiliatePending: 아직 승인 대기 중인 제휴(예: ["iherb"]). 승인되면 지우세요 — 광고 고지 문구가 자동으로 바뀌어요.
• googleVerification, naverVerification: 서치 콘솔·서치어드바이저 소유 확인 코드

data/events.json · 세일 캘린더

행사 이름, 날짜(YYYY-MM-DD), 쇼핑몰, 한 줄 안내. settings.json의 featuredEvent에 적힌 행사가 홈 배너에 나옵니다.

실시간 검색 켜기 (네이버 검색 API)

api/search.js가 네이버쇼핑 검색 API로 국내 최저가를 가져옵니다. 키는 Vercel → 프로젝트 → Settings → Environment Variables에만 넣으세요 (저장소·채팅에 적지 않기).

• NAVER_CLIENT_ID
• NAVER_CLIENT_SECRET

넣은 뒤 다시 배포(Redeploy)하면 켜집니다. 키가 없으면 검색 화면은 '곧 열려요' 안내를 보여 줍니다.

환율 자동 반영 (Vercel 환경 변수)

관세·면세 판단은 관세청 과세환율(주간), 달러로 결제하는 금액은 매매기준율(영업일마다)로 계산해요. 키가 없으면 data/settings.json의 fx(과세환율)와 payFx(결제 환율, 없으면 과세환율과 같게) 값을 써요.

변수	하는 일	받는 곳
KOREAEXIM_KEY	결제 환율(매매기준율) 자동	한국수출입은행 환율 API 인증키
DATA_GO_KR_KEY	과세환율 자동	공공데이터포털 일반 인증키(관세청_관세환율정보(GW) 활용신청, 자동승인)
VERCEL_DEPLOY_HOOK	매일 다시 만들기	Vercel → Settings → Git → Deploy Hooks
CRON_SECRET	다시 만들기 요청 보호	아무 긴 문자열

매일 11:30(한국 시간)에 Vercel Cron이 /api/rebuild를 불러 사이트를 다시 만들고, 그때 최신 환율을 받아와요.

내 컴퓨터에서 미리 보기 (선택)

Node.js 18 이상이 있으면:

npm test        # 관세 계산 규칙 점검
npm run preview # http://localhost:4173

배포

Vercel에서 이 저장소를 가져오면 vercel.json 설정대로 npm run build 후 dist 폴더가 배포됩니다. 추가 패키지는 없습니다.