사용 가이드 — 스마트스토어 매출 분석 자동화

Claude Code가 처음이라면

설치 방법 안내 — 이미 설치되어 있으면 넘어가세요

① Node.js 설치 확인

터미널node --version

v18.0.0 이상이면 OK. 없으면 nodejs.org에서 LTS 설치 후 재시도.

② Claude Code 설치

터미널npm install -g @anthropic-ai/claude-code

③ 로그인

터미널claude

처음 실행 시 브라우저에서 Anthropic 계정 로그인이 열립니다.

ZIP 압축 해제 & 주문 CSV 준비

스마트스토어에서 주문 데이터를 CSV로 내보내기

ZIP 압축 해제

smartstore-analytics-package.zip을 더블클릭하면 폴더가 생성됩니다.

smartstore-dashboard.html — 인터랙티브 매출 대시보드
smartstore-sample.csv — 샘플 주문 데이터 (컬럼 구조 참고용)
CLAUDE.md — Claude Code가 자동으로 읽는 프로젝트 가이드
prompts.txt — 마스터 설정 프롬프트 (3단계에서 사용)
send-alert.js — 카카오/슬랙 자동 발송 스크립트

스마트스토어 주문 CSV 내보내기

셀러센터 로그인 → 판매 관리 → 주문 관리 → 기간 설정 → 엑셀 다운로드

! 인코딩 주의: 스마트스토어 xlsx 파일을 그냥 사용하면 한글이 깨집니다.
반드시 엑셀에서 열어 다른 이름으로 저장 → CSV UTF-8 (쉼표로 분리)로 저장하세요.

컬럼 매핑 안내

대시보드가 자동 인식하는 컬럼과, 기능 활성화에 필요한 컬럼입니다:

기능	필요 컬럼	필수여부
기간 필터	주문일, date, 결제일	필수
베스트 상품 차트	상품명, product, 품명	필수
매출 KPI	결제금액, 실결제금액, 판매금액	필수
재구매율	구매자, 회원아이디, 주문자	선택
ROAS 분석	광고비, ad_cost	선택
재고 소진 예측	재고, 재고수량, stock	선택
카테고리 필터	카테고리, 상품분류, category	선택

! 광고비·재고 컬럼이 없어도 괜찮습니다. 기본 KPI + 베스트 상품 + 매출 추이는 주문일·상품명·결제금액만 있으면 작동합니다.

파일을 폴더 안에 복사

폴더 구조 예시smartstore-analytics-package/
├── smartstore-dashboard.html
├── smartstore-sample.csv       ← 샘플 (그대로 두세요)
├── CLAUDE.md
├── prompts.txt
├── send-alert.js
└── 2025년3월_주문내역.csv      ← 내 실제 주문 데이터

Claude Code에서 폴더 열기

폴더를 열면 CLAUDE.md를 읽고 스마트스토어 분석 모드로 준비됩니다

Antigravity 실행 → File → Open Folder → smartstore-analytics-package 폴더 선택

✓폴더를 열면 Claude Code가 CLAUDE.md를 읽고 이 프로젝트가 스마트스토어 매출 분석임을 인식합니다.

Cursor 실행 → File → Open Folder → smartstore-analytics-package 폴더 선택

터미널

cd ~/Downloads/smartstore-analytics-package
claude

prompts.txt 붙여넣기

전체 복사해서 채팅창에 한 번만 붙여넣으면 됩니다

prompts.txt 전체 복사

폴더 안의 prompts.txt 더블클릭 → 전체 선택(Cmd+A) → 복사(Cmd+C)

채팅창에 붙여넣기

에디터 왼쪽 Claude 아이콘 클릭 → 채팅창에 Cmd+V → 전송

ℹ 이것으로 끝입니다. Claude Code가 단계마다 확인을 요청하며 진행합니다.

Claude Code 자동 처리 순서

Claude Code 자동 처리

폴더 스캔 → 샘플 제외 → "이 파일이 내 주문 데이터 맞나요?" 확인 요청

CSV 컬럼 인식 → 날짜·상품명·결제금액 매핑 → 광고비·재고 컬럼 유무 확인

날짜 기간 범위 파악 → 기간 필터 자동 설정 · 카테고리 필터 생성

재고 소진 예측 기준 확인 (기본 7일 긴급) → 조정 원하면 입력 요청

(선택) 카카오/슬랙 Webhook URL 입력 → 자동 발송 스케줄 설정

✓ 각 단계에서 "맞아" 또는 "건너뛰기"만 하면 됩니다.

인코딩 문제가 발생하면

한글 상품명이 깨져 보이는 경우:

Claude Code에게 요청"CSV 파일이 EUC-KR인 것 같아, UTF-8로 변환해줘"

또는 직접 변환: 엑셀 → 다른 이름으로 저장 → CSV UTF-8 (쉼표로 분리)

광고비/재고 컬럼이 없을 때

주문 내보내기에 광고비나 재고 컬럼이 없으면 Claude Code에게:

대체 요청 예시"광고비 컬럼이 없어. ROAS 섹션 대신 주간 매출 추이 차트로 바꿔줘"
"재고 데이터가 없어. 소진 예측 섹션 대신 카테고리별 매출 비중으로 바꿔줘"

대시보드 확인 & 카카오 알림 설정

내 데이터로 완성된 대시보드 확인 + 선택으로 카카오 자동 발송

대시보드 열기

직접 열기smartstore-dashboard.html 더블클릭 → 브라우저에서 열림
CSV 업로드 버튼 → 내 주문 CSV 선택

✓ CSV를 업로드하면 총 매출 · 주문수 · 객단가 · 재구매율 · 베스트 상품이 내 데이터로 즉시 표시됩니다.

추가 요청 예시

Claude Code 채팅에서 바로 요청"베스트 상품을 수량 기준으로도 보고 싶어"
"재고 긴급 기준을 14일로 바꿔줘"
"객단가 목표선 35,000원으로 추가해줘"
"이번 주 vs 저번 주 비교 탭 추가해줘"
"PNG로 저장하는 버튼 추가해줘"

선택 기능 — 카카오 / 슬랙 자동 발송

send-alert.js 설정

send-alert.js를 텍스트 에디터로 열어 CONFIG 섹션을 수정하세요:

send-alert.js CONFIG 섹션

const CONFIG = {
  SLACK_WEBHOOK_URL: 'https://hooks.slack.com/services/XXX',
  SLACK_CHANNEL: '#smartstore',  // 발송할 채널
  CSV_FILE: './내주문내역.csv',   // 실제 파일명으로 교체
  DAYS: 7,                       // 최근 N일 기준
  STOCK_DANGER_DAYS: 7,          // 긴급 재고 기준 (일)
  STOCK_WARN_DAYS: 14,           // 주의 재고 기준 (일)
};

카카오 채널 알림 설정

카카오 비즈니스 채널 Webhook URL이 있다면:

Claude Code에게 요청"카카오 Webhook URL이 [URL]이야. 슬랙 대신 카카오로 발송하도록 바꿔줘"

발송 테스트

터미널node send-alert.js

✓ 주간 매출 요약 + 베스트 상품 + 재고 긴급 알림이 발송됩니다.
"매주 월요일 오전 8시에 자동 발송해줘"라고 요청하면 cron 설정까지 해줍니다.

스마트스토어 매출 분석 가이드

① Node.js 설치 확인

② Claude Code 설치

③ 로그인

ZIP 압축 해제

스마트스토어 주문 CSV 내보내기

컬럼 매핑 안내

파일을 폴더 안에 복사

prompts.txt 전체 복사

채팅창에 붙여넣기

Claude Code 자동 처리 순서

인코딩 문제가 발생하면

광고비/재고 컬럼이 없을 때

대시보드 열기

추가 요청 예시

send-alert.js 설정

카카오 채널 알림 설정

발송 테스트

막히는 부분이 있으신가요?