# viruagent-cli 우리 시스템 적용 제안서

> 작성: 개발4팀 (비슈누 팀장) | 작성일: 2026-03-31
> 참고: viruagent-cli-analysis.md (심층 분석 보고서)

---

## 1. 현재 상황 vs viruagent-cli

### 1.1 우리 현재 보유 자산

- **ThreadAuto**: Threads 플랫폼 전용 자동 게시 (공식 Threads API 기반)
- **skills/**: 마케팅 스킬 시스템 (카피라이팅, SEO, 광고 등)
- **리쿠르팅 캠페인**: 보험 FA 리쿠르팅 콘텐츠 제작

### 1.2 viruagent-cli가 커버하는 영역

| 플랫폼 | 현재 우리 | viruagent-cli | 활용 가치 |
|--------|----------|---------------|----------|
| Threads | ThreadAuto (공식 API) | Barcelona 비공식 API | 낮음 (우리가 더 안전) |
| 네이버 블로그 | 수동 | SE 에디터 + RabbitWrite | **높음** |
| 티스토리 | 수동 | Playwright + fetch | **높음** |
| 인스타그램 | 수동 | HTTP 비공식 API | 중간 (리스크 높음) |
| X(Twitter) | 수동 | GraphQL 비공식 API | 중간 (리스크 높음) |
| 네이버 카페 | 수동 | 모바일 API | 중간 |
| Reddit | 없음 | OAuth2 공식 API | 낮음 (우리 타겟 아님) |

---

## 2. 즉시 활용 가능한 기능

### 2.1 네이버 블로그 자동 포스팅 (최우선)

**활용 가치**: 리쿠르팅 블로그, 보험 콘텐츠 블로그 자동 발행

**구체적 활용 방식**:
1. blog-writer 스킬로 콘텐츠 생성
2. viruagent-cli로 네이버 블로그 자동 발행
3. 카테고리 자동 매핑, 태그 자동 설정, 이미지 자동 삽입

**필요 명령어**:
```bash
# 로그인 (1회)
npx viruagent-cli login --provider naver --account recruiting-blog

# 카테고리 확인
npx viruagent-cli list-categories --provider naver --account recruiting-blog

# 발행
npx viruagent-cli publish --provider naver --account recruiting-blog \
  --title "보험 FA 리쿠르팅 안내" \
  --content-file post.html \
  --category "리쿠르팅" \
  --tags "보험,FA,리쿠르팅"
```

**리스크**: 중(MEDIUM). 네이버는 마케터 자동화를 사실상 묵인하나, API 변경 시 즉각 중단. 봇 탐지 우회 스크립트 사용.

### 2.2 티스토리 자동 포스팅

**활용 가치**: SEO용 티스토리 블로그 운영 자동화

**필요 작업**: Kakao 로그인 자동화를 위한 Playwright + Chromium 설치
- `npx playwright install chromium` (서버에서 ~500MB)
- Kakao 2FA 사용 시 초기 1회 수동 개입 필요

**리스크**: 중(MEDIUM). Kakao OAuth CDP 자동화가 정책 위반 가능.

### 2.3 멀티 플랫폼 동시 발행 (recipe-cross-post)

viruagent-cli의 `recipe-cross-post` 스킬은 하나의 콘텐츠를 여러 플랫폼에 동시 게시하는 워크플로우를 정의.

**우리 활용**: blog-writer 산출물 → 네이버 블로그 + 티스토리 동시 발행
```bash
# 네이버 + 티스토리 동시
npx viruagent-cli publish --provider naver --content-file post.html --title "..."
npx viruagent-cli publish --provider tistory --content-file post.html --title "..."
```

---

## 3. 신중하게 접근할 기능

### 3.1 인스타그램 자동화 (ToS 위험: 상)

**활용 시나리오**: 리쿠르팅 캠페인 인스타그램 자동 좋아요/팔로우/댓글

**리스크가 높은 이유**:
- Meta ToS 명시적 자동화 금지
- 비공개 Web API 사용 (앱 ID 스푸핑)
- Meta의 자동화 도구 소송 전례
- 계정 영구 정지 + IP 차단 가능

**권장**: 인스타그램은 공식 Graph API 또는 수동 운영 유지. viruagent-cli 코드는 API 엔드포인트/인증 흐름 학습 자료로만 참조.

### 3.2 X(Twitter) 자동화 (ToS 위험: 상)

**리스크가 높은 이유**:
- 내부 GraphQL API 리버스 엔지니어링
- X는 2023년부터 자동화 법적 조치 강화
- 226 에러(자동화 감지) 시 계정 장기 정지

**권장**: X는 공식 API v2 사용 또는 수동 운영. graphqlSync.js의 동적 queryId 추출 메커니즘은 기술적으로 흥미롭지만 프로덕션 사용은 위험.

### 3.3 Threads 자동화

**현황**: 우리는 이미 ThreadAuto로 공식 Threads API 기반 자동화 보유.
**viruagent-cli 방식**: Barcelona 비공식 API (Android 앱 위장) → 리스크 높음.
**권장**: ThreadAuto 유지. viruagent-cli의 Threads 코드는 참조 불필요.

---

## 4. 도입 방식 제안

### 4.1 방식 A: viruagent-cli 직접 사용 (권장)

**장점**:
- 즉시 사용 가능 (`npm install -g viruagent-cli`)
- 업데이트/버그 수정을 원저자가 관리
- JSON 출력 → 우리 스크립트에서 파싱 용이

**단점**:
- 외부 의존성 증가
- 원저자 프로젝트 중단 리스크
- 우리 요구에 맞는 커스터마이징 불가

**적용 범위**: 네이버 블로그 + 티스토리 자동 발행만

### 4.2 방식 B: 코드 참고하여 우리 시스템에 통합

**장점**:
- 필요한 부분만 선택적 도입
- 우리 코드베이스에 맞는 리팩토링 가능
- 외부 의존성 없음

**단점**:
- 구현/유지보수 비용 발생
- 원저자의 API 변경 대응 자체 수행 필요

**우선 참고 대상**:
1. **네이버 SE 에디터 JSON 구조** (`editorConvert.js`, `naverApiClient.js`) — HTML → SE 컴포넌트 변환 로직
2. **네이버 RabbitWrite API** (`naverApiClient.js:305-422`) — 발행 파라미터
3. **티스토리 내부 API** (`tistoryApiClient.js`) — 발행/초안/카테고리 엔드포인트
4. **이미지 검색/업로드 파이프라인** (`imageSources.js`, `imageUpload.js`) — DuckDuckGo/Wikimedia 이미지 검색

### 4.3 권장: 방식 A (1단계) → 방식 B (2단계)

**1단계** (즉시): viruagent-cli를 서버에 설치하고, 네이버 블로그/티스토리 자동 발행 파이프라인을 구축.
- blog-writer 스킬 → HTML 생성 → viruagent-cli publish
- 스케줄러로 주 3회 자동 발행

**2단계** (중기): 안정성이 확인되면 핵심 코드(네이버 SE 변환, 이미지 업로드)를 우리 코드베이스로 포팅.
- 네이버/티스토리 API 클라이언트를 Python으로 재작성
- 우리 마케팅 자동화 파이프라인에 네이티브 통합

---

## 5. 우리 마케팅 실행단 적용 시나리오

### 5.1 리쿠르팅 블로그 자동 운영

```
[콘텐츠 생성] blog-writer → HTML
       ↓
[플랫폼 발행] viruagent-cli → 네이버 블로그 + 티스토리
       ↓
[SEO 최적화] naver-seo 스킬 → 키워드 분석 → 콘텐츠 반영
       ↓
[스케줄링] cron → 주 3회 자동 발행
```

### 5.2 보험 콘텐츠 멀티 채널 배포

```
[전략] content-strategy → 토픽 선정
       ↓
[작성] blog-writer → 네이버/티스토리 최적화 버전 각각
       ↓
[발행] viruagent-cli → 네이버 블로그
       viruagent-cli → 티스토리
       ThreadAuto → Threads (기존)
       ↓
[추적] analytics-tracking → 유입 분석
```

### 5.3 네이버 카페 리쿠르팅

```
[타겟 카페 선정] 수동
       ↓
[카페 가입] viruagent-cli cafe-join (캡차는 수동)
       ↓
[게시물 작성] viruagent-cli cafe-write
       ↓
[모니터링] 수동 (자동화 리스크 관리)
```

---

## 6. 위험 분석 및 완화 전략

### 6.1 플랫폼별 권장 사용 범위

| 플랫폼 | 사용 권장 | 사용 범위 | 주의사항 |
|--------|----------|----------|---------|
| 네이버 블로그 | O | 발행, 카테고리, 이미지 | 일 1-2회 발행 권장 |
| 티스토리 | O | 발행, 초안, 카테고리 | 일 15회 하드캡 |
| 네이버 카페 | 제한적 | 가입, 게시물 작성 | 캡차 수동 처리, 카페별 규정 준수 |
| 인스타그램 | X | - | ToS 위반 리스크 상 |
| Threads | X | - | ThreadAuto 사용 |
| X(Twitter) | X | - | ToS 위반 리스크 상 |
| Reddit | X | - | 우리 타겟 아님 |

### 6.2 보안 완화 조치

viruagent-cli 사용 시 필수 보안 조치:
1. **세션 파일 권한**: `chmod 600 ~/.viruagent-cli/sessions/*.json`
2. **전용 서버**: viruagent-cli를 격리된 서버/컨테이너에서 실행
3. **계정 분리**: 자동화 전용 네이버/카카오 계정 사용 (메인 계정 사용 금지)
4. **모니터링**: 발행 실패/세션 만료 알림 설정
5. **주기적 세션 갱신**: 주 1회 수동 로그인으로 세션 refresh

### 6.3 저작권 대응

viruagent-cli의 이미지 검색 기능 사용 시:
- DuckDuckGo 이미지 검색 결과는 저작권 불명 → 사용 금지
- Wikimedia Commons는 CC 라이선스이나 코드가 저작자 표시를 누락 → 수동 표시 필요
- **권장**: 자체 이미지 라이브러리 또는 Gemini 이미지 생성 스킬 사용

---

## 7. 스킬 시스템 적용 인사이트

### 7.1 viruagent-cli에서 배울 점

1. **va-/persona-/recipe- prefix 체계**: 원자 기능 → 역할 → 워크플로우 계층 구조가 명확. 우리 스킬 시스템에도 유사한 분류 체계 도입 검토.
2. **라우터 스킬 패턴**: 진입점 스킬이 키워드 매칭 → 서브 스킬 지연 로딩. 컨텍스트 절약에 효과적.
3. **`--spec` 자가 문서화**: CLI 도구가 자신의 API 스키마를 JSON으로 출력하여 AI가 사용 가능한 명령을 자동 파악. 우리 도구에도 적용 가능.
4. **`--dry-run` 안전장치**: write 커맨드의 사전 검증 지원.

### 7.2 개발 파이프라인 참고

viruagent-cli의 `.claude/` 디렉토리에 정의된 개발 파이프라인(web-reverser → provider-builder → skill-writer → qa-verifier)은 새 플랫폼 프로바이더를 추가할 때의 체계적 접근법을 보여줌. 우리가 새 플랫폼 연동 시 유사한 파이프라인 구조 참고 가능.

---

## 8. 결론 및 액션 아이템

### 즉시 실행 (이번 주)
1. 서버에 `npm install -g viruagent-cli` + `npx playwright install chromium`
2. 네이버 블로그/티스토리 로그인 세션 확보
3. blog-writer → viruagent-cli publish 파이프라인 프로토타입

### 단기 (2주 내)
4. 주 3회 자동 발행 스케줄러 구축
5. 세션 만료 모니터링 + 자동 알림
6. 발행 결과 추적 (성공/실패 로그)

### 중기 (1개월 내)
7. 네이버 SE 변환/RabbitWrite API를 Python으로 포팅 검토
8. 이미지 업로드 파이프라인을 우리 이미지 생성 시스템과 연동
9. 네이버 카페 리쿠르팅 게시 프로토타입

### 보류
- 인스타그램/X/Threads 자동화 (ToS 리스크 과다)
- Reddit 자동화 (우리 타겟 시장 아님)