va-naver-publish

Naver: 블로그 글 발행 — 5종 포맷 템플릿 (story/howto/list/review/qa)

va-naver-publish — Naver 글 발행

사용법

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글 제목(필수)
--contentHTML 콘텐츠-
--content-fileHTML 파일 경로 (절대)-
--category카테고리 ID-
--tags쉼표 구분 태그 (5개)-
--visibilitypublic / privatepublic
--related-image-keywords이미지 검색 키워드 (영어)-
--image-file로컬 이미지 파일 경로 (JPEG/PNG)-
--image-urls쉼표 구분 이미지 URL-
--image-upload-limit최대 이미지 수5
--minimum-image-count최소 이미지 수3
--dry-run파라미터만 검증false

네이버 SEO 핵심 원칙

  • 제목: 15~25자, 핵심 키워드를 앞쪽에 배치
  • 글자 수: 1,5002,500자 (경쟁 키워드는 2,5003,500자)
  • 이미지: 소제목마다 1장씩 총 5~10장 권장 (직접 촬영/제작 우선)
  • 키워드: 제목+본문 합산 56개, 단락당 12개 자연스럽게 분산
  • 소제목 간격: 300~400자마다 <h2> 1개 (h3 사용 금지)
  • 체류시간 신호: D.I.A. 알고리즘은 실제 스크롤 깊이와 체류시간을 측정
  • 경험 문장: 단락마다 직접 경험 기반 문장 1개 이상 필수 (AI 탐지 회피)

피해야 할 패턴

  • data-ke-* 속성 사용 금지 (일반 HTML만)
  • 키워드 3회 이상 연속 반복 금지
  • 3단락 공식 반복 (도입→근거→요약) 패턴 — AI 탐지 위험
  • 균일한 문장 길이 — 짧은 문장과 긴 문장을 의도적으로 섞을 것

서론 후킹 패턴 3종 (첫 3문장이 체류시간 결정)

패턴 A — 공감형 (범용, 정보성 글)

<p>[독자가 이미 겪고 있는 상황을 1문장으로 정확히 표현]</p>
<p>그런데 사실 그 이유는 생각보다 단순합니다. [반전 핵심 한 줄]</p>
<p>이 글에서는 [구체적 약속 — 읽으면 얻는 것]을 다룹니다.</p>

패턴 B — 손실 회피형 (경쟁 키워드, 클릭 유지)

<blockquote>[모르면 손해인 핵심 한 줄. 구체적 수치 포함]</blockquote>
<p>실제로 [통계나 사례 — 신뢰 부여]. 대부분은 이 차이를 모르고 넘어갑니다.</p>
<p>지금부터 [해결책 예고]를 정리해 드립니다.</p>

패턴 C — 질문형 (전문성 어필, 심화 콘텐츠)

<p>[독자가 검색창에 치는 질문을 그대로 첫 문장으로]</p>
<p>[데이터나 통계로 문제의 크기를 보여줌]. 저도 처음엔 이 답을 찾는 데 [시간]이 걸렸습니다.</p>
<p>지금부터 [핵심 내용 예고]합니다.</p>

포맷 5종 템플릿

글 성격에 맞는 포맷을 선택하세요. 기본 추천: story형 (체류시간 최고, AI 탐지 회피 최적).

1. story형 — 스토리텔링 (체류시간 최고, AI 탐지 낮음)

경험 후기, 사례 공유, 인사이트 전달에 적합.

<!-- 후킹: 패턴 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위, 체류시간 높음)

설치법, 사용법, 단계별 가이드에 적합.

<!-- 후킹: 패턴 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선", 비교 정리글에 적합. 단, 단순 나열 금지.

<!-- 후킹: 패턴 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 탐지 낮음)

도구 분석, 서비스 리뷰, 책/영상 리뷰에 적합.

<!-- 후킹: 패턴 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, "~가 뭔가요?" 쿼리에 적합.

<!-- 후킹: 패턴 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

이미지 규칙

  • --image-file /path/to/image.jpg — 로컬 파일 직접 업로드 (URL 없이 사용 가능)
  • --related-image-keywords에 영어 키워드 2~3개 (구체적일수록 좋음)
  • --image-upload-limit 5, --minimum-image-count 3 기본값
  • 소제목 위에 이미지 배치 — "시각 → 텍스트" 순서가 이해 빠름
  • 이미지 없는 글은 네이버 D.I.A. 평가에서 불리

발행 후 검증

npx viruagent-cli list-posts --provider naver --limit 1

See Also

va-naver, va-naver-draft, va-shared