# viruagent-cli 심층 분석 리서치

## 목적
viruagent-cli(AI 에이전트용 SNS 자동화 CLI 도구)를 A to Z로 심층 분석하고,
우리 마케팅 실행단(ThreadAuto, SNS 자동 게시, 리쿠르팅 캠페인)에 적용할 인사이트를 도출한다.

## 분석 대상
- GitHub: https://github.com/greekr4/viruagent-cli
- 소스 코드 전체 (src/, bin/, analyzer/, skills/)
- 스킬 파일 (skills/viruagent.md 등)
- 플랫폼별 가이드 (docs/)
- 데모 자료 (demo/)

## 분석 항목 (표면 요약 금지, 심층 분석 필수)

### 1. 플랫폼별 API/자동화 방식 상세 분석
각 플랫폼별로 어떻게 자동화하는지 코드 레벨까지 분석:
- **네이버 블로그**: SE 에디터 + RabbitWrite API 방식. 인증, 이미지 업로드, 카테고리 관리
- **티스토리**: Playwright 자동화 방식. 로그인, 발행, 임시저장
- **인스타그램**: HTTP fetch 방식. 좋아요/댓글/팔로우/포스팅 자동화, 속도 제한 관리
- **X(Twitter)**: 내부 GraphQL API + 동적 queryId 추출. 트윗/리트윗/좋아요/팔로우
- **Threads**: Barcelona API + IGT:2 토큰. 포스팅/답글/좋아요/팔로우
- **Reddit**: 포스팅/댓글/업보트/검색/구독
- **네이버 카페**: 캡차 우회(5회 무료), 가입, 게시물 작성

### 2. 스킬 시스템 분석
- viruagent.md 스킬 파일의 구조와 작동 방식
- 에이전트가 스킬을 읽고 자율적으로 명령 조율하는 메커니즘
- 우리 스킬 시스템(skills/ 디렉토리)과의 비교

### 3. 세션/인증 관리
- `~/.viruagent-cli/` 세션 파일 구조
- 플랫폼별 인증 방식 (쿠키, 토큰, OAuth)
- 세션 만료/갱신 처리

### 4. 속도 제한 및 안전장치
- 사용자별 지속적 카운터 + 랜덤 지연 방식
- 각 플랫폼의 속도 제한 정책 대응
- 밴/차단 방지 전략

### 5. 이미지 처리
- DuckDuckGo, Wikimedia Commons 이미지 검색 방식
- 이미지 업로드 파이프라인 (플랫폼별)
- 네이버 카페 슬라이드/콜라주 기능

### 6. 우리 시스템 적용 분석 (핵심)
- **ThreadAuto와의 비교**: 현재 Threads API만 지원 vs viruagent는 7개 플랫폼
- **우리가 즉시 활용 가능한 것**: 네이버 블로그 자동 포스팅, 인스타그램 자동화, X 자동화
- **우리 마케팅 실행단에 필요한 기능**: 리쿠르팅 광고 자동 게시, 멀티 플랫폼 동시 발행
- **도입 방식**: viruagent-cli를 직접 사용 vs 코드 참고하여 우리 시스템에 통합
- **위험 분석**: 각 플랫폼 ToS 위반 가능성, 계정 밴 리스크

### 7. 코드 품질 분석
- 코드 구조, 에러 핸들링, 테스트 유무
- 우리 시스템에 통합할 때 리팩토링 필요 범위

## 산출물
- 심층 분석 보고서: `/home/jay/workspace/memory/research/viruagent-cli-analysis.md`
- 우리 시스템 적용 제안서: `/home/jay/workspace/memory/research/viruagent-cli-application.md`

## 주의사항
- GitHub README만 읽고 끝내지 말 것 — 실제 코드 파일, 설정, API 호출 방식까지 확인
- "좋아 보인다" 식 감상 금지 — 구체적 근거와 코드 레벨 분석 필수
- ToS 위반 가능성도 반드시 분석 (어떤 플랫폼이 위험한지)