va-tistory-publish

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

va-tistory-publish — Tistory 글 발행

사용법

npx viruagent-cli publish \
  --provider tistory \
  --title "제목 (25~35자, 핵심 키워드 앞배치)" \
  --content "<h2>...</h2><p>...</p>" \
  --category <id> \
  --tags "tag1,tag2,tag3,tag4,tag5" \
  --visibility public \
  --related-image-keywords "keyword1 keyword2 keyword3" \
  --image-upload-limit 3 \
  --minimum-image-count 1

옵션

플래그설명기본값
--title글 제목(필수)
--contentHTML 콘텐츠-
--content-fileHTML 파일 경로 (절대)-
--category카테고리 ID-
--tags쉼표 구분 태그 (5개)-
--visibilitypublic / privatepublic
--related-image-keywords이미지 검색 키워드 (영어)-
--image-upload-limit최대 이미지 수3
--minimum-image-count최소 이미지 수1
--dry-run파라미터만 검증false

티스토리 SEO 핵심 원칙 (구글 기준)

  • 제목: 25~35자, 핵심 키워드를 앞쪽에 배치. 숫자/연도 포함 시 CTR +23%
  • 글자 수: 정보성 글 3,000~5,000자, 경쟁 키워드 5,000자 이상
  • H태그 계층: 블로그 타이틀이 h1 → 본문은 h2 → h3 → h4 순서. 본문에 h1 사용 금지
  • 소제목 간격: 6001,000자(약 300500단어)마다 h3 1개
  • 목차: 3개 이상 섹션이면 앵커 링크 목차 삽입 (Featured Snippet 진입 확률 상승)
  • 이미지 alt 태그: 반드시 핵심키워드 + 설명 형식으로 작성
  • 내부 링크: 실제 발행된 URL이 제공된 경우에만 삽입. URL 없으면 섹션 전체 생략 (가짜 링크 절대 금지)
  • E-E-A-T: 직접 경험 기반 문장, 데이터/출처 인용, 작성자 관점 명시

Tistory HTML 규칙

  • data-ke-* 속성 사용 — Tistory 에디터가 자동 처리하므로 일반 HTML로 작성
  • 이미지 삽입 후 alt 속성 추가 필수
  • <blockquote> 사용 가능 (티스토리가 스타일 자동 적용)

피해야 할 패턴

  • 본문에 <h1> 직접 사용 (블로그 타이틀과 중복)
  • <h2> 건너뛰고 <h3> 바로 사용
  • 균일한 3단락 공식 반복 — AI 탐지 위험
  • 이미지 alt 태그 비워두기 (이미지 SEO 가치 전체 손실)

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

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

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

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

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

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

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

목차 블록 (3개 이상 섹션이면 항상 삽입)

<h2>목차</h2>
<ul>
  <li><a href="#section1">[섹션 1 제목]</a></li>
  <li><a href="#section2">[섹션 2 제목]</a></li>
  <li><a href="#section3">[섹션 3 제목]</a></li>
  <li><a href="#section4">[섹션 4 제목]</a></li>
</ul>
<p>&nbsp;</p>

포맷 5종 템플릿

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

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

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

<!-- 후킹: 패턴 A 또는 C -->
<blockquote>[임팩트 한 줄 — 독자의 상황을 대변하는 문장]</blockquote>
<p>&nbsp;</p>

<p>[독자 공감 + 내 경험으로 연결 — 3~5문장. "저도 그랬습니다" 식으로 시작]</p>
<p>[이 글에서 다룰 내용 예고 — 구체적으로]</p>
<p>&nbsp;</p>

<!-- 목차 삽입 -->
<h2>목차</h2>
<ul>
  <li><a href="#s1">[섹션 1]</a></li>
  <li><a href="#s2">[섹션 2]</a></li>
  <li><a href="#s3">[섹션 3]</a></li>
</ul>
<p>&nbsp;</p>

<h2 id="s1">[섹션 1 — 문제 상황 묘사]</h2>
<h3>[세부 관점 1]</h3>
<p>[직접 겪은 구체적 상황 — 날짜, 수치, 감정 포함. 3~5문장]</p>
<p>[그 상황에서 발견한 인사이트 — 독자가 몰랐던 관점]</p>
<p>&nbsp;</p>

<h2 id="s2">[섹션 2 — 전환점 또는 발견]</h2>
<h3>[세부 관점 1]</h3>
<p>[문제를 어떻게 바라보게 됐는지 — BAB 구조의 After 단계]</p>
<p>[구체적 수치나 결과 언급]</p>
<p>&nbsp;</p>
<h3>[세부 관점 2]</h3>
<p>[추가 설명 — 짧은 문장. 긴 문장과 섞어서]</p>
<p>&nbsp;</p>

<h2 id="s3">[섹션 3 — 실전 적용법]</h2>
<h3>[방법 1]</h3>
<p>[독자가 바로 쓸 수 있는 방법 — 단계보다 맥락 중심으로]</p>
<p>[예상 실패 포인트와 극복법 — 경험 기반으로]</p>
<p>&nbsp;</p>
<h3>[방법 2]</h3>
<p>[동일 구조]</p>
<p>&nbsp;</p>

<h2>[섹션 4 — 의외의 발견 또는 여담]</h2>
<p>[예상 못한 결과나 부가적 인사이트 — 이 섹션이 인간미를 만듦]</p>
<p>&nbsp;</p>

<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->

<p>[핵심 요약 1~2문장] [독자에게 구체적 행동 제안] [공유/댓글 유도]</p>

2. howto형 — 튜토리얼 (정보 쿼리 1위, 체류시간 높음)

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

<!-- 후킹: 패턴 B -->
<blockquote>[이 글 하나로 [X]할 수 있습니다 — 구체적 약속]</blockquote>
<p>&nbsp;</p>

<p>[왜 이 방법이 필요한지 — 기존 방식의 문제점. 2~3문장]</p>
<p>[이 글을 끝까지 읽으면 얻는 것]</p>
<p>&nbsp;</p>

<!-- 목차 -->
<h2>목차</h2>
<ul>
  <li><a href="#prep">준비물</a></li>
  <li><a href="#step1">1단계 — [단계명]</a></li>
  <li><a href="#step2">2단계 — [단계명]</a></li>
  <li><a href="#step3">3단계 — [단계명]</a></li>
  <li><a href="#faq">자주 묻는 질문</a></li>
</ul>
<p>&nbsp;</p>

<h2 id="prep">시작 전 준비물</h2>
<p>[왜 필요한지 이유 포함]</p>
<ul>
  <li>[준비물 1] — [이유]</li>
  <li>[준비물 2] — [이유]</li>
</ul>
<p>&nbsp;</p>

<h2 id="step1">1단계 — [단계명]</h2>
<h3>무엇을 하는 단계인가</h3>
<p>[맥락 제공 — 왜 이 단계가 필요한지]</p>
<h3>실행 방법</h3>
<p>[구체적 방법 — 이미지 직후 텍스트 설명]</p>
<p>[이 단계에서 흔히 하는 실수와 예방법]</p>
<p>&nbsp;</p>

<h2 id="step2">2단계 — [단계명]</h2>
<h3>무엇을 하는 단계인가</h3>
<p>[맥락 제공]</p>
<h3>실행 방법</h3>
<p>[방법 + 주의사항]</p>
<p>&nbsp;</p>

<h2 id="step3">3단계 — [단계명]</h2>
<p>[동일 구조]</p>
<p>&nbsp;</p>

<h2 id="faq">자주 묻는 질문</h2>
<h3>[가장 흔한 질문]</h3>
<p>[구체적 답변]</p>
<h3>[두 번째 질문]</h3>
<p>[구체적 답변]</p>
<p>&nbsp;</p>

<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->

<p>[완료 축하 + 다음 단계 제안]</p>

3. list형 — 리스트 정리 (CTR 높음, 초기 트래픽 확보)

"베스트 N", "추천 N선", 비교 정리글에 적합.

<!-- 후킹: 패턴 B -->
<blockquote>[N가지 중 실제로 쓸 만한 건 [X]개입니다 — 기대 역전]</blockquote>
<p>&nbsp;</p>

<p>[선별 기준 명시 — "제가 직접 [기간] 동안 사용/테스트한 기준"]</p>
<p>[이 글에서 다루는 범위]</p>
<p>&nbsp;</p>

<!-- 목차 -->
<h2>목차</h2>
<ul>
  <li><a href="#item1">1. [항목명]</a></li>
  <li><a href="#item2">2. [항목명]</a></li>
  <li><a href="#compare">한눈에 비교</a></li>
  <li><a href="#conclusion">상황별 추천</a></li>
</ul>
<p>&nbsp;</p>

<h2 id="item1">1. [항목명] — [핵심 특징 한 줄]</h2>
<h3>왜 1위인가</h3>
<p>[단순 설명이 아닌 직접 경험 기반 이유]</p>
<h3>장단점</h3>
<p>[장점 — 구체적 수치나 사례]</p>
<p>[단점 솔직하게 1~2줄 — 없으면 신뢰도 하락]</p>
<p>&nbsp;</p>

<h2 id="item2">2. [항목명] — [핵심 특징 한 줄]</h2>
<h3>특징과 실사용 경험</h3>
<p>[앞 항목과 차별점 명시]</p>
<p>&nbsp;</p>

<!-- 3~N개 동일 패턴 -->

<h2 id="compare">한눈에 비교</h2>
<p>[표 또는 항목별 비교 요약]</p>
<p>&nbsp;</p>

<h2 id="conclusion">결론 — 상황별 추천</h2>
<h3>[상황 A]에는 [항목 X]</h3>
<p>[이유]</p>
<h3>[상황 B]에는 [항목 Y]</h3>
<p>[이유]</p>
<p>&nbsp;</p>

<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->

<p>[내 개인 픽 + 이유] [댓글 유도 — "여러분이 써본 것 중 좋았던 건?"]</p>

4. review형 — 분석/리뷰 (전문성 최고, AI 탐지 낮음)

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

<!-- 후킹: 패턴 C -->
<blockquote>결론부터 말하면: [한 줄 평가 — 긍정/부정 명확하게]</blockquote>
<p>&nbsp;</p>

<p>[어떤 계기로 사용/분석하게 됐는지 — 배경 스토리. 2~3문장]</p>
<p>[리뷰 관점/기준 명시 — "저는 [직군/상황]의 입장에서 평가했습니다"]</p>
<p>&nbsp;</p>

<!-- 목차 -->
<h2>목차</h2>
<ul>
  <li><a href="#summary">한줄 요약</a></li>
  <li><a href="#feature1">[분석 1]</a></li>
  <li><a href="#feature2">[분석 2]</a></li>
  <li><a href="#vs">경쟁 제품과 비교</a></li>
  <li><a href="#recommend">이런 분께 추천</a></li>
</ul>
<p>&nbsp;</p>

<h2 id="summary">한줄 요약</h2>
<p>[장점 2~3가지 + 단점 1~2가지 솔직하게]</p>
<p>&nbsp;</p>

<h2 id="feature1">[분석 섹션 1 — 가장 중요한 특징]</h2>
<h3>[세부 항목 1]</h3>
<p>[특징 설명 → 실제 사용 경험 → 내 평가 순서]</p>
<p>[수치나 비교 대상 포함]</p>
<h3>[세부 항목 2]</h3>
<p>[동일 구조]</p>
<p>&nbsp;</p>

<h2 id="feature2">[분석 섹션 2]</h2>
<p>[동일 구조]</p>
<p>&nbsp;</p>

<h2 id="vs">경쟁 제품/서비스와 비교</h2>
<h3>[어떤 상황에서 이게 나은가]</h3>
<p>[이유]</p>
<h3>[어떤 상황에서 다른 게 나은가]</h3>
<p>[솔직하게]</p>
<p>&nbsp;</p>

<h2 id="recommend">이런 분께 추천합니다</h2>
<h3>추천하는 경우</h3>
<p>[타겟 명확히]</p>
<h3>추천하지 않는 경우</h3>
<p>[맞지 않는 상황도 언급 — 신뢰도 상승]</p>
<p>&nbsp;</p>

<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->

<p>[최종 점수나 별점 + 총평 1~2문장]</p>

5. qa형 — Q&A (Featured Snippet 최적, 롱테일 키워드)

개념 설명, FAQ, "~가 뭔가요?" 쿼리에 적합.

<!-- 후킹: 패턴 C -->
<p>[가장 많이 검색되는 질문을 첫 문장으로 — 검색창 그대로]</p>
<p>[이 질문이 중요한 이유 + 이 글에서 다룰 범위]</p>
<p>&nbsp;</p>

<!-- 목차 -->
<h2>목차</h2>
<ul>
  <li><a href="#q1">[질문 1]</a></li>
  <li><a href="#q2">[질문 2]</a></li>
  <li><a href="#q3">[질문 3]</a></li>
  <li><a href="#q4">[질문 4 — 심화]</a></li>
  <li><a href="#summary">핵심 정리</a></li>
</ul>
<p>&nbsp;</p>

<h2 id="q1">[핵심 질문 1]</h2>
<p>[직접 답변 — 첫 문장에 핵심 답 먼저. 구글 스니펫 추출 고려]</p>
<h3>더 자세히</h3>
<p>[부연 설명 — 왜 그런지, 어떤 경우에 해당하는지]</p>
<p>[실제 사례나 예시]</p>
<p>&nbsp;</p>

<h2 id="q2">[핵심 질문 2]</h2>
<p>[답 먼저, 설명 나중]</p>
<h3>예시</h3>
<p>[구체적 예시]</p>
<p>&nbsp;</p>

<h2 id="q3">[핵심 질문 3]</h2>
<p>[동일 구조]</p>
<p>&nbsp;</p>

<h2 id="q4">[심화 질문 — 독자가 생각 못 했던 질문]</h2>
<p>[이 섹션이 전문성 어필 포인트]</p>
<p>&nbsp;</p>

<h2 id="summary">핵심 정리</h2>
<ul>
  <li>[Q1 핵심 답 — 한 줄]</li>
  <li>[Q2 핵심 답 — 한 줄]</li>
  <li>[Q3 핵심 답 — 한 줄]</li>
  <li>[Q4 핵심 답 — 한 줄]</li>
</ul>
<p>&nbsp;</p>

<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->

<p>[추가 궁금한 점은 댓글로 — 독자 참여 유도]</p>

포맷 선택 가이드

글 주제추천 포맷
도구/서비스 소개, 경험 공유story
설치법, 사용법, 단계별 방법howto
추천 목록, 비교 정리list
심층 분석, 솔직 리뷰review
개념 설명, 자주 묻는 질문qa

이미지 규칙

  • --related-image-keywords에 영어 키워드 2~3개
  • --image-upload-limit 3, --minimum-image-count 1 기본값
  • 이미지는 설명 단락 위에 배치 — "시각 → 텍스트" 순서
  • 이미지 alt 태그: 핵심키워드 + 설명 형식 필수

발행 후 검증

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

See Also

va-tistory, va-tistory-draft, va-shared