# CLI 레퍼런스 (@saeroon/cli) > 이 파일은 코드에서 자동 생성됩니다. **직접 편집하지 마세요.** > 재생성: `cd hosting-web && npx tsx scripts/gen-docs.ts` > 진실 = `packages/cli/src/index.ts` 커맨드 등록부. 운영자 전용 내부 커맨드는 제외됩니다. 설치·인증 후 `saeroon ` 형태로 사용합니다. 각 커맨드의 전체 옵션·기본값은 `saeroon --help` 가 단일 진실입니다. ```bash npx @saeroon/cli login npx @saeroon/cli init npx @saeroon/cli deploy ./site ``` ## 핵심 커맨드 | 커맨드 | 설명 | 옵션 | |---|---|---| | `saeroon login` | API 키 설정 | — | | `saeroon whoami` | 현재 인증 상태 확인 | — | | `saeroon init` | 프로젝트 초기화 — 정적 트랙(index.html + 포인터형 CLAUDE.md/.cursorrules). | — | | `saeroon analyze ` | 레퍼런스 URL 분석 (스크린샷 4장 + DOM/CSS 추출 + 비디오 감지 + 인터랙션 감지) | `--output-dir` 분석 결과 출력 디렉토리
`--timeout` 페이지 로드 타임아웃 (ms)
`--industry` 업종 (cafe, restaurant, salon, law 등 — 비디오 검색 키워드에 사용) | | `saeroon compare` | 레퍼런스 ↔ 프리뷰 시각 비교 (Playwright 스크린샷) | `--ref` 레퍼런스 URL
`--preview` 프리뷰 URL
`--output` 출력 파일 경로 (단일 뷰포트)
`--output-dir` 출력 디렉토리 (멀티 뷰포트)
`--width` 뷰포트 너비 (단일 모드)
`--height` 뷰포트 높이 (단일 모드)
`--viewports` 비교 뷰포트: all \| mobile,tablet,laptop,desktop | | `saeroon verify ` | 프리뷰 URL의 템플릿 렌더 검증 (render/behavior/visibility/seo/assets/content/tokens 7 카테고리). V3 default (D-V3UI-7 B), --schema-format v2 legacy alias. | `--viewport` 뷰포트 (예: 1280x800)
`--output` JSON 리포트 단일 파일 출력 경로
`--output-dir` 리포트 디렉토리 (기본: .saeroon/verify/<timestamp>/). --format과 함께 사용
`--format` 출력 포맷 (콤마 구분): json, junit, html. 지정 시 --output-dir에 저장 (기본 .saeroon/verify/<timestamp>/)
`--schema-format` 스키마 형식: v3 (default, auto-detect) \| v2 (legacy 강제)
`--timeout` 네비게이션 타임아웃 (ms)
`--wait-until` domcontentloaded \| load \| networkidle
`--json` JSON만 stdout으로 출력 (스피너/요약 비활성)
`--verbose` 진행 로그를 stderr로 출력
`--allow-host` 추가 허용 호스트 (예: staging.example.com 또는 *.example.com). 여러 번 지정 가능
`--allow-insecure` http:// 허용 (기본은 https만, 로컬 개발 전용)
`--fail-level` 이 심각도 이상 감지 시 exit 1: error \| warn \| info
`--page` 검증할 페이지 경로 (여러 번 지정 가능). 미지정 시 URL의 경로 사용
`--all-pages` 스키마의 모든 페이지 순회 검증 (C2)
`--audit` V3 Standards Audit 5 차원 실행 (HTML5/CSS-trends/Web-Vitals/WCAG/structured-data, ~30-60s/site, D-AUD-1)
`--audit-categories` audit 차원 부분집합 (CSV: html-spec,css-modern,web-vitals,wcag,structured-data)
`--no-responsive` V3-Schema-Guardrails L4 — responsive 카테고리 비활성 (default ON, mobile/tablet/desktop multi-viewport scrollWidth + grid stretching + hero overflow + section empty area)
`--responsive-viewports` responsive viewports CSV (예: mobile:375x812,tablet:768x1024,desktop:1440x900) | | `saeroon upload ` | 이미지를 Saeroon CDN에 업로드 | `--replace-in` 업로드 후 파일 내 로컬 경로를 CDN URL로 교체
`--site-id` 사이트 ID
`--api-key` API Key | | `saeroon deploy [input]` | 사이트 배포. input 미지정 = saeroon.config.json + schema.json. input = .json = schema. input = folder + index.html = static (Static Hosting Track M1). | `--api-key` API Key
`--target` 배포 대상: staging\|production (schema 경로 only)
`--dry-run` 실제 업로드/배포 없이 에셋 리포트만 출력
`--sync-template` Production 배포 후 마켓플레이스 템플릿 버전 자동 동기화 (schema 경로 only)
`--format` 스키마 형식: v3 (default, auto-detect) \| v2 (legacy 강제)
`--site-id` Static 배포 시 기존 사이트 update (미지정 시 신규 사이트 prompt)
`--slug` Static 신규 사이트 생성 시 slug 명시 (비대화형 배포의 권장 경로 — 미지정 시 폴더 이름이 slug 가 된다)
`--name` Static 신규 사이트 생성 시 표시 이름 명시 (미지정 시 폴더 이름)
`--yes` Static 배포 시 사이트 이름/slug prompt skip (auto default 값)
`--pk` publishable key (pk_live_*) — data-pk 로 inject (정적 사이트 회원/게시판 SDK 테넌트 해석)
`--allow-no-turnstile` 폼 스팸차단 위젯을 주입하지 않고 배포 (기본 = 항상 주입. 위젯 없이 = 제출 영구 차단 깨진 폼이므로 실서비스 비권장)
`--site-type` 서빙 모드 강제: static\|spa (미지정 시 _redirects 루트 캐치올 `/* → /index.html 200` 자동 추론, 없으면 static). Static 배포 전용.
`--auto-annotate` 편집 후보를 자동 감지해 **업로드본에만** 4속성 선언 (소스 파일 무수정 → 배포마다 재계산. 영구 선언은 content init 권장). Static 배포 전용.
`--no-content` 콘텐츠 편집 단계 전체 건너뛰기 (선언 수확·프로비저닝 안 함). Static 배포 전용.
`--content-user-id` 콘텐츠 프로비저닝 감사 주체 userId (기본 = 사이트 소유자). Static 배포 전용.
`--content-plan` AI 결정 문서 (시맨틱 field 명·text→rich 승격·크롬 제외). --auto-annotate 와 함께 쓰면 배포마다 같은 키가 나온다. Static 배포 전용. | | `saeroon publish [schema-path]` | [deprecated] 마켓플레이스에 템플릿 등록 → saeroon template register 사용 _(deprecated)_ | `--api-key` API Key | | `saeroon diff` | Staging vs Production 스키마 비교 | `--api-key` API Key | ## 그룹 커맨드 ### 사이트 (site) | 커맨드 | 설명 | 옵션 | |---|---|---| | `saeroon site list` | 내 사이트 전수 조회 (보관된 사이트 포함). 계정에 남은 적재물 확인 경로. | `--status` 상태 필터: draft \| published \| publishing \| archived
`--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon site publish ` | 사이트 발행 (Draft → Published). 정적 사이트 첫 발행 경로. slug 또는 siteId(GUID) 허용. | `--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon site archive ` | 사이트 보관 (→ Archived). 서빙 410 Gone. 되돌릴 수 있다. slug 또는 siteId(GUID) 허용. | `--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon site restore ` | 보관 사이트 복구 (Archived → Draft). 보관 유지 기간 경과 후에는 불가. | `--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon site delete ` | 사이트 영구 삭제 (되돌릴 수 없음). 보관(Archived) 상태만 허용 — 활성 사이트는 먼저 site archive. | `--yes` 영구 삭제 확인 (필수)
`--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | ### 기능 연결 (feature) | 커맨드 | 설명 | 옵션 | |---|---|---| | `saeroon feature attach ` | 정적 사이트에 feature 활성화 (현재 지원: form · booking. collection = 로드맵. booking 서비스 정의는 booking apply) | `--site` 대상 사이트 ID (cli deploy 응답에 담긴 siteId)
`--schema` Form schema 정의 JSON 파일 (FieldsJson) — optional
`--settings` Form 설정 JSON 파일 (SettingsJson, notification + submit action) — optional
`--name` Form 이름 (default = schema 파일 basename)
`--slug` Form slug (default = sanitized schema basename, 사이트 안 unique)
`--api-key` API Key | ### 마켓플레이스 템플릿 (template) | 커맨드 | 설명 | 옵션 | |---|---|---| | `saeroon template register` | 소유 사이트를 마켓플레이스 템플릿으로 등록. --static = 정적 자산 배포 등록 (manifest 자동추출 + board fallback) | `--api-key` API Key
`--name` 템플릿 이름
`--category` 마켓 카테고리 — corporate\|healthcare\|portfolio\|shop\|restaurant\|booking\|blog\|landing\|creative (미지정 시 대화형 선택. 없으면 카테고리 필터에 안 잡힘)
`--auto-approve` 플랫폼 운영자 자동 승인+발행 (Creator.IsPlatformOwner=true 또는 Admin role 의무)
`--static` 정적 자산 배포 템플릿으로 등록 — FeatureManifest 자동추출 + board fallback (Static Hosting Track)
`--site` 소스 사이트 ID (--static, 미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon template sync` | 소스 사이트 스키마를 템플릿에 동기화 + 새 버전 발행 | `--api-key` API Key
`--force` 변경 확인 없이 즉시 동기화
`--json` JSON 형식으로 출력 | | `saeroon template status` | 내 템플릿 목록 및 상태 조회 | `--api-key` API Key
`--json` JSON 형식으로 출력 | | `saeroon template update` | 템플릿 메타데이터 수정 | `--api-key` API Key
`--name` 템플릿 이름
`--description` 설명
`--category` 카테고리
`--tags` 태그 (콤마 구분)
`--price-krw` 가격 KRW
`--json` JSON 형식으로 출력 | ### 게시판 템플릿 (board) | 커맨드 | 설명 | 옵션 | |---|---|---| | `saeroon board create` | 사이트에 게시판 직접 생성 (API 키 sk_live_ — 멱등: 동일 슬러그 존재 시 회수) | `--name` **(필수)** 게시판 이름
`--slug` **(필수)** 게시판 슬러그 (소문자·숫자·하이픈·밑줄)
`--type` 게시판 유형 general\|notice\|gallery
`--write-mode` 작성 권한 open\|operatorOnly
`--allow-anonymous` 익명 작성 허용 (기본 false)
`--description` 게시판 설명
`--min-level-to-read` 읽기 최소 레벨
`--min-level-to-write` 작성 최소 레벨
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon board list` | 사용 가능한 board template 목록 조회 (System 시드 + User export) | `--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon board apply ` | 사이트에 board template 적용 (멱등 — 이미 존재 시 재사용) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon board export` | 소스 사이트 board → 신규 BoardTemplate 로 export (registry 보강) | `--board` **(필수)** 소스 board ID
`--site` 소스 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--slug` BoardTemplate slug (미지정 시 backend 가 소스 board slug 사용)
`--name` BoardTemplate 이름 (미지정 시 소스 board 이름)
`--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | ### 예약 (booking) | 커맨드 | 설명 | 옵션 | |---|---|---| | `saeroon booking list` | 사이트 예약 서비스 정의 조회 (코어+결제 오버레이 병합) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon booking apply ` | 매니페스트(JSON)로 예약 서비스 선언적 재조정 (멱등 — key 자연키 upsert, 부재분 비활성) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--allow-empty` 빈 매니페스트(전체 비활성) 허용 — 파괴적 연산 명시 승인
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon booking export` | 사이트 예약 정의 → 재적용 가능 매니페스트 JSON (-o 미지정 시 stdout) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`-o,` 출력 파일 경로 (미지정 시 stdout 으로 순수 JSON)
`--json` JSON 형식으로 출력 (파일 저장 시 요약 JSON, exit code 0/1) | ### 회원 tier 쿠폰 (coupon) | 커맨드 | 설명 | 옵션 | |---|---|---| | `saeroon coupon create` | 회원 tier 쿠폰 발급 (--code = 단일·멱등 / --count = 대량). 영구 부여, 서버 단일사용·회수 | `--tier` **(필수)** 부여 등급 Bronze\|Silver\|Gold\|Platinum (정확한 대소문자)
`--count` 대량 생성 개수 1~1000 (서버 생성 코드)
`--code` 단일 쿠폰 코드 (미지정 시 서버 생성; 지정 시 멱등)
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon coupon list` | 사이트 쿠폰 목록 조회 (tier / status 선택 필터) | `--tier` 등급 필터
`--status` 상태 필터 active\|used\|revoked
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon coupon revoke ` | 쿠폰 회수 (미사용만, 멱등). 사용된 쿠폰은 회수 불가 | `--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon coupon usage ` | 단일 쿠폰 사용내역 (누가 언제 redeem 했는지 + 상태) | `--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | ### 카탈로그 (catalog) | 커맨드 | 설명 | 옵션 | |---|---|---| | `saeroon catalog list` | 사이트 카탈로그 목록 조회 (보관 포함) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon catalog apply ` | 매니페스트(JSON)로 카탈로그 정의 선언적 재조정 (멱등 — key 자연키 upsert, 부재분 무접촉) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--prune` 매니페스트에 없는 카탈로그를 보관 — 파괴적 연산 명시 승인 (기본은 무접촉)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon catalog export` | 사이트 카탈로그 정의 → 재적용 가능 매니페스트 JSON (-o 미지정 시 stdout, 보관분 제외) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`-o,` 출력 파일 경로 (미지정 시 stdout 으로 순수 JSON)
`--json` JSON 형식으로 출력 (파일 저장 시 요약 JSON, exit code 0/1) | | `saeroon catalog archive ` | 카탈로그 보관 — 공개 목록에서 숨김. 항목과 그 ID 는 그대로 남는다 | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon catalog unarchive ` | 카탈로그 보관 해제 | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon catalog items ` | 카탈로그 항목 목록 조회 (은퇴 포함). --manifest 시 재적용 가능 import 매니페스트로 출력 | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--manifest` catalog import 로 되먹일 수 있는 매니페스트 형태로 출력 (은퇴 항목 제외)
`-o,` --manifest 사용 시 출력 파일 경로 (미지정 시 stdout)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon catalog import ` | 매니페스트(JSON)로 항목 일괄 등록 (멱등 — name 자연키 upsert, 부재분 무접촉) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--prune` 매니페스트에 없는 활성 항목을 은퇴 — 파괴적 연산 명시 승인 (기본은 무접촉)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon catalog retire ` | 항목 은퇴 (soft-delete — 목록에서 숨기되 참조는 보존) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon catalog restore ` | 항목 은퇴 해제 (복원) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | ### 그룹 정책 (group) | 커맨드 | 설명 | 옵션 | |---|---|---| | `saeroon group list` | 사이트 그룹 정책 목록 조회 (보관 포함) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon group get ` | 그룹 정책 단건 조회 — 운영 규칙 + 직위 정의 + 속성 스키마 | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon group apply ` | 매니페스트(JSON)로 그룹 정책·직위 선언적 재조정 (멱등 — key/roleKey 자연키 upsert, 부재분 무접촉) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--prune` 매니페스트에 없는 정책을 보관하고 직위를 삭제 — 파괴적 연산 명시 승인 (기본은 무접촉)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon group export` | 사이트 그룹 정책 → 재적용 가능 매니페스트 JSON (-o 미지정 시 stdout, 보관분 제외) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`-o,` 출력 파일 경로 (미지정 시 stdout 으로 순수 JSON)
`--json` JSON 형식으로 출력 (파일 저장 시 요약 JSON, exit code 0/1) | | `saeroon group archive ` | 그룹 정책 보관 — 신규 그룹 개설만 막힌다. 기존 그룹은 계속 돈다 | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon group unarchive ` | 그룹 정책 보관 해제 | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon group role-delete ` | 직위 정의 삭제. 그 직위를 보유한 활성 그룹원이 있으면 409 로 거절된다 | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | ### 콘텐츠 인라인 편집 (content) | 커맨드 | 설명 | 옵션 | |---|---|---| | `saeroon content propose ` | 편집 후보를 스캔해 **AI 판독용 제안 문서**(JSON) 출력. 파일 수정·네트워크 0 — AI 가 시맨틱 이름·rich 승격·제외를 결정해 content init --plan 으로 되돌린다 | `--site` 문서에 기록할 사이트 ID (선택 — 제안은 로컬 스캔이라 로그인 불요)
`-o,` 결과를 파일로 저장 (생략 시 stdout)
`--no-images` 이미지(img) 후보 제외 — 텍스트만 제안
`--interactive-text` 링크·버튼 텍스트도 후보에 포함 (기본 제외 — 오탐 완화) | | `saeroon content init ` | 정적 폴더의 편집 후보를 스캔·제안 → 확인 후 4속성 선언(HTML 수정) + 현재 값으로 필드 프로비저닝. 재실행 멱등 | `--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--plan` AI 결정 문서 적용 (시맨틱 field 명·text→rich 승격·크롬 제외). 검증 실패 시 아무것도 수정하지 않고 중단
`--dry-run` 제안만 출력 — HTML 수정·프로비저닝 안 함
`--yes` 확인 프롬프트 건너뛰기 (명시 승인)
`--reseed` 저장된 값을 HTML 현재 값으로 되돌림 (기본은 저장값 유지 = 라이브 편집 보존)
`--no-images` 이미지(img) 후보 제외 — 텍스트만 선언
`--interactive-text` 링크·버튼 텍스트도 후보에 포함 (기본 제외 — 오탐 완화)
`--user-id` 감사 주체 userId (기본 = 사이트 소유자)
`--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon content attach ` | 이미 HTML 에 박힌 data-saeroon-editable 4속성만 수확해 프로비저닝 (파일 무수정 — 수작업 선언 납품용) | `--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--dry-run` 수확 결과만 출력 — 프로비저닝 안 함
`--yes` 확인 프롬프트 건너뛰기 (명시 승인)
`--reseed` 저장된 값을 HTML 현재 값으로 되돌림 (기본은 저장값 유지)
`--user-id` 감사 주체 userId (기본 = 사이트 소유자)
`--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon content resolve` | (ct, pageKey, field) → 엔트리 recordId 해석. MCP/REST 로 편집값을 직접 다루기 전 주소를 찾는 헬퍼 | `--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--ct` ContentType — page \| site
`--page` pageKey 로 필터 (예: index · about · __global)
`--field` field 로 필터 + 현재 값 표시
`--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | ### 커스텀 도메인 (domain) | 커맨드 | 설명 | 옵션 | |---|---|---| | `saeroon domain connect ` | 구매/이전 도메인을 사이트에 연결 (Cloudflare zone 생성 + 네임서버 위임 자동) | `--api-key` API Key
`--site` 대상 사이트 ID (미지정 시 saeroon.config.json 의 siteId)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon domain connect-external ` | 직접 보유 도메인(BYO) 추가 + 전용 Cloudflare zone 생성 → 네임서버 발급 (operator 로그인 필요) | `--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon domain verify ` | 직접 보유 도메인(BYO) 검증/활성화 — zone active 시 검증 + 무료 SSL (operator 로그인 필요) | `--api-key` API Key
`--watch` NS/TXT 전파를 폴링하며 활성화될 때까지 대기 (활성화 exit 0 / 타임아웃 exit 1)
`--interval` --watch 폴링 간격 (초)
`--timeout` --watch 최대 대기 (분)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon domain list` | 내 구매/이전 도메인 목록 (또는 --site 지정 시 해당 사이트 연결 도메인) | `--api-key` API Key
`--site` 특정 사이트 연결 도메인만 조회 (미지정 시 saeroon.config.json → 전체 구매 도메인)
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | | `saeroon domain status ` | 도메인 상세 + DNS 설정 정보 조회 (검증/SSL/zone/네임서버) | `--api-key` API Key
`--json` JSON 형식으로 출력 (stdout = 순수 JSON, exit code 0/1) | _옵션 상세는 `saeroon --help` 참조._