viruagent-cli 0.5.0 → 0.6.0

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

@@ -0,0 +1,42 @@
+---
+name: va-insta-follow
+version: 1.0.0
+description: "Instagram: 사용자 팔로우/언팔로우"
+metadata:
+  category: "command"
+  provider: "insta"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli follow --help"
+---
+
+# va-insta-follow — 팔로우/언팔로우
+
+## 팔로우
+
+```bash
+npx viruagent-cli follow --provider insta --username <username>
+```
+
+## 언팔로우
+
+```bash
+npx viruagent-cli unfollow --provider insta --username <username>
+```
+
+## Rate Limit
+
+| 액션 | 딜레이 | 시간당 | 일일 |
+|------|--------|--------|------|
+| Follow | 1~2min | 15 | 250 |
+| Unfollow | 1~2min | 10 | 200 |
+
+## 워크플로우: 팔로우 + 인게이지먼트
+
+1. `follow --provider insta --username <user>`
+2. `list-posts --provider insta --username <user> --limit 20`
+3. 각 게시물에 좋아요 + 댓글 (va-insta-like, va-insta-comment 참조)
+
+## See Also
+
+va-insta, va-insta-like, va-insta-comment

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

@@ -0,0 +1,55 @@
+---
+name: va-insta-like
+version: 1.0.0
+description: "Instagram: 게시물 좋아요/좋아요 취소, 댓글 좋아요"
+metadata:
+  category: "command"
+  provider: "insta"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli like --help"
+---
+
+# va-insta-like — 좋아요
+
+## 게시물 좋아요
+
+```bash
+npx viruagent-cli like --provider insta --post-id <shortcode>
+```
+
+## 게시물 좋아요 취소
+
+```bash
+npx viruagent-cli unlike --provider insta --post-id <shortcode>
+```
+
+## 댓글 좋아요
+
+```bash
+npx viruagent-cli like-comment --provider insta --comment-id <id>
+```
+
+## 댓글 좋아요 취소
+
+```bash
+npx viruagent-cli unlike-comment --provider insta --comment-id <id>
+```
+
+## Rate Limit
+
+| 액션 | 딜레이 | 시간당 | 일일 |
+|------|--------|--------|------|
+| Like | 20~40s | 15 | 500 |
+
+딜레이는 자동 랜덤 적용.
+
+## 워크플로우: 사용자 게시물 모두 좋아요
+
+1. `list-posts --provider insta --username <user> --limit 20`
+2. 각 게시물: `like --provider insta --post-id <shortcode>`
+3. 레이트리밋 딜레이 자동 적용 (20~40초)
+
+## See Also
+
+va-insta, va-insta-comment, va-insta-feed

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

@@ -0,0 +1,57 @@
+---
+name: va-insta-login
+version: 1.0.0
+description: "Instagram: 로그인 및 챌린지(본인 인증) 해결"
+metadata:
+  category: "command"
+  provider: "insta"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli login --help"
+---
+
+# va-insta-login — Instagram 로그인
+
+## 인증 상태 확인
+
+```bash
+npx viruagent-cli status --provider insta
+```
+
+## 로그인
+
+```bash
+npx viruagent-cli login --provider insta --username <user> --password <pass>
+```
+
+### 옵션
+
+| 플래그 | 설명 | 기본값 |
+|--------|------|--------|
+| `--username` | 인스타그램 아이디 | - |
+| `--password` | 인스타그램 비밀번호 | - |
+
+### 환경변수
+
+`INSTA_USERNAME` / `INSTA_PASSWORD` 설정 시 자동 사용.
+
+## 챌린지 해결
+
+로그인 시 `challenge` 에러 (302 redirect to /challenge/) 발생 시:
+
+```bash
+npx viruagent-cli resolve-challenge --provider insta
+```
+
+브라우저에서 본인 인증이 필요할 수 있습니다.
+
+## 에러 처리
+
+| 에러 | 조치 |
+|------|------|
+| `challenge` | `resolve-challenge` 실행 또는 브라우저 인증 |
+| `SESSION_EXPIRED` | `login` 재실행 |
+
+## See Also
+
+va-insta, va-shared

package/skills/va-naver/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: va-naver
+version: 1.0.0
+description: "Naver 블로그: 명령 개요 및 플랫폼 특화 규칙"
+metadata:
+  category: "overview"
+  provider: "naver"
+  requires:
+    bins: ["viruagent-cli"]
+---
+
+# va-naver — Naver 블로그 개요
+
+Naver 블로그 퍼블리싱을 위한 viruagent-cli 가이드. 항상 `--provider naver` 사용.
+
+## 명령 목록
+
+| 명령 | 스킬 | 설명 |
+|------|------|------|
+| login | va-naver-login | 네이버 로그인 (manual 모드 포함) |
+| publish | va-naver-publish | 글 발행 |
+| save-draft | va-naver-draft | 임시저장 (private 포스트) |
+| list-categories | va-naver-categories | 카테고리 조회 |
+| list-posts, read-post | va-naver-posts | 글 목록/읽기 |
+
+## Naver HTML 규칙
+
+Naver SE Editor는 `data-ke-*` 속성을 무시합니다:
+- 본문: 일반 `<p>` 태그 사용
+- 여백: `<p>&nbsp;</p>`
+- 인용: 일반 `<blockquote>` — 서버에서 자동 변환
+- HTML → SE Editor 컴포넌트 서버 자동 변환
+
+## 환경변수
+
+```
+NAVER_USERNAME=
+NAVER_PASSWORD=
+```
+
+## See Also
+
+va-shared, va-naver-login, va-naver-publish, va-naver-draft, va-naver-categories, va-naver-posts

package/skills/va-naver-categories/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: va-naver-categories
+version: 1.0.0
+description: "Naver: 블로그 카테고리 목록 조회"
+metadata:
+  category: "command"
+  provider: "naver"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli list-categories --help"
+---
+
+# va-naver-categories — 카테고리 조회
+
+## 사용법
+
+```bash
+npx viruagent-cli list-categories --provider naver
+```
+
+카테고리가 지정되지 않은 경우, 사용자에게 어떤 카테고리를 사용할지 질문.
+
+## See Also
+
+va-naver, va-naver-publish

package/skills/va-naver-draft/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: va-naver-draft
+version: 1.0.0
+description: "Naver: 블로그 글 임시저장 (private 포스트로 저장)"
+metadata:
+  category: "command"
+  provider: "naver"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli save-draft --help"
+---
+
+# va-naver-draft — Naver 임시저장
+
+## 사용법
+
+```bash
+npx viruagent-cli save-draft \
+  --provider naver \
+  --title "Draft Title" \
+  --content "<h2>...</h2><p>...</p>" \
+  --category <id> \
+  --tags "tag1,tag2,tag3,tag4,tag5" \
+  --related-image-keywords "keyword1,keyword2"
+```
+
+`publish` 대신 `save-draft` 사용. 옵션은 동일.
+
+**참고**: Naver는 실제 임시저장 API가 없습니다. `save-draft`는 `--visibility private`로 비공개 글을 생성합니다.
+
+## See Also
+
+va-naver-publish, va-naver, va-shared

package/skills/va-naver-login/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: va-naver-login
+version: 1.0.0
+description: "Naver: 네이버 계정 로그인 (manual 브라우저 모드 지원)"
+metadata:
+  category: "command"
+  provider: "naver"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli login --help"
+---
+
+# va-naver-login — Naver 로그인
+
+## 인증 상태 확인
+
+```bash
+npx viruagent-cli status --provider naver
+```
+
+## 자동 로그인
+
+```bash
+npx viruagent-cli login --provider naver --username <naver_id> --password <pass>
+```
+
+## 수동 로그인 (브라우저)
+
+```bash
+npx viruagent-cli login --provider naver --manual
+```
+
+### 옵션
+
+| 플래그 | 설명 | 기본값 |
+|--------|------|--------|
+| `--username` | 네이버 아이디 | - |
+| `--password` | 네이버 비밀번호 | - |
+| `--manual` | 수동 로그인 모드 | false |
+| `--headless` | 헤드리스 모드 | false |
+
+### 봇 감지 대응
+
+네이버는 봇 감지가 강력합니다. 자동 로그인 실패 시 `--manual` 모드로 브라우저에서 직접 로그인하세요.
+
+### 환경변수
+
+`NAVER_USERNAME` / `NAVER_PASSWORD` 설정 시 자동 사용.
+
+## 로그아웃
+
+```bash
+npx viruagent-cli logout --provider naver
+```
+
+## See Also
+
+va-naver, va-shared

package/skills/va-naver-posts/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: va-naver-posts
+version: 1.0.0
+description: "Naver: 글 목록 조회 및 개별 글 읽기"
+metadata:
+  category: "command"
+  provider: "naver"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli list-posts --help"
+---
+
+# va-naver-posts — 글 목록 & 읽기
+
+## 글 목록
+
+```bash
+npx viruagent-cli list-posts --provider naver --limit 10
+```
+
+| 플래그 | 설명 | 기본값 |
+|--------|------|--------|
+| `--limit` | 조회할 글 수 | 20 |
+
+## 글 읽기
+
+```bash
+npx viruagent-cli read-post --provider naver --post-id <id>
+```
+
+| 플래그 | 설명 |
+|--------|------|
+| `--post-id` | 글 ID |
+| `--include-draft` | 임시저장 포함 |
+
+## See Also
+
+va-naver, va-shared

package/skills/va-naver-publish/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: va-naver-publish
+version: 1.0.0
+description: "Naver: 블로그 글 발행 (plain HTML + SE Editor 변환)"
+metadata:
+  category: "command"
+  provider: "naver"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli publish --help"
+---
+
+# va-naver-publish — Naver 글 발행
+
+## 사용법
+
+```bash
+npx viruagent-cli publish \
+  --provider naver \
+  --title "Post Title" \
+  --content "<h2>...</h2><p>...</p>" \
+  --category <id> \
+  --tags "tag1,tag2,tag3,tag4,tag5" \
+  --visibility public \
+  --related-image-keywords "keyword1,keyword2" \
+  --image-upload-limit 1 \
+  --minimum-image-count 1
+```
+
+### 옵션
+
+| 플래그 | 설명 | 기본값 |
+|--------|------|--------|
+| `--title` | 글 제목 | (필수) |
+| `--content` | HTML 콘텐츠 | - |
+| `--content-file` | HTML 파일 경로 (절대) | - |
+| `--category` | 카테고리 ID | - |
+| `--tags` | 쉼표 구분 태그 (5개) | - |
+| `--visibility` | public / private | public |
+| `--related-image-keywords` | 이미지 검색 키워드 (영어) | - |
+| `--image-upload-limit` | 최대 이미지 수 | 1 |
+| `--minimum-image-count` | 최소 이미지 수 | 1 |
+| `--dry-run` | 파라미터만 검증 | false |
+
+## HTML 템플릿
+
+```html
+<!-- 1. Hook -->
+<blockquote>[한 문장 임팩트]</blockquote>
+<p>&nbsp;</p>
+
+<!-- 2. 서론 (2~3단락) -->
+<p>[맥락과 공감, 3~5문장]</p>
+<p>[이 글에서 다룰 내용]</p>
+<p>&nbsp;</p>
+
+<!-- 3. 본문 (3~4 섹션) -->
+<h2>[섹션 제목]</h2>
+<p>[3~5문장, 근거 포함]</p>
+<p>[분석과 시사점]</p>
+<p>&nbsp;</p>
+
+<!-- 4. 핵심 정리 -->
+<h2>핵심 정리</h2>
+<ul>
+  <li>[핵심 1]</li>
+  <li>[핵심 2]</li>
+  <li>[핵심 3]</li>
+</ul>
+<p>&nbsp;</p>
+
+<!-- 5. 마무리 -->
+<p>[구체적 실행 제안]</p>
+```
+
+### Naver 전용 규칙
+
+- 일반 `<p>` 태그 사용 — `data-ke-*` 속성 사용 금지
+- `<p>&nbsp;</p>`로 여백 처리
+- 일반 `<blockquote>` 사용 — Naver가 인용 컴포넌트로 자동 변환
+- HTML은 SE Editor 컴포넌트로 서버에서 자동 변환
+
+## 이미지 규칙
+
+- `--related-image-keywords`에 영어 키워드 2~3개 항상 포함
+- `--image-upload-limit 1`, `--minimum-image-count 1` 설정
+- `--no-auto-upload-images`는 사용자 명시 요청 시만
+
+## 발행 후 검증
+
+```bash
+npx viruagent-cli list-posts --provider naver --limit 1
+```
+
+## See Also
+
+va-naver, va-naver-draft, va-shared

package/skills/va-shared/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: viruagent
+version: 1.0.0
+description: "viruagent-cli — 블로그/SNS 자동화 에이전트. 플랫폼 라우팅, 글쓰기 규칙, 에러 처리."
+triggers:
+  - viruagent
+  - 블로그
+  - blog
+  - 인스타
+  - instagram
+  - 티스토리
+  - 네이버
+  - 좋아요
+  - 댓글
+  - 팔로우
+metadata:
+  category: "router"
+  requires:
+    bins: ["viruagent-cli"]
+---
+
+# viruagent — 블로그/SNS 자동화 에이전트
+
+viruagent-cli를 사용하는 블로그/SNS 자동화 에이전트입니다.
+사용자 요청에 따라 적절한 스킬 파일을 읽고 실행합니다.
+
+## Platform Router
+
+| 트리거 | 스킬 파일 |
+|--------|-----------|
+| 티스토리, tistory | `va-tistory/SKILL.md` |
+| 네이버, naver | `va-naver/SKILL.md` |
+| 인스타, instagram, 좋아요, 댓글, 팔로우 | `va-insta/SKILL.md` |
+| 블로그 써줘 (플랫폼 미지정) | 사용자에게 플랫폼 질문 |
+| 블로거 역할 | `persona-blogger/SKILL.md` |
+| 인플루언서 관리 | `persona-influencer-manager/SKILL.md` |
+| SNS 마케팅 | `persona-sns-marketer/SKILL.md` |
+
+## 스킬 파일 위치
+
+모든 하위 스킬은 viruagent-cli 패키지 내 `skills/` 디렉토리에 있습니다:
+
+```
+SKILLS_DIR: <viruagent-cli 설치 경로>/skills/
+```
+
+사용자의 요청을 분석한 뒤, 해당 스킬 파일을 Read 도구로 읽어서 지침을 따르세요.
+
+### 단일 명령 스킬
+
+| 스킬 | 파일 | 설명 |
+|------|------|------|
+| va-tistory | `va-tistory/SKILL.md` | Tistory 개요 |
+| va-tistory-login | `va-tistory-login/SKILL.md` | 로그인 (2FA) |
+| va-tistory-publish | `va-tistory-publish/SKILL.md` | 글 발행 |
+| va-tistory-draft | `va-tistory-draft/SKILL.md` | 임시저장 |
+| va-tistory-categories | `va-tistory-categories/SKILL.md` | 카테고리 조회 |
+| va-tistory-posts | `va-tistory-posts/SKILL.md` | 글 목록/읽기 |
+| va-naver | `va-naver/SKILL.md` | Naver 개요 |
+| va-naver-login | `va-naver-login/SKILL.md` | 로그인 (manual) |
+| va-naver-publish | `va-naver-publish/SKILL.md` | 글 발행 |
+| va-naver-draft | `va-naver-draft/SKILL.md` | 임시저장 |
+| va-naver-categories | `va-naver-categories/SKILL.md` | 카테고리 조회 |
+| va-naver-posts | `va-naver-posts/SKILL.md` | 글 목록/읽기 |
+| va-insta | `va-insta/SKILL.md` | Instagram 개요 + 레이트리밋 |
+| va-insta-login | `va-insta-login/SKILL.md` | 로그인 + 챌린지 |
+| va-insta-like | `va-insta-like/SKILL.md` | 좋아요 |
+| va-insta-comment | `va-insta-comment/SKILL.md` | 댓글 |
+| va-insta-follow | `va-insta-follow/SKILL.md` | 팔로우/언팔 |
+| va-insta-dm | `va-insta-dm/SKILL.md` | DM |
+| va-insta-feed | `va-insta-feed/SKILL.md` | 피드/프로필/분석 |
+
+### 페르소나 스킬
+
+| 스킬 | 파일 | 설명 |
+|------|------|------|
+| persona-blogger | `persona-blogger/SKILL.md` | 블로거 역할 |
+| persona-influencer-manager | `persona-influencer-manager/SKILL.md` | 인플루언서 매니저 |
+| persona-sns-marketer | `persona-sns-marketer/SKILL.md` | SNS 마케터 |
+
+### 레시피 스킬
+
+| 스킬 | 파일 | 설명 |
+|------|------|------|
+| recipe-blog-publish | `recipe-blog-publish/SKILL.md` | 블로그 발행 워크플로우 |
+| recipe-cross-post | `recipe-cross-post/SKILL.md` | 블로그 → 인스타 홍보 |
+| recipe-engage-feed | `recipe-engage-feed/SKILL.md` | 피드 인게이지먼트 |
+| recipe-daily-engagement | `recipe-daily-engagement/SKILL.md` | 일일 루틴 |
+| recipe-grow-followers | `recipe-grow-followers/SKILL.md` | 팔로워 성장 |
+
+## Quick Reference
+
+```bash
+npx viruagent-cli list-providers
+npx viruagent-cli --spec
+npx viruagent-cli --spec <command>
+```
+
+모든 응답은 JSON: `{ "ok": true, "data": {...} }` 성공, `{ "ok": false, "error": "...", "message": "...", "hint": "..." }` 실패.
+
+## 글쓰기 규칙 (블로그 공통)
+
+- **제목**: 핵심 키워드 포함. 10~20자. 짧고 임팩트 있게.
+- **분량**: 3000~4000자. 깊이 있게, 양 채우기 아닌 실질 내용.
+- **단락**: 3~5문장씩. 1~2문장 단락 반복 금지.
+- **서론**: 2~3개 단락으로 맥락과 독자 공감 형성.
+- **본문 섹션**: 각 h2 섹션에 2~3개 실질 단락. 바로 목록 나열 금지.
+- **목록**: 3개 이상 구체적 항목일 때만 사용.
+- **근거**: 본문 섹션마다 전문가 인용, 데이터, 실제 사례 중 하나 포함.
+- **관점 전환**: 독자 생각을 리프레이밍하는 포인트 최소 1곳.
+- **전환**: 섹션 간 브릿지 문장으로 연결.
+- **강조**: `<strong>`으로 핵심 용어 (섹션당 2~3개 max).
+- **소제목**: `<h2>` 사용. `<h3>` 사용 금지.
+- **톤**: 대화체이되 실질적 내용.
+- **마무리**: 구체적이고 실행 가능한 제안으로 끝.
+- **SEO**: 제목, 첫 단락, h2 최소 1곳에 핵심 키워드 배치.
+- **태그**: 정확히 5개, 쉼표 구분, 글 언어와 일치.
+
+## 공통 에러 처리
+
+| 에러 | 조치 |
+|------|------|
+| `NOT_LOGGED_IN` / `SESSION_EXPIRED` | `login` 재실행 |
+| `MISSING_CONTENT` | `--content` 또는 `--content-file` 확인 |
+| `PROVIDER_NOT_FOUND` | `list-providers`로 확인 |
+| `INVALID_POST_ID` | `list-posts`로 ID 확인 |
+
+## 중요 사항
+
+- 실제 발행 전 `--dry-run`으로 파라미터 검증
+- 콘텐츠는 유효한 HTML이어야 함
+- 기본 프로바이더는 `tistory`
+- `--content-file`은 절대 경로 사용

package/skills/va-tistory/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: va-tistory
+version: 1.0.0
+description: "Tistory 블로그: 명령 개요 및 플랫폼 특화 규칙"
+metadata:
+  category: "overview"
+  provider: "tistory"
+  requires:
+    bins: ["viruagent-cli"]
+---
+
+# va-tistory — Tistory 블로그 개요
+
+Tistory 블로그 퍼블리싱을 위한 viruagent-cli 가이드. 항상 `--provider tistory` 사용.
+
+## 명령 목록
+
+| 명령 | 스킬 | 설명 |
+|------|------|------|
+| login | va-tistory-login | 카카오 로그인 (2FA 포함) |
+| publish | va-tistory-publish | 글 발행 |
+| save-draft | va-tistory-draft | 임시저장 |
+| list-categories | va-tistory-categories | 카테고리 조회 |
+| list-posts, read-post | va-tistory-posts | 글 목록/읽기 |
+
+## Tistory HTML 규칙
+
+Tistory는 `data-ke-*` 속성을 사용합니다:
+- 본문: `<p data-ke-size="size18">`
+- 여백: `<p data-ke-size="size16">&nbsp;</p>`
+- 인용: `<blockquote data-ke-style="style2">`
+
+## 환경변수
+
+```
+TISTORY_USERNAME=
+TISTORY_PASSWORD=
+```
+
+## See Also
+
+va-shared, va-tistory-login, va-tistory-publish, va-tistory-draft, va-tistory-categories, va-tistory-posts

package/skills/va-tistory-categories/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: va-tistory-categories
+version: 1.0.0
+description: "Tistory: 블로그 카테고리 목록 조회"
+metadata:
+  category: "command"
+  provider: "tistory"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli list-categories --help"
+---
+
+# va-tistory-categories — 카테고리 조회
+
+## 사용법
+
+```bash
+npx viruagent-cli list-categories --provider tistory
+```
+
+카테고리가 지정되지 않은 경우, 사용자에게 어떤 카테고리를 사용할지 질문.
+
+## 응답 예시
+
+```json
+{
+  "ok": true,
+  "data": [
+    { "id": "123", "name": "개발" },
+    { "id": "456", "name": "일상" }
+  ]
+}
+```
+
+## See Also
+
+va-tistory, va-tistory-publish

package/skills/va-tistory-draft/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: va-tistory-draft
+version: 1.0.0
+description: "Tistory: 블로그 글 임시저장"
+metadata:
+  category: "command"
+  provider: "tistory"
+  requires:
+    bins: ["viruagent-cli"]
+    cliHelp: "viruagent-cli save-draft --help"
+---
+
+# va-tistory-draft — Tistory 임시저장
+
+## 사용법
+
+```bash
+npx viruagent-cli save-draft \
+  --provider tistory \
+  --title "Draft Title" \
+  --content "<h2>...</h2><p>...</p>" \
+  --category <id> \
+  --tags "tag1,tag2,tag3,tag4,tag5" \
+  --related-image-keywords "keyword1,keyword2"
+```
+
+`publish` 대신 `save-draft` 사용. 옵션은 동일.
+
+## See Also
+
+va-tistory-publish, va-tistory, va-shared