최근 Search Console 실적 점검을 진행하던 중, 내가 운영하는 IT Story 블로그의 신규 발행글을 보고 경악을 금치 못했다. 'TypeScript 타입 설계 패턴 모음집'이라는 거창한 제목을 달고 있는 포스팅이었는데, 막상 본문을 열어보니 다루고 있는 패턴이 겨우 3개뿐이었기 때문이다. 제목은 거창한 모음집인데 본문 알맹이는 터무니없이 부족하니, 독자 입장에서는 전형적인 낚시성 글처럼 보일 위험이 컸다.
자동으로 글을 작성하고 발행해주는 파이프라인을 구축해두었다고 해서 완전히 방심하고 있었던 탓이다. 지표를 분석하다가 운 좋게 찾아냈지만, 도대체 어디서부터 문제가 생겼는지 원인을 파악하고 파이프라인을 수정할 필요가 있었다.
제목과 본문의 불일치, 문제는 파이프라인 검증 부재였다
원인을 분석해보니 자동발행 파이프라인의 기본 구조적인 한계가 드러났다. 내 시스템은 Notion에 미리 작성해둔 SEO 제목을 그대로 가져오고, Gemini API에 해당 제목을 전달하여 본문만 생성하도록 설계되어 있다. 즉, 생성 모델은 본문 작성 지침에 따라 알맞은 글을 만들어낼 뿐이었다.
문제는 제목이 암시하는 포괄적인 범위나 전체 분량을 본문이 제대로 충족하고 있는지 검증하는 로직이 시스템 내에 전혀 없었다는 점이다. 프롬프트 기본 지침대로 3~4개의 소제목으로 본문을 구성하다 보니, 제목에 '모음집'이나 '총정리' 같은 표현이 들어가도 본문은 패턴 3개에서 그냥 마무리되어 버린 것이다.
Gemini 프롬프트 본문 분량 검증 규칙 추가 및 4개 블로그 일괄 수정
이 결함을 확실하게 잡기 위해 Gemini 프롬프트에 직접 엄격한 검증 조건 규칙을 추가하기로 했다. Gemini 프롬프트의 bodyHtml 작성 조건 항목에 새로운 규칙을 명시했다. 제목에 '모음집', '총정리', 'N가지' 같은 포괄적이고 나열형인 표현이 포함되어 있다면, 본문에서도 최소 5개 이상의 <h2> 소제목을 생성해 실제로 내용을 채우도록 강제 조치했다.
만약 다룰 내용이 부족하더라도 소제목 개수를 늘려서 제목이 암시하는 범위를 무조건 충족하도록 지침을 세웠다. 분량 제한 지침보다 이 제목-본문 범위 일치 규칙을 우선시하도록 프롬프트를 설계했다. 이번 이슈는 특정 스크립트 하나만의 버그가 아니라 모든 자동발행 시스템이 공유하는 공통 프롬프트 구조의 결함이었기 때문이다.
따라서 해결책을 찾은 즉시 이슈로그, KidStory, Jin's Lab(스토리 및 일반), IT Story까지 내가 관리하는 총 4개 블로그의 파이프라인 스크립트에 Gemini 프롬프트 본문 분량 검증 안전장치를 동시 일괄 적용했다.
실패를 통해 배운 자동 발행 파이프라인의 안전장치
만약 Search Console 실적 점검을 소홀히 했다면 제목과 본문이 따로 노는 불완전한 포스팅들이 계속 쌓여 블로그 전체의 SEO 품질을 떨어뜨렸을 것이다. 단순한 본문 생성 명령을 넘어, 제목의 키워드 성격과 본문의 분량이 조화를 이루도록 프롬프트 수준에서 제어하는 것이 얼마나 중요한지 깨달았다.
공통 프롬프트 구조를 정밀하게 수정하고 4개 블로그 스크립트 전체에 방어 로직을 일괄 적용하면서 파이프라인이 한층 더 견고해졌다. 앞으로도 주기적으로 실적 데이터를 확인하면서 발견되는 결함들을 프롬프트 고도화로 차근차근 해결해 나갈 계획이다.