CLI

Node 18 이상이면 설치 없이 npx send.ad 로 써요. 설정은 ~/.sendad/config.json, 환경변수 SEND_API_KEY · SEND_BASE_URL 이 우선해요. 모든 명령에 --json 을 붙이면 기계가 읽기 좋은 출력이 나와요.

명령설명
sendad login [--key K] [--base URL]API 키 저장(없으면 프롬프트)
sendad whoami워크스페이스·역할·잔액
sendad balance잔액·통당 단가·남은 통 수
sendad lists list | create <name>리스트
sendad contacts list [--list L] [--q 검색] · add <email> [--first-name] [--list L] [--tag T]연락처
sendad contacts import <file.csv> --list <name|id>CSV 가져오기(Mailchimp 형식 인식)
sendad templates list템플릿 목록
sendad campaigns list | status <id> | report <id>캠페인 조회
sendad campaigns create --name N --subject S --list L (--design file.json | --html file.html)초안 만들기
sendad campaigns send <id> [--at ISO]발송/예약
sendad send --to a@b.com --subject S (--html H | --text T | --html-file f)단건 발송
sendad ai "<brief>" [--list L] [--tone T] [--send | --at ISO]브리프 → 캠페인(+발송). --send는 완료까지 상태를 찍어요
sendad approvals · approve <id> [--at ISO] · reject <id> [--note]승인 대기 목록 · 승인(즉시/예약 발송) · 거절(초안으로)
sendad autopilot mode [manual|approve|auto]자율주행 모드 보기/바꾸기
sendad autopilot list | create --name N --brief "템플릿" [--cadence weekly --dow 2 --hour 10] [--list L] [--rss URL] | run <id> | pause <id> | resume <id>주기 실행 플랜(브리프 템플릿 {{date}} {{recent_posts}} {{products}} {{free_text}})
sendad learning학습 메모 — 성과에서 배운 것 · 좋은 발송 시각
sendad domains list | add <domain> | verify <id>발신 도메인
sendad mcpMCP 서버(stdio) 실행
npx send.ad login --key sd_live_…\nnpx send.ad contacts import ./subscribers.csv --list 고객\nnpx send.ad ai "추석 선물세트 20% 할인, 9/25까지" --list 고객      # → 승인 대기 + 승인 링크\nnpx send.ad approvals && npx send.ad approve <id>                       # 승인 → 발송\nnpx send.ad autopilot create --name 주간뉴스 --brief "{{date}} 이번 주 소식: {{recent_posts}}" --cadence weekly --dow 2 --hour 10 --list 고객 --rss https://blog.example/rss\nnpx send.ad learning                                                  # 성과에서 배운 것\nnpx send.ad campaigns report <id> --json

sendad ai … --send 는 워크스페이스 모드가 approve 면 승인 대기로 멈추고 승인 링크를 알려 줘요(exit 0). auto 면 가드레일을 통과할 때 바로 발송, manual 이면 초안(--send 시 발송). --wait 는 발송 완료까지 상태를 찍어요.