viruagent-cli 0.5.0 → 0.6.0

package/bin/index.js

@@ -204,6 +204,32 @@ unlikeCommentCmd
   .option('--comment-id <id>', 'Comment ID')
   .action((opts) => execute('unlike-comment', opts));
 
+const sendDmCmd = program
+  .command('send-dm')
+  .description('Send a direct message to a user');
+addProviderOption(sendDmCmd);
+sendDmCmd
+  .option('--username <username>', 'Recipient username')
+  .option('--thread-id <threadId>', 'Existing thread ID')
+  .option('--text <message>', 'Message text')
+  .action((opts) => execute('send-dm', opts));
+
+const listMessagesCmd = program
+  .command('list-messages')
+  .description('List messages in a DM thread (via browser)');
+addProviderOption(listMessagesCmd);
+listMessagesCmd
+  .option('--thread-id <threadId>', 'Thread ID')
+  .action((opts) => execute('list-messages', opts));
+
+const listCommentsCmd = program
+  .command('list-comments')
+  .description('List comments on a post');
+addProviderOption(listCommentsCmd);
+listCommentsCmd
+  .option('--post-id <shortcode>', 'Post shortcode')
+  .action((opts) => execute('list-comments', opts));
+
 const analyzePostCmd = program
   .command('analyze-post')
   .description('Analyze a post (thumbnail + caption + profile)');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viruagent-cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "AI-agent-optimized CLI for blog publishing (Tistory, Naver) and Instagram automation",
   "private": false,
   "type": "commonjs",

package/skills/persona-blogger/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: persona-blogger
+version: 1.0.0
+description: "블로거 페르소나: 블로그 전문 작성자 역할"
+metadata:
+  category: "persona"
+  requires:
+    skills: ["va-tistory", "va-naver", "va-shared"]
+---
+
+# persona-blogger — 블로거
+
+블로그 전문 작성자 역할을 수행합니다. Tistory와 Naver 블로그에 고품질 콘텐츠를 발행합니다.
+
+## 역할
+
+- SEO 최적화된 블로그 글 작성
+- 플랫폼별 HTML 규칙 준수 (Tistory: data-ke-*, Naver: plain HTML)
+- 이미지 키워드 선정 및 포함
+- 독자 관점에서의 구조화된 글쓰기
+
+## 워크플로우
+
+1. **인증 확인**: `status --provider <platform>` 실행
+2. **카테고리 선택**: `list-categories --provider <platform>` → 사용자에게 확인
+3. **글 작성**: va-shared 글쓰기 규칙에 따라 HTML 콘텐츠 작성
+4. **검증**: `--dry-run`으로 파라미터 확인
+5. **발행**: `publish --provider <platform>`
+6. **확인**: `list-posts --provider <platform> --limit 1`
+
+## 작성 팁
+
+- 이미지 키워드 2~3개 항상 영어로 포함
+- Tistory와 Naver의 HTML 규칙 차이 주의
+  - Tistory: `<p data-ke-size="size18">`, `<blockquote data-ke-style="style2">`
+  - Naver: 일반 `<p>`, 일반 `<blockquote>`
+- 태그 5개 필수 — 글 언어와 일치
+- 서론에 독자 공감 포인트 반드시 포함
+- 본문 각 섹션에 구체적 근거 (데이터, 사례, 인용) 포함
+
+## 플랫폼 미지정 시
+
+사용자가 "블로그 써줘"라고만 하면, Tistory와 Naver 중 어디에 발행할지 질문.
+
+## See Also
+
+va-tistory-publish, va-naver-publish, va-shared, recipe-blog-publish

package/skills/persona-influencer-manager/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: persona-influencer-manager
+version: 1.0.0
+description: "인플루언서 매니저 페르소나: Instagram 계정 관리 및 성장 전략"
+metadata:
+  category: "persona"
+  requires:
+    skills: ["va-insta", "va-shared"]
+---
+
+# persona-influencer-manager — 인플루언서 매니저
+
+Instagram 계정의 성장과 인게이지먼트를 관리하는 매니저 역할을 수행합니다.
+
+## 역할
+
+- 피드 분석 및 트렌드 파악
+- 타겟 사용자 인게이지먼트 (좋아요, 댓글, 팔로우)
+- 레이트리밋 준수하며 자연스러운 활동
+- 댓글 품질 관리 (맥락 기반, 다양한 톤)
+
+## 워크플로우
+
+1. **인증 확인**: `status --provider insta`
+2. **레이트리밋 확인**: `rate-limit-status --provider insta`
+3. **피드 분석**: `get-feed --provider insta` → 트렌드 파악
+4. **타겟 선정**: 관련 계정 프로필 조회
+5. **인게이지먼트**: 좋아요 → 대기 → 댓글 → 대기 순서로 자연스럽게
+6. **결과 보고**: 수행한 활동 요약
+
+## 핵심 원칙
+
+- 봇 감지 회피: 균일 간격 금지, 랜덤 딜레이 필수
+- 일일 한도 50% 이상 사용 시 활동 속도 줄이기
+- 챌린지 발생 시 즉시 활동 중단
+- 댓글은 반드시 맥락 기반 — 일반적 문구 절대 금지
+
+## See Also
+
+va-insta, recipe-engage-feed, recipe-daily-engagement, recipe-grow-followers

package/skills/persona-sns-marketer/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: persona-sns-marketer
+version: 1.0.0
+description: "SNS 마케터 페르소나: 블로그와 인스타 연계 마케팅 전략"
+metadata:
+  category: "persona"
+  requires:
+    skills: ["va-tistory", "va-naver", "va-insta", "va-shared"]
+---
+
+# persona-sns-marketer — SNS 마케터
+
+블로그와 Instagram을 연계하여 콘텐츠 마케팅을 수행합니다.
+
+## 역할
+
+- 블로그 글 작성 후 Instagram 홍보 포스트 연계
+- 크로스 플랫폼 콘텐츠 전략 수립
+- 타겟 오디언스별 콘텐츠 최적화
+- 인게이지먼트 분석 및 전략 조정
+
+## 워크플로우
+
+1. **콘텐츠 기획**: 주제 선정, 키워드 리서치
+2. **블로그 발행**: Tistory 또는 Naver에 상세 글 발행
+3. **인스타 연계**: 블로그 내용 요약 → 인스타 홍보 댓글/DM
+4. **인게이지먼트**: 관련 계정에 좋아요/댓글로 노출 확대
+5. **결과 분석**: 활동 결과 요약
+
+## 핵심 원칙
+
+- 블로그는 심층 콘텐츠, 인스타는 요약/홍보 역할
+- 플랫폼별 톤 차이: 블로그(정보 전달) vs 인스타(캐주얼)
+- 레이트리밋 준수하며 자연스러운 인게이지먼트
+
+## See Also
+
+recipe-cross-post, recipe-blog-publish, persona-blogger, persona-influencer-manager

package/skills/recipe-blog-publish/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: recipe-blog-publish
+version: 1.0.0
+description: "레시피: 블로그 글 작성부터 발행까지 전체 워크플로우"
+metadata:
+  category: "recipe"
+  requires:
+    skills: ["va-tistory-login", "va-tistory-publish", "va-tistory-categories", "va-naver-login", "va-naver-publish", "va-naver-categories", "va-shared"]
+---
+
+# recipe-blog-publish — 블로그 발행 워크플로우
+
+블로그 글을 처음부터 끝까지 발행하는 워크플로우.
+
+## Steps
+
+### 1. 플랫폼 결정
+사용자에게 Tistory / Naver 중 선택 확인.
+
+### 2. 인증 확인
+```bash
+npx viruagent-cli status --provider <platform>
+```
+미로그인 시 → va-tistory-login 또는 va-naver-login 스킬 참조.
+
+### 3. 카테고리 선택
+```bash
+npx viruagent-cli list-categories --provider <platform>
+```
+사용자에게 카테고리 확인.
+
+### 4. 콘텐츠 작성
+va-shared 글쓰기 규칙에 따라 HTML 콘텐츠 작성.
+- Tistory: `data-ke-*` 속성 사용 (va-tistory-publish 참조)
+- Naver: plain HTML 사용 (va-naver-publish 참조)
+
+### 5. 파라미터 검증
+```bash
+npx viruagent-cli publish --provider <platform> --dry-run \
+  --title "..." --content "..." --category <id> --tags "..." \
+  --related-image-keywords "..."
+```
+
+### 6. 발행
+```bash
+npx viruagent-cli publish --provider <platform> \
+  --title "..." --content "..." --category <id> --tags "..." \
+  --visibility public --related-image-keywords "..." \
+  --image-upload-limit <n> --minimum-image-count 1
+```
+
+### 7. 발행 확인
+```bash
+npx viruagent-cli list-posts --provider <platform> --limit 1
+```
+
+## See Also
+
+va-tistory-publish, va-naver-publish, va-shared, persona-blogger

package/skills/recipe-cross-post/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: recipe-cross-post
+version: 1.0.0
+description: "레시피: 블로그 발행 후 Instagram 홍보 포스팅 연계"
+metadata:
+  category: "recipe"
+  requires:
+    skills: ["va-tistory-publish", "va-naver-publish", "va-insta-comment", "va-insta-dm", "va-shared"]
+---
+
+# recipe-cross-post — 블로그 → 인스타 홍보
+
+블로그 글 발행 후 Instagram에서 홍보하는 크로스 포스팅 워크플로우.
+
+## Steps
+
+### 1. 블로그 발행
+recipe-blog-publish 워크플로우로 블로그 글 발행.
+
+### 2. 인스타 인증 확인
+```bash
+npx viruagent-cli status --provider insta
+```
+
+### 3. 관련 게시물 찾기
+```bash
+npx viruagent-cli get-feed --provider insta
+```
+블로그 주제와 관련된 인스타 게시물 탐색.
+
+### 4. 홍보 인게이지먼트
+관련 게시물에 좋아요 + 맥락 댓글 작성.
+- 블로그 링크 직접 홍보 대신, 관련 커뮤니티에 자연스럽게 참여
+- va-insta-comment 댓글 규칙 준수
+
+### 5. 결과 요약
+수행한 활동 (좋아요 수, 댓글 수) 사용자에게 보고.
+
+## See Also
+
+recipe-blog-publish, va-insta-comment, va-insta-like, persona-sns-marketer

package/skills/recipe-daily-engagement/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: recipe-daily-engagement
+version: 1.0.0
+description: "레시피: 일일 Instagram 인게이지먼트 루틴"
+metadata:
+  category: "recipe"
+  requires:
+    skills: ["va-insta-feed", "va-insta-like", "va-insta-comment", "va-insta-follow"]
+---
+
+# recipe-daily-engagement — 일일 인게이지먼트 루틴
+
+Instagram에서 매일 수행하는 인게이지먼트 루틴.
+
+## Steps
+
+### 1. 상태 확인
+```bash
+npx viruagent-cli status --provider insta
+npx viruagent-cli rate-limit-status --provider insta
+```
+
+### 2. 피드 인게이지먼트
+recipe-engage-feed 워크플로우 실행.
+- 피드에서 5~10개 게시물에 좋아요 + 댓글
+
+### 3. 타겟 사용자 인게이지먼트
+특정 사용자 계정 방문:
+```bash
+npx viruagent-cli list-posts --provider insta --username <target> --limit 5
+```
+- 최근 게시물 3~5개에 좋아요
+- 1~2개에 맥락 댓글
+
+### 4. 신규 팔로우 (선택)
+관련 분야 사용자 1~3명 팔로우:
+```bash
+npx viruagent-cli follow --provider insta --username <user>
+```
+
+### 5. 결과 보고
+- 총 좋아요 수
+- 총 댓글 수
+- 신규 팔로우 수
+- 남은 일일 한도
+
+## 일일 권장 활동량
+
+| 액션 | 권장량 | 일일 한도 |
+|------|--------|-----------|
+| 좋아요 | 30~50 | 500 |
+| 댓글 | 5~10 | 100 |
+| 팔로우 | 1~5 | 250 |
+
+## See Also
+
+recipe-engage-feed, va-insta, persona-influencer-manager

package/skills/recipe-engage-feed/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: recipe-engage-feed
+version: 1.0.0
+description: "레시피: 피드 순회 → 좋아요 → 댓글 인게이지먼트 루프"
+metadata:
+  category: "recipe"
+  requires:
+    skills: ["va-insta-feed", "va-insta-like", "va-insta-comment"]
+---
+
+# recipe-engage-feed — 피드 인게이지먼트
+
+Instagram 피드를 순회하며 좋아요와 댓글로 인게이지먼트하는 워크플로우.
+
+## Steps
+
+### 1. 레이트리밋 확인
+```bash
+npx viruagent-cli rate-limit-status --provider insta
+```
+
+### 2. 피드 가져오기
+```bash
+npx viruagent-cli get-feed --provider insta
+```
+
+### 3. 각 게시물 처리
+게시물마다 반복:
+
+#### a. 게시물 분석
+```bash
+npx viruagent-cli analyze-post --provider insta --post-id <shortcode>
+```
+썸네일 이미지 + 캡션으로 콘텐츠 파악.
+
+#### b. 좋아요
+```bash
+npx viruagent-cli like --provider insta --post-id <shortcode>
+```
+
+#### c. 대기
+5~7분 랜덤 대기 (댓글 레이트리밋).
+
+#### d. 댓글 작성
+```bash
+npx viruagent-cli comment --provider insta --post-id <shortcode> --text "..."
+```
+va-insta-comment 댓글 규칙 준수.
+
+### 4. 다음 게시물로 반복
+
+레이트리밋 한도에 도달하면 중단하고 사용자에게 보고.
+
+## See Also
+
+va-insta-feed, va-insta-like, va-insta-comment, recipe-daily-engagement

package/skills/recipe-grow-followers/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: recipe-grow-followers
+version: 1.0.0
+description: "레시피: 팔로워 성장 전략 — 타겟 인게이지먼트 기반"
+metadata:
+  category: "recipe"
+  requires:
+    skills: ["va-insta-feed", "va-insta-like", "va-insta-comment", "va-insta-follow"]
+---
+
+# recipe-grow-followers — 팔로워 성장 전략
+
+타겟 인게이지먼트를 통한 자연스러운 팔로워 성장 전략.
+
+## 전략 개요
+
+1. 같은 분야 인플루언서의 팔로워 탐색
+2. 해당 팔로워들의 게시물에 자연스럽게 인게이지
+3. 지속적이고 일관된 활동으로 노출 확대
+
+## Steps
+
+### 1. 타겟 사용자 분석
+```bash
+npx viruagent-cli get-profile --provider insta --username <influencer>
+npx viruagent-cli list-posts --provider insta --username <influencer> --limit 10
+```
+
+### 2. 인플루언서 게시물 인게이지먼트
+인플루언서의 최근 게시물에 좋아요 + 댓글:
+- 해당 분야에 관심 있는 사용자들이 볼 수 있는 위치에 노출
+- va-insta-comment 규칙에 따라 양질의 댓글 작성
+
+### 3. 관련 사용자 팔로우
+같은 분야 활발한 사용자 팔로우:
+```bash
+npx viruagent-cli follow --provider insta --username <user>
+```
+
+### 4. 일일 루틴 유지
+recipe-daily-engagement 루틴을 매일 실행하여 일관된 활동 유지.
+
+## 핵심 원칙
+
+- **자연스러움**: 봇처럼 보이지 않는 자연스러운 활동 패턴
+- **품질**: 양보다 질 — 의미 있는 댓글이 팔로우보다 효과적
+- **일관성**: 매일 조금씩 꾸준히 > 하루에 몰아서
+- **인내**: 팔로워 성장은 시간이 걸림 — 단기 수치에 집착하지 않기
+
+## See Also
+
+recipe-daily-engagement, recipe-engage-feed, va-insta-follow, persona-influencer-manager

package/skills/va-insta/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: va-insta
+version: 1.0.0
+description: "Instagram 자동화: 명령 개요 및 레이트리밋 규칙"
+metadata:
+  category: "overview"
+  provider: "insta"
+  requires:
+    bins: ["viruagent-cli"]
+---
+
+# va-insta — Instagram 자동화 개요
+
+Instagram 자동화를 위한 viruagent-cli 가이드. 항상 `--provider insta` 사용.
+
+## 명령 목록
+
+| 명령 | 스킬 | 설명 |
+|------|------|------|
+| login | va-insta-login | 로그인 + 챌린지 해결 |
+| like, unlike | va-insta-like | 좋아요/좋아요 취소 |
+| comment | va-insta-comment | 댓글 작성 |
+| follow, unfollow | va-insta-follow | 팔로우/언팔로우 |
+| send-dm, list-messages | va-insta-dm | DM 보내기/목록 |
+| get-feed, get-profile, list-posts, analyze-post | va-insta-feed | 피드/프로필/분석 |
+
+## Rate Limit Safety (신규 계정 기준)
+
+| 액션 | 딜레이 | 시간당 | 일일 |
+|------|--------|--------|------|
+| Like | 20~40s | 15 | 500 |
+| Comment | 5~7min | 5 | 100 |
+| Follow | 1~2min | 15 | 250 |
+| Unfollow | 1~2min | 10 | 200 |
+| DM | 2~5min | 5 | 30 |
+| Post | 1~2min | 3 | 25 |
+
+모든 딜레이는 랜덤화되어 자동 적용. 카운터는 세션별 userId로 영속화.
+
+## 레이트리밋 확인
+
+```bash
+npx viruagent-cli rate-limit-status --provider insta
+```
+
+대량 작업 전 반드시 확인.
+
+## 중요 사항
+
+- 신규 계정 (< 20일)은 제한이 더 엄격
+- 균일한 액션 간격은 봇 감지 트리거 — 딜레이는 랜덤화됨
+- challenge 발생 시 브라우저에서 본인 인증 필요
+- 세션 + 카운터: `~/.viruagent-cli/sessions/insta-session.json`
+
+## 환경변수
+
+```
+INSTA_USERNAME=
+INSTA_PASSWORD=
+```
+
+## See Also
+
+va-shared, va-insta-login, va-insta-like, va-insta-comment, va-insta-follow, va-insta-dm, va-insta-feed

package/skills/va-insta-comment/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: va-insta-comment
+version: 1.0.0
+description: "Instagram: 게시물에 댓글을 작성합니다."
+metadata:
+  category: "command"
+  provider: "insta"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli comment --help"
+---
+
+# va-insta-comment — 댓글 작성
+
+## 사용법
+
+```bash
+npx viruagent-cli comment --provider insta --post-id <shortcode> --text "comment text"
+```
+
+### 옵션
+
+| 플래그 | 설명 |
+|--------|------|
+| `--post-id` | 게시물 shortcode |
+| `--text` | 댓글 내용 |
+
+## 댓글 목록
+
+```bash
+npx viruagent-cli list-comments --provider insta --post-id <shortcode>
+```
+
+## 댓글 작성 규칙
+
+- 게시물 캡션과 동일한 언어로 작성
+- 이미지/캡션 내용을 구체적으로 언급 — 맥락에 맞는 댓글
+- 1~2문장, 이모지 1~2개
+- 해시태그 금지
+- "Nice post!", "Great content!" 같은 일반적 문구 금지
+- 댓글마다 톤과 스타일 변경 — 패턴 반복 금지
+- 릴스(영상)인 경우, 썸네일 + 캡션으로 맥락 파악
+
+## 스마트 댓글 작성 프로세스
+
+1. `analyze-post --provider insta --post-id <shortcode>` — 썸네일 + 캡션 확인
+2. 썸네일 이미지를 시각적으로 분석하여 콘텐츠 파악
+3. 맥락에 맞는 자연스러운 댓글 작성
+4. `comment --provider insta --post-id <shortcode> --text "..."`
+
+## Rate Limit
+
+| 액션 | 딜레이 | 시간당 | 일일 |
+|------|--------|--------|------|
+| Comment | 5~7min | 5 | 100 |
+
+## See Also
+
+va-insta, va-insta-feed, va-insta-like

package/skills/va-insta-dm/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: va-insta-dm
+version: 1.0.0
+description: "Instagram: DM 보내기 및 메시지 목록 조회"
+metadata:
+  category: "command"
+  provider: "insta"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli send-dm --help"
+---
+
+# va-insta-dm — DM (Direct Message)
+
+## DM 보내기
+
+```bash
+npx viruagent-cli send-dm --provider insta --username <username> --text "message"
+```
+
+기존 스레드가 있는 경우:
+
+```bash
+npx viruagent-cli send-dm --provider insta --thread-id <threadId> --text "message"
+```
+
+### 옵션
+
+| 플래그 | 설명 |
+|--------|------|
+| `--username` | 수신자 사용자명 |
+| `--thread-id` | 기존 스레드 ID |
+| `--text` | 메시지 내용 |
+
+## 메시지 목록
+
+```bash
+npx viruagent-cli list-messages --provider insta --thread-id <threadId>
+```
+
+브라우저를 통해 스레드의 메시지를 가져옵니다.
+
+## Rate Limit
+
+| 액션 | 딜레이 | 시간당 | 일일 |
+|------|--------|--------|------|
+| DM | 2~5min | 5 | 30 |
+
+## See Also
+
+va-insta, va-shared

package/skills/va-insta-feed/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: va-insta-feed
+version: 1.0.0
+description: "Instagram: 피드, 프로필, 게시물 목록, 게시물 분석"
+metadata:
+  category: "command"
+  provider: "insta"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli get-feed --help"
+---
+
+# va-insta-feed — 피드 & 프로필 & 분석
+
+## 피드 타임라인
+
+```bash
+npx viruagent-cli get-feed --provider insta
+```
+
+## 프로필 조회
+
+```bash
+npx viruagent-cli get-profile --provider insta --username <username>
+```
+
+## 게시물 목록
+
+```bash
+npx viruagent-cli list-posts --provider insta --username <username> --limit 20
+```
+
+| 플래그 | 설명 | 기본값 |
+|--------|------|--------|
+| `--username` | 대상 사용자명 | (필수) |
+| `--limit` | 조회할 게시물 수 | 20 |
+
+## 게시물 분석
+
+```bash
+npx viruagent-cli analyze-post --provider insta --post-id <shortcode>
+```
+
+반환값:
+- 캡션 텍스트
+- 썸네일 이미지 (base64)
+- 프로필 정보
+
+`analyze-post`를 사용해 썸네일 이미지를 시각적으로 분석하고 맥락에 맞는 댓글을 작성할 수 있습니다.
+
+## 게시물 발행
+
+```bash
+npx viruagent-cli publish --provider insta \
+  --content "캡션 텍스트 #해시태그" \
+  --related-image-keywords "keyword1,keyword2" \
+  --image-upload-limit 1 \
+  --minimum-image-count 1
+```
+
+| 플래그 | 설명 |
+|--------|------|
+| `--content` | 캡션 텍스트 (해시태그 포함 가능) |
+| `--image-urls` | 직접 이미지 URL 지정 |
+| `--related-image-keywords` | 이미지 자동 검색 키워드 (영어 권장) |
+
+이미지 우선순위: `--image-urls` > `--related-image-keywords` 자동 검색.
+`--content`는 인스타 캡션으로 사용됩니다 (HTML 불필요).
+
+## See Also
+
+va-insta, va-insta-comment, va-insta-like