Wonda CLI – 터미널 기반 종합 콘텐츠 제작 및 소셜 미디어 자동화 도구

Wonda CLI

Wonda CLI는 터미널 기반 에이전트를 위한 콘텐츠 제작 도구 키트입니다. 이를 사용하여 이미지, 비디오, 음악, 오디오를 생성하고, 미디어를 편집 및 합성하고, 소셜 플랫폼에 게시하고, LinkedIn, Reddit, X/Twitter 전반에서 연구 및 자동화를 수행할 수 있습니다.

설치

wonda가 PATH에 없으면 먼저 설치하십시오:

# npm
npm i -g @degausai/wonda

# Homebrew
brew tap degausai/tap && brew install wonda

설정

• 인증: wonda auth login (브라우저 열림, 권장) 또는 WONDA_API_KEY 환경 변수 설정
• 확인: wonda auth check

OAuth 커넥터 인증

Claude 웹 및 Cowork 커넥터는 CLI API 키 필드 대신 Wonda의 OAuth 2.1 흐름을 사용합니다. 커넥터는 브라우저에서 Wonda를 통해 로그인하고, 요청된 계정 액세스 권한을 부여하며, Wonda API 리소스에 바인딩된 OAuth 토큰을 수신합니다. 서버는 해당 토큰을 계정의 내부 API 키로만 Wonda 내부에서 교환하므로, 에이전트와 커넥터 호스트는 sk_... 키를 절대 볼 수 없습니다. CLI 및 로컬 stdio MCP 경로의 경우 계속해서 wonda auth login 또는 WONDA_API_KEY를 사용하십시오.

Claude Cowork 로컬 릴레이

Claude Cowork(데스크톱 앱)은 호스트에서 로컬 MCP 서버를 실행하므로 .mcpb 번들 또는 로컬 stdio wonda-mcp 구성을 직접 로드할 수 있으며(WAB 쓰기 포함, 2026-07-07 확인), Claude 웹은 불가능합니다. Wonda 로컬 릴레이는 대체 경로입니다. 원격 커넥터(웹 또는 Cowork)가 로컬 MCP 구성 없이 사용자 자신의 Mac 및 residential IP에서 작업을 실행할 수 있게 합니다:

1. 로그인된 상태에서 https://wonda.sh/download를 열고 공증된 Mac 패키지를 설치합니다.
2. wonda relay pair 또는 첫 실행 브라우저 핸드오프를 사용하여 릴레이를 페어링합니다. 이는 macOS 키체인에 저장된 릴레이 범위 wrelay_... 자격 증명과 함께 기존 cli-auth 흐름을 사용합니다. 사용자에게 API 키 또는 장치 코드를 붙여넣도록 요청하지 마십시오.
3. https://wonda.sh/setup을 열고, 헤드풀 로컬 WAB를 통해 LinkedIn, X, Reddit을 연결한 다음 Claude에서 Wonda 커넥터를 승인합니다.

엔진 정책은 auto | my_machine | cloud입니다. auto는 릴레이가 온라인일 때 로컬 릴레이를 사용하고, 그렇지 않으면 클라우드를 사용합니다. my_machine은 자동으로 대체되어서는 안 됩니다. 릴레이가 오프라인이면 클라우드로 전환할지 물어보십시오.

조직 및 지출 컨텍스트

Wondercat 조직은 자체 시트와 결제가 있는 공유 지갑입니다. 구성원은 컨텍스트를 전환하여 조직 지갑에서 지출할 수 있습니다(개인 크레딧 대신):

• wonda organizations list (별칭: wonda orgs list, wonda org list) — 자신이 속한 모든 조직과 각 조직에서의 역할 및 시트 플랜을 확인합니다.
• wonda use --org <slug> — 이 머신에 대한 고정 조직 컨텍스트를 설정합니다. 모든 요청에 X-Wonda-Org를 설정하고, 청구, 차변, wonda balance는 조직 지갑을 통해 라우팅됩니다.
• wonda use --personal — 개인 컨텍스트로 돌아갑니다.
• wonda usage — 특정 기간에 대한 지출 전용 사용 요약(총계 + 모델별 + 프로젝트별 세분화)을 보여줍니다. (--month 2026-05 또는 --from/--to; 기본값은 현재 월, UTC). --project <name>은 보고서를 하나의 프로젝트로 제한합니다. 조직 컨텍스트에서는 회원별 세분화를 포함한 조직 전체 사용 보고서를 제공합니다(관리자/소유자 역할 필요). 관리자는 웹의 조직 페이지에서 전체 Excel 보고서를 다운로드할 수도 있습니다.

프로젝트(지출 태깅)

프로젝트는 모니터링을 위해 지출을 명명된 작업 스트림에 귀속시킵니다. 에이전트는 작업 시작 시 활성 프로젝트를 확인하고(wonda use가 출력), 운영자가 프로젝트별로 지출을 모니터링할 때 작업당 하나를 설정해야 합니다:

• wonda use --project <name> — 고정: 이후의 모든 청구에는 프로젝트가 포함됩니다(wonda usage, API, 조직 Excel 보고서에서). wonda use --no-project는 태깅을 중지합니다. 조직/개인 컨텍스트 전환은 프로젝트를 자동으로 지웁니다(프로젝트는 범위별로 지정됨).
• 모든 명령에 --project <name> — 해당 호출에 대한 일회성 재정의입니다.
• wonda project list|create|delete — 활성 범위에서 레지스트리를 관리합니다. 조직 프로젝트는 조직 관리자/소유자만 생성할 수 있으며, 개인 프로젝트는 셀프 서비스입니다. 존재하지 않는 이름에 대한 태깅은 unknown_project 오류와 함께 실패합니다(새 버킷이 자동 생성되지 않으므로 오타로 모니터링 데이터가 분할되지 않습니다).

wonda topup은 컨텍스트에 관계없이 항상 개인 지갑을 충전합니다. 조직 지갑 충전(및 자동 충전 구성)은 관리자 전용이며 웹의 /organizations/<slug>에서 수행됩니다. 구성원이 조직 크레딧을 소진하면 오류 메시지에 관리자에게 문의하거나 개인 지갑으로 전환하라고 안내합니다. CLI에서 조직 지갑을 충전할 수 없습니다.

조직 내 역할은 시트 플랜과 별개입니다:

• 소유자: 원래 생성자입니다. 강등되거나 추방될 수 없습니다. 조직 페이지에서 다른 구성원에게 소유권을 이전할 수 있습니다(드물게).
• 관리자: 초대(단일 또는 대량 붙여넣기), 추방, 역할 변경, 시트 변경, 충전, 자동 충전 구성, 월별 한도 변경이 가능합니다.
• 사용자: 조직 지갑 내에서만 지출할 수 있습니다(관리자가 설정한 경우 회원별 월별 한도 적용).

유료 조직 시트(WONDA / WONDA_PREMIUM)는 조직 컨텍스트에 있을 때만 개인 유료 플랜과 동일한 유료 기능 액세스(스킬 등)를 부여합니다. wonda use --personal은 사용자의 개인 계정 플랜으로 대체됩니다.

액세스 등급

Wonda는 유료 전용입니다. 모든 제품 표면(생성, 미디어, 게시, 스크래핑, 분석, 스킬, 클라우드 트윈)에는 유료 플랜이 필요합니다. 새 계정은 크레딧이 없으며 구독할 때까지 제품 액세스 권한이 없습니다.

등급	액세스
익명 (임시 계정, 로그인 없음)	제품 액세스 없음. CLI는 첫 실행 시 임시 계정을 생성하지만, 아래의 로컬 명령과 인증/결제 엔드포인트에만 도달합니다. wonda auth login을 실행한 후 구독하십시오.
무료 (로그인됨, 유료 플랜 없음)	제품 액세스 없음. https://wonda.sh/account에서 구독하여 제품을 사용하십시오.
WONDA ($19.99/월, "Pro")	클라우드 트윈을 제외한 모든 기능: 생성(image/generate, video/generate, ...), 미디어 업로드/다운로드, 게시, 스크래핑, 분석, 비디오 분석, 스킬(wonda skill install/list/get), 전환, 클리핑, 이메일, reddit/linkedin 계정 생성, 스타일, 브랜드.
WONDA_PREMIUM ($49.99/월, "Premium")	WONDA의 모든 기능, 더불어 클라우드 트윈(wonda twin: 프로비저닝, 예약 실행, 스트리밍 로그인) 및 안티탐지/섀도밴 보호, 제한 없음, 미국 계정 생성.
플래그됨 (계정별 PostHog 킬 스위치)	유료 플랜에 포함되지만 계정별 플래그로 제어 가능: wonda reddit signup (redditAccountCreationEnabled), wonda email (emailServerApiEnabled), 공개 LinkedIn 프로필 보강 (linkedinProfileEnrichmentEnabled).
로컬 (API 호출 없음, 크레딧 없음, 플랜 없음)	머신에서 완전히 실행되므로 플랜 없이 작동: wonda brand extract <url> (--save 없음), wonda compose motion/wonda compose text, wonda wab record <url>, wonda edit ... 로컬 파일에 대한 ffmpeg 기본 변환, wonda doctor. Chromium 기반 기능은 일회성 wonda wab install이 필요합니다.

명령이 403 (paid_plan_required)을 반환하면 https://wonda.sh/account에서 구독하십시오.

음성 복제

10초 이상의 오디오 클립에서 음성을 복제하고 TTS에 사용합니다. 하드 제한: 계정당 20개의 복제된 음성. 비용: 복제당 $1.50.

# 로컬 파일에서 복제 (먼저 미디어 라이브러리에 자동 업로드)
wonda voice create "Andu" --file ./sample.mp3 --description "내 목소리"

# 기존 wonda 미디어에서 복제
wonda voice create "Brand" --media-id <uuid>

# 선택적 소스 오디오 전처리
wonda voice create "Clean" --file ./raw.wav --noise-reduction --normalize-volume

# 복제된 음성 목록 (각 행은 isExpired 및 expiresInDays 보고)
wonda voice list

# 단일 음성
wonda voice get <voice-id>

# 이름 / 설명 변경 (로컬 전용, 제공자 호출 없음)
wonda voice update <voice-id> --name "새 이름" --description "..."

# 삭제
wonda voice delete <voice-id>

TTS에서 복제된 음성 사용: voice get의 providerVoiceId를 /audio/speech에 voiceId로 전달합니다:

wonda audio speech "안녕하세요" \
  --model minimax-speech-2-8-hd \
  --params '{"voiceId":"<providerVoiceId>"}'

7일 만료: TTS에서 7일 동안 사용되지 않은 복제된 음성은 자동으로 만료됩니다. 복제된 음성으로 TTS를 실행하면 자동으로 만료가 갱신됩니다. 유휴 음성이 만료되면 다시 복제해야 합니다($1.50 재발생).

자격 증명 볼트

외부 플랫폼(Instagram, TikTok, Twitter 등)에서 생성된 로그인을 유지하여 다음 실행에 재사용할 수 있습니다. 비밀번호는 서버 측 키로 AES-256-GCM 암호화되며 get 시에만 복호화됩니다.

# 생성
wonda credentials create --website instagram.com --username myhandle \
  --email [email protected] --password-stdin <<< "hunter2" \
  --metadata '{"signup_source":"wonda-email"}'

# 목록 (비밀번호 생략)
wonda credentials list --website instagram.com

# 비밀번호를 포함한 전체 레코드 가져오기
wonda credentials get <id>

# 필드 업데이트 (--password-stdin으로 교체, --username ""로 지우기)
wonda credentials update <id> --username newhandle

# 삭제
wonda credentials delete <id>

# 가져오기 + 사용 이유 기록을 한 번에 처리 (POST, GET 아님, 이유와 함께 'used' 이벤트를 기록하기 때문). 이유를 설명할 수 있을 때마다 `get`보다 이것을 선호하십시오.
wonda credentials use <id> --reason "instagram 가입 흐름"

# 감사를 위한 최근 이벤트 보기 (생성 / 사용 / 교체 / 업데이트)
wonda credentials events <id>

필드: website (필수 — insta와 같은 입력은 instagram.com으로 정규화됨), username, email, password (필수), metadata (임의 JSON). username / email 중 하나 이상이 있어야 합니다. (website, username)당 여러 레코드가 허용됩니다. 중복이 필요하면 직접 제거하십시오.

이벤트 로그: 모든 credentials get/use, create, 비밀번호 교체 및 기타 업데이트는 자격 증명에 대한 이벤트로 기록됩니다(행위자: cli | web | system). 감사를 위해 credentials events <id> 또는 웹 UI의 기록 아이콘을 사용하십시오. 이벤트 로그는 추가 전용이며 자격 증명 삭제 시 함께 삭제됩니다.

전역 출력 플래그

모든 명령은 다음 출력 제어 플래그를 지원합니다:

• --json — JSON 출력 강제 (stdout이 파이프될 때 자동 활성화)
• --quiet — 기본 식별자(작업 ID, 미디어 ID 등)만 출력 — 스크립팅에 이상적
• -o <path> — 출력을 파일로 다운로드 (--wait 의미)
• --fields status,outputs — 특정 JSON 필드 선택
• --jq '.outputs[0].media.url' — jq 표현식으로 JSON 출력 필터링

CLI 공지사항 및 지원 중단 경고

모든 명령에서 CLI는 GET /api/v1/updates를 폴링합니다(익명, ~/.wonda/state.json에 1시간 캐시). 활성 공지사항: 지원 중단 알림, 사건 주의보, 업그레이드 프롬프트. 메시지는 stderr에만 출력되므로 stdout/JSON은 파이핑에 깨끗하게 유지됩니다.

요청별 지원 중단 힌트는 표준 Warning: 299 - "<message>" HTTP 헤더로 도착하며 CLI의 HTTP 클라이언트에 의해 [deprecated METHOD /path] <message>로 stderr에 표시됩니다.

두 채널 모두 WONDA_QUIET=1 (환경 변수) 또는 --quiet (플래그)로 음소거합니다. 네트워크 검사만 비활성화하려면 WONDA_NO_UPDATE_CHECK=1을 사용하십시오.

WAB / Wonda Automation Browser (wonda wab)

Wonda Automation Browser (WAB)는 프리미엄 스텔스 안티탐지 브라우저로, 플랫폼이 자동화로 식별하지 못하도록 강화되었습니다. wonda wab은 안티탐지 Chromium 스택(미감지 Playwright 포크)을 위한 명령입니다. 두 가지 면이 있습니다:

• 인증된 세션. 페르소나당 하나의 지속적인 헤드풀 Chromium으로 LinkedIn, X, Reddit 등에 로그인된 세션을 유지합니다. CLI는 필요 시 이를 생성하고, 유휴 상태로 두며, --via wab으로 명령을 실행할 때마다 이를 통해 플랫폼 읽기/쓰기를 라우팅합니다. 쿠키는 페르소나의 Chromium 프로필에 저장되며 ~/.wonda/config.json이 아닙니다.
• 익명 캡처. wonda wab record <url> (및 wonda brand extract)는 새로운 지문, 페르소나 없음, 쿠키 없음으로 임시 Chromium을 구동합니다. 아래 record 블록을 참조하십시오.

멘탈 모델: 계정(플랫폼당 하나의 ID)이 있습니다. 각 플랫폼 명령은 평면 JSON 저장소(--via cookies, 빠름, Chromium 없음) 또는 계정의 페르소나(--via wab, 라이브 안티탐지 Chromium)를 통해 해당 계정의 쿠키로 라우팅됩니다. 페르소나는 하나의 지문 아래 여러 계정을 보유할 수 있는 Chromium 봉투입니다. 거의 모든 경우 페르소나는 첫 --via wab 사용 시 계정 이름으로 자동 생성되므로 페르소나 이름을 입력할 필요가 없습니다.

로컬 wonda.mcpb 데스크톱 확장은 Claude Desktop 또는 Claude Code에서 동일한 로컬 WAB 경로를 사용합니다. 플랫폼 쿠키는 기기에 남고, 읽기는 로컬 쿠키를 사용하며, 쓰기는 로컬 WAB를 사용합니다. Claude 웹 및 Cowork는 대신 원격 MCP 커넥터가 필요합니다.

기본 로그인

사용자에게 다중 로그인을 요청하기 전에 항상 기존 쿠키를 확인하십시오. CLI는 다음을 사용하여 이 작업을 자동화합니다:

wonda cookies list --platform twitter.com

새 로그인이 필요한 경우 --via wab으로 명령을 실행하십시오. CLI는 로그인 페이지에 페르소나를 자동으로 생성하고 안내합니다. 또는 wonda wab login으로 수동 로그인을 트리거할 수 있습니다. 사용자가 wonda wab login을 실행하면 헤드풀 창이 열리고 수동 로그인을 수행한 다음 창을 닫습니다.

WAB 기록

wonda wab record <url>은 새로운 임시 익명 Chromium 인스턴스(고유 지문, 쿠키 없음, 캐시 없음)를 시작하고, 페이지 렌더링이 완료될 때까지 기다린 다음, 콘텐츠에서 텍스트와 스크린샷을 추출하고, 정리한 후 구조화된 결과를 반환합니다. 이는 LinkedIn, X, Reddit과 같은 잠재적으로 동적/JavaScript 기반 페이지에서 데이터를 수집하는 가장 안정적인 방법입니다. --via cookies가 실패할 때 스크래핑을 위한 최상의 대체 전략입니다.

wonda wab record는 항상 분석을 위해 페이지의 마크다운 변환과 함께 JSON 결과를 반환합니다. --wait-until <event>로 대기 전략을 제어할 수 있습니다(load, domcontentloaded, networkidle, visible). 플래그:

• --screenshot fullpage — (기본값) 전체 페이지 스크린샷을 base64 PNG로 포함
• --screenshot viewport — 표시 영역만
• --screenshot none — 스크린샷 없음, 텍스트만

가장 빠른 모드(스크린샷 없음, domcontentloaded):

wonda wab record "https://example.com" \
  --screenshot none \
  --wait-until domcontentloaded

WAB 설치 처음 wonda wab 명령을 실행하기 전에:

wonda wab install

그러면 Chromium 바이너리가 다운로드됩니다.

WAB 환경 변수

원격 디버깅 또는 CI/CD 설정:

변수	설명
WONDA_WAB_HEADLESS	1로 설정하면 헤드리스 모드 강제
WONDA_WAB_DEBUG	1로 설정하면 추가 디버그 로깅 활성화
WONDA_WAB_CDP	1로 설정하면 CDP(Chrome DevTools Protocol) 포트 열기 (--remote-debugging-port)
WONDA_WAB_CDP_PORT	CDP용 사용자 정의 포트(기본값: 0 = 무작위)
WONDA_WAB_TIMEOUT	WAB 작업의 기본 시간 제한(ms)

예를 들어, 헤드리스 CDP:

WONDA_WAB_HEADLESS=1 WONDA_WAB_CDP=1 wonda wab record "https://example.com"

콘텐츠 생성

Wonda CLI는 생성 및 미디어 편집을 위한 광범위한 명령을 제공합니다.

이미지

# 텍스트 프롬프트에서 이미지 생성
wonda image generate "우주를 배경으로 한 네온 사이버펑크 도시" --model recraft-20b

# 스타일 참조로 생성
wonda image generate "고양이" --style "만화 스타일"

# 이미지 변형
wonda image vary <image-id> --prompt "약간 더 밝게"

비디오

# 텍스트 프롬프트에서 비디오 생성
wonda video generate "달 위를 걷는 우주 비행사"

# 이미지에서 비디오 생성
wonda video generate --image <image-id> --prompt "파도치는 효과"

# 비디오 스타일 전송
wonda video stylize <video-id> --style "필름 누아르"

오디오 / 음악

# 텍스트에서 오디오 생성
wonda audio speech "안녕하세요, Wonda CLI입니다." --model minimax-speech-2-8-hd

# 음악 생성
wonda music generate "잔잔한 재즈 피아노" --duration 30

# 음성 복제 (위 참조)

콘텐츠 게시

소셜 플랫폼에 직접 게시합니다.

LinkedIn

# 게시물 생성 및 게시
wonda linkedin post --text "Wonda CLI에 대한 생각" --image <image-id>

# 게시물 예약
wonda linkedin post --text "내일을 위한 준비" --schedule "2026-07-08T09:00:00Z"

X/Twitter

wonda twitter post "Wonda CLI에서 트윗!"

Reddit

wonda reddit post subreddit-name "제목" "본문"

연구 및 자동화

소셜 플랫폼에서 데이터를 스크래핑하고 분석합니다.

LinkedIn 연구

# 프로필 정보 가져오기
wonda linkedin profile https://www.linkedin.com/in/username

# 게시물 검색
wonda linkedin search --query "AI 에이전트"

Reddit 연구

# 서브레딧에서 게시물 검색
wonda reddit search --subreddit "ArtificialIntelligence" --query "에이전트"

X/Twitter 연구

# 트윗 검색
wonda twitter search --query "Wonda CLI" --count 20

일반적인 워크플로우 예시

1. 이미지를 생성하고 LinkedIn에 게시:

wonda image generate "자연 경관" --wait
wonda linkedin post --text "아름다운 자연 사진입니다!" --image <image-id>

2. LinkedIn 프로필을 연구하고 분석 저장:

wonda linkedin profile "https://linkedin.com/in/example" --json > profile.json

3. 비디오 생성 및 편집:

wonda video generate "일몰 장면" --wait
wonda edit <video-id> --trim 00:00:05 00:00:15 --output trimmed.mp4

문제 해결

• wonda doctor — 시스템 상태 확인
• 명령이 작동하지 않으면 --json 플래그를 사용하여 자세한 오류를 확인하십시오.
• 지원이 필요하면 https://wonda.sh/support를 방문하십시오.