daily-sales-digest

고객사용 일일 매출 요약 스킬. 네이버 스마트스토어, 쿠팡, 배민셀러, POS 연동하여 매출 데이터를 수집하고, 일일/주간/월간 요약 리포트를 자동 생성. Discord/카톡/이메일로 배달.

Install

openclaw skills install @mupengi-bot/daily-sales-digest

daily-sales-digest

고객사용 일일 매출 요약 및 분석 스킬입니다.

기능

매출 데이터 수집 — 네이버 스마트스토어 API, 쿠팡 Wing API, 배민셀러 API, POS 시스템 연동
일일 요약 — 매일 아침 8시 전일 매출 한 줄 요약 (총매출, 주문수, 객단가)
비교 분석 — 전일 대비, 전주 동요일 대비, 전월 대비 변화율 자동 계산
이상 탐지 — 매출 급증/급감 시 즉시 알림 (임계값: ±30%)
주간/월간 리포트 — 자동 생성 및 트렌드 분석
채널 배달 — 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 형식으로 저장:

text

~/.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

출력 형식

텍스트 (기본)

text

📊 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%)을 초과하는 매출 변화 감지 시 즉시 알림:

text

🚨 매출 이상 감지!

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

향후 개선 계획

참고

네이버 커머스 API 문서: https://developer.naver.com/docs/commerce/commerce-api/commerce-api.md
쿠팡 Wing API: https://wing-developers.coupang.com/
배민셀러 API: (별도 제공)

daily-sales-digest

Install

daily-sales-digest

기능

빠른 시작

1. 설정 파일 생성

2. 수동 실행

어제 매출 요약

특정 날짜 매출

주간 리포트

월간 리포트

3. 자동 스케줄링 (OpenClaw cron)

4. 이상 탐지 알림

데이터 수집

수동 데이터 수집

출력 형식

텍스트 (기본)

JSON

Markdown (리포트용)

이상 탐지 알림

보안 및 데이터 관리

의존성

트러블슈팅

API 연결 실패

데이터 누락

스케줄 확인

향후 개선 계획

참고

Related skills