viruagent-cli 0.5.1 → 0.6.1

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,337 @@
+---
+name: va-naver-publish
+version: 2.0.0
+description: "Naver: 블로그 글 발행 — 5종 포맷 템플릿 (story/howto/list/review/qa)"
+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 "제목 (15~25자, 핵심 키워드 앞배치)" \
+  --content "<h2>...</h2><p>...</p>" \
+  --category <id> \
+  --tags "tag1,tag2,tag3,tag4,tag5" \
+  --visibility public \
+  --related-image-keywords "keyword1 keyword2 keyword3" \
+  --image-upload-limit 5 \
+  --minimum-image-count 3
+```
+
+### 옵션
+
+| 플래그 | 설명 | 기본값 |
+|--------|------|--------|
+| `--title` | 글 제목 | (필수) |
+| `--content` | HTML 콘텐츠 | - |
+| `--content-file` | HTML 파일 경로 (절대) | - |
+| `--category` | 카테고리 ID | - |
+| `--tags` | 쉼표 구분 태그 (5개) | - |
+| `--visibility` | public / private | public |
+| `--related-image-keywords` | 이미지 검색 키워드 (영어) | - |
+| `--image-upload-limit` | 최대 이미지 수 | 5 |
+| `--minimum-image-count` | 최소 이미지 수 | 3 |
+| `--dry-run` | 파라미터만 검증 | false |
+
+---
+
+## 네이버 SEO 핵심 원칙
+
+- **제목**: 15~25자, 핵심 키워드를 앞쪽에 배치
+- **글자 수**: 1,500~2,500자 (경쟁 키워드는 2,500~3,500자)
+- **이미지**: 소제목마다 1장씩 총 5~10장 권장 (직접 촬영/제작 우선)
+- **키워드**: 제목+본문 합산 5~6개, 단락당 1~2개 자연스럽게 분산
+- **소제목 간격**: 300~400자마다 `<h2>` 1개 (h3 사용 금지)
+- **체류시간 신호**: D.I.A. 알고리즘은 실제 스크롤 깊이와 체류시간을 측정
+- **경험 문장**: 단락마다 직접 경험 기반 문장 1개 이상 필수 (AI 탐지 회피)
+
+### 피해야 할 패턴
+- `data-ke-*` 속성 사용 금지 (일반 HTML만)
+- 키워드 3회 이상 연속 반복 금지
+- 3단락 공식 반복 (도입→근거→요약) 패턴 — AI 탐지 위험
+- 균일한 문장 길이 — 짧은 문장과 긴 문장을 의도적으로 섞을 것
+
+---
+
+## 서론 후킹 패턴 3종 (첫 3문장이 체류시간 결정)
+
+### 패턴 A — 공감형 (범용, 정보성 글)
+```html
+<p>[독자가 이미 겪고 있는 상황을 1문장으로 정확히 표현]</p>
+<p>그런데 사실 그 이유는 생각보다 단순합니다. [반전 핵심 한 줄]</p>
+<p>이 글에서는 [구체적 약속 — 읽으면 얻는 것]을 다룹니다.</p>
+```
+
+### 패턴 B — 손실 회피형 (경쟁 키워드, 클릭 유지)
+```html
+<blockquote>[모르면 손해인 핵심 한 줄. 구체적 수치 포함]</blockquote>
+<p>실제로 [통계나 사례 — 신뢰 부여]. 대부분은 이 차이를 모르고 넘어갑니다.</p>
+<p>지금부터 [해결책 예고]를 정리해 드립니다.</p>
+```
+
+### 패턴 C — 질문형 (전문성 어필, 심화 콘텐츠)
+```html
+<p>[독자가 검색창에 치는 질문을 그대로 첫 문장으로]</p>
+<p>[데이터나 통계로 문제의 크기를 보여줌]. 저도 처음엔 이 답을 찾는 데 [시간]이 걸렸습니다.</p>
+<p>지금부터 [핵심 내용 예고]합니다.</p>
+```
+
+---
+
+## 포맷 5종 템플릿
+
+글 성격에 맞는 포맷을 선택하세요. **기본 추천: story형** (체류시간 최고, AI 탐지 회피 최적).
+
+---
+
+### 1. story형 — 스토리텔링 (체류시간 최고, AI 탐지 낮음)
+경험 후기, 사례 공유, 인사이트 전달에 적합.
+
+```html
+<!-- 후킹: 패턴 A 또는 C -->
+<blockquote>[임팩트 한 줄 — 독자의 상황을 대변하는 문장]</blockquote>
+<p>&nbsp;</p>
+
+<p>[독자 공감 + 내 경험으로 연결 — 3~5문장. "저도 그랬습니다" 식으로 시작]</p>
+<p>[이 글에서 다룰 내용 예고 — 구체적으로]</p>
+<p>&nbsp;</p>
+
+<h2>[섹션 1 — 문제 상황 묘사]</h2>
+<p>[직접 겪은 구체적 상황 — 날짜, 수치, 감정 포함. 3~5문장]</p>
+<p>[그 상황에서 발견한 인사이트 — 독자가 몰랐던 관점]</p>
+<p>&nbsp;</p>
+
+<h2>[섹션 2 — 전환점 또는 발견]</h2>
+<p>[문제를 어떻게 바라보게 됐는지 — BAB 구조의 After 단계]</p>
+<p>[구체적 수치나 결과 언급]</p>
+<p>&nbsp;</p>
+
+<h2>[섹션 3 — 실전 적용법]</h2>
+<p>[독자가 바로 쓸 수 있는 방법 — 단계보다 맥락 중심으로]</p>
+<p>[예상 실패 포인트와 극복법 — 경험 기반으로]</p>
+<p>&nbsp;</p>
+
+<h2>[섹션 4 — 의외의 발견 또는 여담]</h2>
+<p>[예상 못한 결과나 부가적 인사이트 — 이 섹션이 인간미를 만듦]</p>
+<p>&nbsp;</p>
+
+<h2>마무리</h2>
+<p>[핵심 요약 — 1~2문장]</p>
+<p>[독자에게 구체적 행동 제안 — "지금 당장 해볼 수 있는 한 가지"]</p>
+<p>[공유/댓글 유도 — 자연스럽게]</p>
+```
+
+---
+
+### 2. howto형 — 튜토리얼 (정보 쿼리 1위, 체류시간 높음)
+설치법, 사용법, 단계별 가이드에 적합.
+
+```html
+<!-- 후킹: 패턴 B -->
+<blockquote>[이 글 하나로 [X] 할 수 있습니다 — 구체적 약속]</blockquote>
+<p>&nbsp;</p>
+
+<p>[왜 이 방법이 필요한지 — 기존 방식의 문제점. 2~3문장]</p>
+<p>[이 글을 끝까지 읽으면 얻는 것 — 구체적]</p>
+<p>&nbsp;</p>
+
+<h2>시작 전 준비물</h2>
+<p>[필요한 것들을 설명 — 단순 나열이 아닌 왜 필요한지 이유 포함]</p>
+<ul>
+  <li>[준비물 1] — [이유]</li>
+  <li>[준비물 2] — [이유]</li>
+</ul>
+<p>&nbsp;</p>
+
+<h2>1단계 — [단계명]</h2>
+<p>[무엇을 하는 단계인지 먼저 설명 — 맥락 제공]</p>
+<p>[구체적 방법 — 스크린샷/이미지 직후 텍스트로 설명]</p>
+<p>[이 단계에서 흔히 하는 실수와 예방법]</p>
+<p>&nbsp;</p>
+
+<h2>2단계 — [단계명]</h2>
+<p>[맥락 → 방법 → 주의사항 순서]</p>
+<p>&nbsp;</p>
+
+<h2>3단계 — [단계명]</h2>
+<p>[맥락 → 방법 → 주의사항 순서]</p>
+<p>&nbsp;</p>
+
+<h2>완료 확인 방법</h2>
+<p>[잘 됐는지 확인하는 방법 — 직접 경험 기반으로]</p>
+<p>&nbsp;</p>
+
+<h2>자주 묻는 질문</h2>
+<p><strong>Q. [가장 흔한 질문]</strong></p>
+<p>A. [구체적 답변]</p>
+<p>&nbsp;</p>
+<p><strong>Q. [두 번째 질문]</strong></p>
+<p>A. [구체적 답변]</p>
+<p>&nbsp;</p>
+
+<p>[마무리 — 완료 축하 + 다음 단계 제안]</p>
+```
+
+---
+
+### 3. list형 — 리스트 정리 (CTR 높음, 초기 트래픽 확보)
+"베스트 N", "추천 N선", 비교 정리글에 적합. 단, 단순 나열 금지.
+
+```html
+<!-- 후킹: 패턴 B -->
+<blockquote>[N가지 중 실제로 쓸 만한 건 [X]개입니다 — 기대 역전]</blockquote>
+<p>&nbsp;</p>
+
+<p>[왜 이 목록이 필요한지 — 선택의 어려움 공감. 2~3문장]</p>
+<p>[선별 기준 명시 — "제가 직접 [기간] 동안 사용/테스트한 기준으로"]</p>
+<p>&nbsp;</p>
+
+<h2>1. [항목명] — [핵심 특징 한 줄]</h2>
+<p>[이게 왜 1위인지 — 단순 설명이 아닌 직접 경험 기반 이유]</p>
+<p>[구체적 수치나 사례. 단점도 솔직하게 1~2줄]</p>
+<p>&nbsp;</p>
+
+<h2>2. [항목명] — [핵심 특징 한 줄]</h2>
+<p>[특징과 실사용 경험 — 앞 항목과 차별점 명시]</p>
+<p>&nbsp;</p>
+
+<h2>3. [항목명] — [핵심 특징 한 줄]</h2>
+<p>[특징과 실사용 경험]</p>
+<p>&nbsp;</p>
+
+<!-- 4~N개 동일 패턴 반복 -->
+
+<h2>한눈에 비교</h2>
+<p>[표로 정리 — 3개 이상 항목 비교 시 가독성 최고]</p>
+<p>&nbsp;</p>
+
+<h2>결론 — 상황별 추천</h2>
+<p>[모든 사람에게 같은 걸 추천하지 말 것 — 상황별 최적 선택 제시]</p>
+<p>[내 개인 픽 + 이유]</p>
+<p>&nbsp;</p>
+
+<p>[댓글 유도 — "여러분이 써본 것 중 좋았던 건 무엇인가요?"]</p>
+```
+
+---
+
+### 4. review형 — 분석/리뷰 (전문성 최고, AI 탐지 낮음)
+도구 분석, 서비스 리뷰, 책/영상 리뷰에 적합.
+
+```html
+<!-- 후킹: 패턴 C -->
+<blockquote>[핵심 결론을 먼저 — "결론부터 말하면: [한 줄 평가]"]</blockquote>
+<p>&nbsp;</p>
+
+<p>[어떤 계기로 사용/분석하게 됐는지 — 배경 스토리. 2~3문장]</p>
+<p>[이 리뷰의 관점/기준 명시 — "저는 [직군/상황]의 입장에서 평가했습니다"]</p>
+<p>&nbsp;</p>
+
+<h2>한줄 요약</h2>
+<p>[장점 2~3가지 + 단점 1~2가지를 솔직하게. 단점 없는 리뷰는 신뢰도 하락]</p>
+<p>&nbsp;</p>
+
+<h2>[분석 섹션 1 — 가장 중요한 특징]</h2>
+<p>[특징 설명 → 실제 사용 경험 → 내 평가 순서]</p>
+<p>[수치나 비교 대상 포함]</p>
+<p>&nbsp;</p>
+
+<h2>[분석 섹션 2]</h2>
+<p>[동일 구조]</p>
+<p>&nbsp;</p>
+
+<h2>[분석 섹션 3]</h2>
+<p>[동일 구조]</p>
+<p>&nbsp;</p>
+
+<h2>경쟁 제품/서비스와 비교</h2>
+<p>[직접 비교 — 어떤 상황에서 이게 낫고, 어떤 상황에서 다른 게 나은지]</p>
+<p>&nbsp;</p>
+
+<h2>이런 분께 추천합니다</h2>
+<p>[타겟을 명확히 — 맞는 사람과 맞지 않는 사람 모두 언급]</p>
+<p>&nbsp;</p>
+
+<p>[최종 점수나 별점 + 총평 1~2문장]</p>
+<p>[관련 글 링크 유도]</p>
+```
+
+---
+
+### 5. qa형 — Q&A (Featured Snippet 최적, 롱테일 키워드)
+개념 설명, FAQ, "~가 뭔가요?" 쿼리에 적합.
+
+```html
+<!-- 후킹: 패턴 C -->
+<p>[가장 많이 검색되는 질문을 첫 문장으로 — 검색창 그대로]</p>
+<p>[이 질문이 중요한 이유 + 이 글에서 다룰 범위]</p>
+<p>&nbsp;</p>
+
+<h2>[핵심 질문 1]</h2>
+<p>[직접 답변 — 첫 문장에 핵심 답 먼저. 검색 의도에 즉각 응답]</p>
+<p>[부연 설명 — 왜 그런지, 어떤 경우에 해당하는지]</p>
+<p>[실제 사례나 예시]</p>
+<p>&nbsp;</p>
+
+<h2>[핵심 질문 2]</h2>
+<p>[동일 구조 — 답 먼저, 설명 나중]</p>
+<p>&nbsp;</p>
+
+<h2>[핵심 질문 3]</h2>
+<p>[동일 구조]</p>
+<p>&nbsp;</p>
+
+<h2>[핵심 질문 4 — 심화 또는 의외의 질문]</h2>
+<p>[이 섹션은 독자가 생각 못 했던 질문 — 전문성 어필]</p>
+<p>&nbsp;</p>
+
+<h2>핵심 정리</h2>
+<ul>
+  <li>[Q1 핵심 답 — 한 줄]</li>
+  <li>[Q2 핵심 답 — 한 줄]</li>
+  <li>[Q3 핵심 답 — 한 줄]</li>
+</ul>
+<p>&nbsp;</p>
+
+<p>[추가 궁금한 점은 댓글로 — 독자 참여 유도]</p>
+```
+
+---
+
+## 포맷 선택 가이드
+
+| 글 주제 | 추천 포맷 |
+|---------|---------|
+| 도구/서비스 소개, 경험 공유 | **story** |
+| 설치법, 사용법, 단계별 방법 | **howto** |
+| 추천 목록, 비교 정리 | **list** |
+| 심층 분석, 솔직 리뷰 | **review** |
+| 개념 설명, 자주 묻는 질문 | **qa** |
+
+---
+
+## 이미지 규칙
+
+- `--related-image-keywords`에 영어 키워드 2~3개 (구체적일수록 좋음)
+- `--image-upload-limit 5`, `--minimum-image-count 3` 기본값
+- 소제목 위에 이미지 배치 — "시각 → 텍스트" 순서가 이해 빠름
+- 이미지 없는 글은 네이버 D.I.A. 평가에서 불리
+
+## 발행 후 검증
+
+```bash
+npx viruagent-cli list-posts --provider naver --limit 1
+```
+
+## See Also
+
+va-naver, va-naver-draft, va-shared