워드프레스 ZIP 자동등록은 글 한 편을 완성할 때마다 반복하던 본문 복사, 이미지 업로드, SEO 입력을 하나의 패키지로 묶어 초안으로 등록하는 방식입니다. 근거픽에서는 글을 빨리 많이 올리기보다, 같은 실수를 줄이고 사람이 마지막 검수를 할 수 있도록 이 시스템을 만들었습니다.
결과부터 말하면 자동등록 자체는 성공했습니다. 그러나 첫 성공이 곧 완성은 아니었습니다. 본문과 이미지가 들어간 뒤에도 Rank Math 점수가 30점에 머물렀고, 이미지 제목과 캡션 일부가 실제 미디어 보관함에 적용되지 않는 문제도 발견했습니다. 이 글은 그 실패를 고쳐 등록 직후 73점을 확인하고 수정 없이 발행하기까지의 실제 프로젝트 기록입니다.
왜 워드프레스 ZIP 자동등록을 만들었나?
근거픽 글 한 편에는 본문만 필요한 것이 아닙니다. 카테고리, 태그, 슬러그, 포커스 키워드, SEO 제목, 메타 설명, 이미지 6장과 이미지별 Alt·제목·캡션·설명까지 함께 준비해야 합니다.
이 항목들을 워드프레스 화면에서 매번 따로 입력하면 시간이 오래 걸릴 뿐 아니라 누락 가능성도 커집니다. 특히 이미지가 여러 장이면 본문 위치와 파일 순서가 어긋나거나, Alt만 넣고 캡션을 빼먹는 일이 생길 수 있습니다.
그래서 목표를 “자동으로 공개하기”가 아니라 “검수 가능한 초안을 정확하게 만들기”로 정했습니다. 반복 입력은 시스템이 맡고, 사실관계와 화면 품질은 사람이 확인하는 구조입니다.
ZIP 파일에는 무엇을 넣었나?
자동등록용 ZIP의 중심은 세 가지입니다.
- content.html: 제목을 제외한 최종 본문과 이미지 삽입 위치
- post.json: 제목, 카테고리, 태그, 슬러그, SEO 설정, 이미지 메타데이터
- PNG 6장: 본문 상단 이미지 1장과 본문 중간 이미지 5장
본문 중간 이미지 위치에는 고정된 자리표시자를 넣었습니다. 플러그인은 자리표시자와 JSON의 이미지 정보를 대조한 뒤 실제 이미지 블록으로 바꿉니다. 이렇게 하면 어떤 이미지가 어느 문단 뒤에 들어가는지 ZIP을 만들 때부터 확정할 수 있습니다.
이미지는 모두 독립 PNG로 만들고 가로 폭을 1100px로 맞췄습니다. 세로는 정보량에 따라 달라집니다. 합본이나 콜라주를 사용하지 않은 이유는 모바일 가독성과 이미지별 메타데이터를 각각 관리하기 위해서입니다.
워드프레스 ZIP 자동등록은 어떻게 진행되나?
현재 작업 흐름은 다섯 단계입니다.
- 제작: 본문, SEO 값, 이미지와 메타데이터를 준비합니다.
- 검사: JSON 문법, 파일 누락, 이미지 수, 자리표시자 연결을 확인합니다.
- 업로드: 완성된 ZIP을 전용 가져오기 화면에서 검사합니다.
- 초안 생성: 워드프레스 글, 미디어, 카테고리와 SEO 값을 초안으로 등록합니다.
- 사람 검수: Rank Math와 PC·모바일 미리보기를 확인한 뒤 공개합니다.
이 과정에서 가장 중요한 안전장치는 초안 상태입니다. ZIP 구조가 정상이어도 최신 정책, 날짜, 수치, 실제 메뉴가 정확한지는 사람이 다시 봐야 합니다. 자동등록은 발행 판단을 대신하지 않습니다.
첫 성공 뒤 Rank Math 30점이 나온 이유
처음에는 본문과 이미지가 정상 등록됐기 때문에 작업이 거의 끝났다고 생각했습니다. 하지만 Rank Math 점수는 30점이었습니다. 사용자가 일부 항목을 직접 고쳐 점수를 올려야 했습니다.
원인은 포커스 키워드를 정해 놓고도 제목, SEO 제목, 메타 설명과 본문에서 비슷한 다른 표현을 사용한 것이었습니다. 사람에게는 같은 뜻처럼 보여도 SEO 분석 도구는 정해진 문구가 실제 위치에 들어갔는지 따로 확인합니다.
다음 글부터는 먼저 자연스러운 포커스 키워드 하나를 확정하고, 글 제목·SEO 제목·메타 설명·도입부·소제목·결론에 같은 문구를 일치시켰습니다. 그 결과 AI 활용 글은 등록 직후 Rank Math 73점을 기록했고, 사용자가 별도로 손보지 않고 바로 발행했습니다.
Rank Math 공식 안내에서도 포커스 키워드를 글 제목, SEO 제목, 메타 설명, 글 앞부분과 본문에 사용하는지를 각각 검사한다고 설명합니다. 다만 73점은 이번 근거픽 글에서 확인한 결과이지, 같은 구조를 사용하면 모든 사이트에서 같은 점수가 나온다는 뜻은 아닙니다.
이미지 Alt만으로는 부족했다
두 번째 문제는 이미지 메타데이터였습니다. ZIP의 JSON에는 Alt, 제목, 캡션, 설명을 모두 적었지만 초기 플러그인은 일부 필드를 실제 워드프레스 미디어 항목에 적용하지 않았습니다. 파일 안에 값이 있는 것과 워드프레스에 저장된 것은 다른 문제였습니다.
플러그인 구조를 다시 확인해 이미지마다 다음 네 항목을 읽고 저장하도록 보완했습니다.
- Alt: 이미지가 보이지 않을 때 내용을 설명하고 접근성을 돕는 대체 텍스트
- 제목: 미디어 보관함에서 이미지를 구분하는 이름
- 캡션: 본문 이미지 아래 독자에게 보이는 짧은 설명
- 설명: 이미지의 목적과 내용을 기록하는 상세 정보
워드프레스 개발자 문서에서도 미디어 항목의 Alt, 캡션, 설명 등을 별도 필드로 다룹니다. 따라서 자동등록 완료 판정도 JSON에 값이 있는지만 보지 않고, 실제 미디어에 적용되는지 확인하는 방향으로 바꿨습니다.
자동화했지만 완전 자동발행은 하지 않는 이유
이 프로젝트의 결론은 단순합니다. 반복 작업은 줄일 수 있지만 최종 책임까지 자동화할 수는 없습니다. 특히 정책, 세금, 기술 버전처럼 바뀔 수 있는 내용은 작성 당일 공식 자료와 충돌하지 않는지 확인해야 합니다.
그래서 ZIP 등록 후에는 다음 항목을 반드시 사람이 확인합니다.
- 제목과 본문 내용이 실제로 일치하는지
- 공식 출처 링크와 날짜·숫자가 정확한지
- 포커스 키워드가 억지스럽지 않게 들어갔는지
- 이미지 6장과 캡션이 올바른 위치에 있는지
- PC와 모바일에서 이미지와 문단이 잘리지 않는지
- Rank Math 값이 실제 워드프레스에서 인식됐는지
이번 프로젝트에서 얻은 기준
워드프레스 ZIP 자동등록의 가치는 발행 버튼을 대신 누르는 데 있지 않았습니다. 글마다 반복되는 구조를 표준화하고, 누락을 검사하며, 사람이 콘텐츠 품질에 더 집중할 수 있게 만든 것이 가장 큰 변화였습니다.
첫 번째 ZIP 등록 성공만 봤다면 Rank Math 30점과 이미지 메타데이터 누락을 놓쳤을 것입니다. 실제 등록 결과를 확인하고 실패 원인을 다시 패키지와 플러그인에 반영했기 때문에 다음 글에서는 73점과 바로 발행이라는 개선을 확인할 수 있었습니다.
앞으로도 자동화 범위는 늘리되 공개 전 사람 검수는 유지할 계획입니다. 근거픽의 목표는 많이 만드는 자동화가 아니라, 같은 기준으로 정확하게 만드는 자동화입니다.
자주 묻는 질문
ZIP을 올리면 글이 바로 공개되나요?
아닙니다. 현재 기준은 초안 생성입니다. 실제 미리보기, 링크, SEO 설정과 사실관계를 사람이 확인한 뒤 공개합니다.
Rank Math 73점이 항상 보장되나요?
보장되지 않습니다. 73점은 근거픽의 AI 활용 글을 실제 등록했을 때 확인한 결과입니다. 글의 내용, 사이트 설정과 플러그인 상태에 따라 점수는 달라질 수 있습니다.
이미지는 파이썬으로 만들었나요?
아닙니다. 이 글의 정보형 이미지는 AI 이미지 생성 도구로 한 장씩 독립 제작했습니다. 파일 폭 조정과 ZIP 구조 검사는 별도 자동화 과정으로 처리했습니다.
확인 기준일: 2026년 8월 6일
공식 참고 자료: Rank Math 콘텐츠 분석 기준, WordPress 미디어 REST API 문서