viruagent-cli 0.6.0 → 0.6.1

package/package.json

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

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

@@ -1,7 +1,7 @@
 ---
 name: va-naver-publish
-version: 1.0.0
-description: "Naver: 블로그 글 발행 (plain HTML + SE Editor 변환)"
+version: 2.0.0
+description: "Naver: 블로그 글 발행 — 5종 포맷 템플릿 (story/howto/list/review/qa)"
 metadata:
   category: "command"
   provider: "naver"
@@ -17,14 +17,14 @@ metadata:
 ```bash
 npx viruagent-cli publish \
   --provider naver \
-  --title "Post Title" \
+  --title "제목 (15~25자, 핵심 키워드 앞배치)" \
   --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
+  --related-image-keywords "keyword1 keyword2 keyword3" \
+  --image-upload-limit 5 \
+  --minimum-image-count 3
 ```
 
 ### 옵션
@@ -38,53 +38,293 @@ npx viruagent-cli publish \
 | `--tags` | 쉼표 구분 태그 (5개) | - |
 | `--visibility` | public / private | public |
 | `--related-image-keywords` | 이미지 검색 키워드 (영어) | - |
-| `--image-upload-limit` | 최대 이미지 수 | 1 |
-| `--minimum-image-count` | 최소 이미지 수 | 1 |
+| `--image-upload-limit` | 최대 이미지 수 | 5 |
+| `--minimum-image-count` | 최소 이미지 수 | 3 |
 | `--dry-run` | 파라미터만 검증 | false |
 
-## HTML 템플릿
+---
+
+## 네이버 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
-<!-- 1. Hook -->
-<blockquote>[한 문장 임팩트]</blockquote>
+<!-- 후킹: 패턴 A 또는 C -->
+<blockquote>[임팩트 한 줄 — 독자의 상황을 대변하는 문장]</blockquote>
 <p>&nbsp;</p>
 
-<!-- 2. 서론 (2~3단락) -->
-<p>[맥락과 공감, 3~5문장]</p>
-<p>[이 글에서 다룰 내용]</p>
+<p>[독자 공감 + 내 경험으로 연결 — 3~5문장. "저도 그랬습니다" 식으로 시작]</p>
+<p>[이 글에서 다룰 내용 예고 — 구체적으로]</p>
 <p>&nbsp;</p>
 
-<!-- 3. 본문 (3~4 섹션) -->
-<h2>[섹션 제목]</h2>
-<p>[3~5문장, 근거 포함]</p>
-<p>[분석과 시사점]</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>
 
-<!-- 4. 핵심 정리 -->
 <h2>핵심 정리</h2>
 <ul>
-  <li>[핵심 1]</li>
-  <li>[핵심 2]</li>
-  <li>[핵심 3]</li>
+  <li>[Q1 핵심 답 — 한 줄]</li>
+  <li>[Q2 핵심 답 — 한 줄]</li>
+  <li>[Q3 핵심 답 — 한 줄]</li>
 </ul>
 <p>&nbsp;</p>
 
-<!-- 5. 마무리 -->
-<p>[구체적 실행 제안]</p>
+<p>[추가 궁금한 점은 댓글로 — 독자 참여 유도]</p>
 ```
 
-### Naver 전용 규칙
+---
 
-- 일반 `<p>` 태그 사용 — `data-ke-*` 속성 사용 금지
-- `<p>&nbsp;</p>`로 여백 처리
-- 일반 `<blockquote>` 사용 — Naver가 인용 컴포넌트로 자동 변환
-- HTML은 SE Editor 컴포넌트로 서버에서 자동 변환
+## 포맷 선택 가이드
+
+| 글 주제 | 추천 포맷 |
+|---------|---------|
+| 도구/서비스 소개, 경험 공유 | **story** |
+| 설치법, 사용법, 단계별 방법 | **howto** |
+| 추천 목록, 비교 정리 | **list** |
+| 심층 분석, 솔직 리뷰 | **review** |
+| 개념 설명, 자주 묻는 질문 | **qa** |
+
+---
 
 ## 이미지 규칙
 
-- `--related-image-keywords`에 영어 키워드 2~3개 항상 포함
-- `--image-upload-limit 1`, `--minimum-image-count 1` 설정
-- `--no-auto-upload-images`는 사용자 명시 요청 시만
+- `--related-image-keywords`에 영어 키워드 2~3개 (구체적일수록 좋음)
+- `--image-upload-limit 5`, `--minimum-image-count 3` 기본값
+- 소제목 위에 이미지 배치 — "시각 → 텍스트" 순서가 이해 빠름
+- 이미지 없는 글은 네이버 D.I.A. 평가에서 불리
 
 ## 발행 후 검증
 

package/skills/va-shared/SKILL.md

@@ -100,21 +100,58 @@ npx viruagent-cli --spec <command>
 
 ## 글쓰기 규칙 (블로그 공통)
 
-- **제목**: 핵심 키워드 포함. 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개, 쉼표 구분, 글 언어와 일치.
+### 포맷 선택 (글 성격에 따라 결정)
+| 포맷 | 용도 | 체류시간 | AI탐지 위험 |
+|------|------|---------|-----------|
+| **story** | 경험 후기, 사례, 인사이트 | 최고 | 낮음 |
+| **howto** | 설치법, 단계별 가이드 | 높음 | 중간 |
+| **list** | 추천 목록, 비교 정리 | 낮음 | 높음 |
+| **review** | 심층 분석, 솔직 리뷰 | 높음 | 낮음 |
+| **qa** | 개념 설명, FAQ | 중간 | 중간 |
+
+**기본 추천: story형** — 체류시간 최고, AI 탐지 회피 최적.
+
+### 제목
+- **네이버**: 15~25자, 핵심 키워드 앞배치
+- **티스토리**: 25~35자, 숫자/연도 포함 시 CTR +23%
+- 키워드는 제목 앞쪽에 — 뒤에 오면 검색 가중치 낮음
+
+### 분량
+- **네이버**: 1,500~2,500자 (경쟁 키워드 2,500~3,500자)
+- **티스토리**: 3,000~5,000자 (구글 상위 10위 평균 5,000자)
+
+### 서론 (첫 3문장이 체류시간 결정)
+- **공감형**: 독자 상황 공감 → 반전 → 이 글의 약속
+- **손실 회피형**: 모르면 손해 + 수치 → 해결책 예고
+- **질문형**: 검색 쿼리 그대로 → 데이터 → 내용 예고
+- 도입부에 `<blockquote>`로 임팩트 한 줄 배치
+
+### 본문 구조
+- **단락**: 모바일 기준 2~3문장 (최대 4문장). 공백 줄로 호흡 조절
+- **소제목 간격**: 네이버 300~400자마다 `<h2>`, 티스토리 600~1,000자마다 `<h3>`
+- **티스토리 H태그**: `<h2>` → `<h3>` → `<h4>` 계층 준수. 본문에 `<h1>` 사용 금지
+- **네이버**: `<h2>`만 사용 (h3 불필요)
+- **목차**: 티스토리는 3개 이상 섹션이면 앵커 링크 목차 필수
+- **문장 리듬**: 짧은 문장과 긴 문장을 의도적으로 섞기 (균일하면 AI 탐지)
+
+### 이미지
+- **네이버**: 소제목마다 1장, 총 5~10장 권장
+- **티스토리**: 1~3장 + alt 태그 `핵심키워드 + 설명` 형식 필수
+- 이미지는 설명 단락 **위**에 배치 — 시각 → 텍스트 순서
+
+### AI 탐지 회피 필수 규칙
+- 직접 경험 기반 문장 단락마다 1개 이상
+- "~에 대해 알아보겠습니다", "정리하자면", "마무리로" 금지
+- 균일한 3단락 공식(도입→근거→요약) 반복 금지
+- 모든 섹션을 같은 길이로 쓰지 말 것
+
+### 공통
+- **강조**: `<strong>`으로 핵심 용어 (섹션당 2~3개 max)
+- **근거**: 섹션마다 데이터, 수치, 실제 사례 중 하나 포함
+- **내부 링크**: 티스토리는 관련 글 2~4개 연결 (체류시간 35% 연장)
+- **마무리**: 구체적 행동 제안 + 댓글/공유 유도
+- **태그**: 정확히 5개, 쉼표 구분, 글 언어와 일치
+- **SEO**: 제목, 첫 단락, 소제목 최소 1곳에 핵심 키워드 배치
 
 ## 공통 에러 처리