--- name: daily-sales-digest description: 고객사용 일일 매출 요약 스킬. 네이버 스마트스토어, 쿠팡, 배민셀러, POS 연동하여 매출 데이터를 수집하고, 일일/주간/월간 요약 리포트를 자동 생성. Discord/카톡/이메일로 배달. metadata: { "openclaw": { "emoji": "💰", "requires": { "bins": ["node"] }, }, } --- # daily-sales-digest 고객사용 일일 매출 요약 및 분석 스킬입니다. ## 기능 1. **매출 데이터 수집** — 네이버 스마트스토어 API, 쿠팡 Wing API, 배민셀러 API, POS 시스템 연동 2. **일일 요약** — 매일 아침 8시 전일 매출 한 줄 요약 (총매출, 주문수, 객단가) 3. **비교 분석** — 전일 대비, 전주 동요일 대비, 전월 대비 변화율 자동 계산 4. **이상 탐지** — 매출 급증/급감 시 즉시 알림 (임계값: ±30%) 5. **주간/월간 리포트** — 자동 생성 및 트렌드 분석 6. **채널 배달** — Discord/카톡/이메일로 요약 전송 ## 빠른 시작 ### 1. 설정 파일 생성 ```bash cp {baseDir}/config.template.json ~/.openclaw/workspace/config/daily-sales-digest.json ``` `~/.openclaw/workspace/config/daily-sales-digest.json` 파일을 편집하여 API 키와 채널 설정: ```json { "sources": { "naver": { "enabled": true, "clientId": "YOUR_CLIENT_ID", "clientSecret": "YOUR_CLIENT_SECRET" }, "coupang": { "enabled": false, "accessKey": "YOUR_ACCESS_KEY", "secretKey": "YOUR_SECRET_KEY" }, "baemin": { "enabled": false, "apiKey": "YOUR_API_KEY" }, "pos": { "enabled": false, "type": "custom", "endpoint": "http://localhost:3000/api/sales" } }, "alerts": { "threshold": 0.3, "channels": ["discord"] }, "delivery": { "discord": { "channelId": "1234567890" }, "email": { "to": "admin@example.com" } }, "schedule": { "daily": "0 8 * * *", "weekly": "0 9 * * 1", "monthly": "0 9 1 * *" } } ``` ### 2. 수동 실행 #### 어제 매출 요약 ```bash node {baseDir}/scripts/digest.js --date yesterday --format text ``` #### 특정 날짜 매출 ```bash node {baseDir}/scripts/digest.js --date 2026-02-17 --format json ``` #### 주간 리포트 ```bash node {baseDir}/scripts/digest.js --period week --format text ``` #### 월간 리포트 ```bash node {baseDir}/scripts/digest.js --period month --format markdown ``` ### 3. 자동 스케줄링 (OpenClaw cron) 매일 아침 8시 전일 매출 요약을 Discord로 자동 전송: ```bash openclaw cron add \ --name "daily-sales-digest:daily" \ --schedule "0 8 * * *" \ --command "node /Users/mupeng/.openclaw/workspace/skills/daily-sales-digest/scripts/digest.js --date yesterday --deliver discord" ``` 주간 리포트 (매주 월요일 오전 9시): ```bash openclaw cron add \ --name "daily-sales-digest:weekly" \ --schedule "0 9 * * 1" \ --command "node /Users/mupeng/.openclaw/workspace/skills/daily-sales-digest/scripts/digest.js --period week --deliver discord" ``` 월간 리포트 (매월 1일 오전 9시): ```bash openclaw cron add \ --name "daily-sales-digest:monthly" \ --schedule "0 9 1 * *" \ --command "node /Users/mupeng/.openclaw/workspace/skills/daily-sales-digest/scripts/digest.js --period month --deliver email,discord" ``` ### 4. 이상 탐지 알림 매출 급증/급감 감지 시 즉시 Discord 알림: ```bash node {baseDir}/scripts/alert.js --threshold 0.3 --deliver discord ``` ## 데이터 수집 데이터는 `~/.openclaw/workspace/data/sales/` 디렉토리에 JSON 형식으로 저장: ``` ~/.openclaw/workspace/data/sales/ ├── 2026-02-17.json ├── 2026-02-18.json └── ... ``` 각 파일 형식: ```json { "date": "2026-02-17", "sources": { "naver": { "revenue": 1250000, "orders": 45, "avgOrderValue": 27777 }, "coupang": { "revenue": 850000, "orders": 32, "avgOrderValue": 26562 } }, "total": { "revenue": 2100000, "orders": 77, "avgOrderValue": 27272 } } ``` ### 수동 데이터 수집 ```bash node {baseDir}/scripts/collect.js --date yesterday node {baseDir}/scripts/collect.js --date 2026-02-17 node {baseDir}/scripts/collect.js --date today --source naver ``` ## 출력 형식 ### 텍스트 (기본) ``` 📊 2026-02-17 매출 요약 💰 총 매출: ₩2,100,000 (↑ 15.2% vs 전일) 🛒 주문 수: 77건 (↑ 8.5% vs 전일) 💳 객단가: ₩27,272 (↑ 6.2% vs 전일) 📈 비교 분석: • 전일 대비: +15.2% (₩278,000) • 전주 동요일: +8.7% (₩168,000) • 전월 동일: +3.2% (₩65,000) 🏪 채널별: • 네이버: ₩1,250,000 (45건) • 쿠팡: ₩850,000 (32건) ``` ### JSON ```json { "date": "2026-02-17", "summary": { "revenue": 2100000, "orders": 77, "avgOrderValue": 27272 }, "comparison": { "vsYesterday": { "revenue": 0.152, "orders": 0.085, "avgOrderValue": 0.062 }, "vsLastWeek": { "revenue": 0.087, "orders": 0.045, "avgOrderValue": 0.039 }, "vsLastMonth": { "revenue": 0.032, "orders": 0.018, "avgOrderValue": 0.014 } }, "sources": { "naver": { "revenue": 1250000, "orders": 45 }, "coupang": { "revenue": 850000, "orders": 32 } } } ``` ### Markdown (리포트용) ```markdown # 주간 매출 리포트 (2026-02-10 ~ 2026-02-16) ## 요약 - **총 매출**: ₩14,500,000 - **평균 일매출**: ₩2,071,428 - **총 주문**: 523건 - **평균 객단가**: ₩27,725 ## 일별 추이 | 날짜 | 매출 | 주문 | 객단가 | |------|------|------|--------| | 02-10 | ₩1,890,000 | 68건 | ₩27,794 | | 02-11 | ₩2,150,000 | 78건 | ₩27,564 | | ... | ... | ... | ... | ## 주요 인사이트 - 화요일 매출이 가장 높음 (₩2,350,000) - 주말 주문수 감소 (-18%) - 객단가는 안정적 유지 (±5% 이내) ``` ## 이상 탐지 알림 임계값(기본 ±30%)을 초과하는 매출 변화 감지 시 즉시 알림: ``` 🚨 매출 이상 감지! 2026-02-17 매출이 전일 대비 45.3% 급증했습니다. 💰 오늘: ₩3,050,000 💰 어제: ₩2,100,000 📈 증가: +₩950,000 (+45.3%) 원인 분석이 필요합니다. ``` ## 보안 및 데이터 관리 - API 키는 반드시 `~/.openclaw/workspace/config/daily-sales-digest.json`에 저장 - 데이터 파일은 `.gitignore`에 추가 권장 - 민감한 정보는 절대 로그에 기록하지 않음 - 주기적으로 오래된 데이터 아카이빙 권장 (90일 이상) ## 의존성 - Node.js 18+ - OpenClaw gateway - (선택) Discord webhook 또는 message 스킬 - (선택) 이메일 발송 스킬 (himalaya 등) ## 트러블슈팅 ### API 연결 실패 ```bash # 설정 파일 확인 cat ~/.openclaw/workspace/config/daily-sales-digest.json # 네이버 API 테스트 curl -H "X-Naver-Client-Id: YOUR_ID" -H "X-Naver-Client-Secret: YOUR_SECRET" \ "https://api.commerce.naver.com/external/v1/pay-order/seller-product-order/list" ``` ### 데이터 누락 수동으로 누락된 날짜 데이터 수집: ```bash node {baseDir}/scripts/collect.js --date 2026-02-15 --force ``` ### 스케줄 확인 ```bash openclaw cron list | grep daily-sales openclaw cron runs daily-sales-digest:daily ``` ## 향후 개선 계획 - [ ] 카카오톡 알림 연동 - [ ] 대시보드 웹 UI (Canvas 활용) - [ ] 상품별 매출 분석 - [ ] 시간대별 매출 패턴 분석 - [ ] AI 기반 매출 예측 - [ ] Slack 연동 - [ ] Google Sheets 자동 업데이트 ## 참고 - 네이버 커머스 API 문서: https://developer.naver.com/docs/commerce/commerce-api/commerce-api.md - 쿠팡 Wing API: https://wing-developers.coupang.com/ - 배민셀러 API: (별도 제공)