워드프레스 SEO 구조화 데이터가 중요한 이유
구조화 데이터(JSON-LD) 자동 출력 — Article 스키마가 디스커버 노출에 미치는 영향
지금까지 콘텐츠 품질 진단 그룹을 다뤘다.
이제부터는 색인 관리 그룹으로 넘어간다. 첫 번째로 다룰 건 Article 구조화 데이터, 그러니까 JSON-LD다.
편집 화면 체크리스트에서 “구조화 데이터 출력 여부”를 확인하는 항목이 있다고 앞서 말했는데, 이번 글에서는 그 체크가 실제로 화면 뒤에서 무슨 일을 하는지 뜯어본다.

구조화 데이터는 왜 필요한가
사람이 글을 읽을 때는 제목을 보고, 사진을 보고, 작성자를 확인한다.
이걸 눈으로 훑어서 자연스럽게 이해한다. 그런데 구글의 크롤러는 사람처럼 직관적으로 읽지 않는다.
HTML을 파싱해서 어디가 제목인지, 어디가 본문인지 추론해야 한다. 추론에는 오류가 생긴다.
나는 이걸 여권과 비교해서 생각한다.
사람의 얼굴을 보고 신원을 추측하는 것과, 여권에 적힌 정보를 확인하는 건 신뢰도가 다르다.
Article JSON-LD는 글의 여권이다. headline, image, datePublished, dateModified, author, publisher. 이 여섯 가지 필드가 SOHO SEO가 자동으로 채우는 핵심 정보다.
발행일과 수정일이 왜 E-E-A-T와 직결되는가
datePublished와 dateModified, 이 두 필드를 나는 특히 중요하게 본다.
구글이 디스커버에서 콘텐츠를 밀어줄지 판단할 때 최신성이 큰 비중을 차지하는데, 이 최신성 판단의 근거가 바로 이 두 필드다.
오래된 정보를 방치한 글과, 최근에 갱신된 글을 구별하는 근거가 여기서 나온다.
author 필드도 마찬가지다.
이름만 넣는 게 아니라 @type을 Person으로 지정한다.
이게 실제 사람이 쓴 글이라는 걸 구조적으로 선언하는 것이다. 나는 이 값을 설정 화면에서 관리자가 정한 기본값으로 처리하되, 글쓴이 계정에 표시 이름이 있으면 그걸 우선 쓰게 만들었다.
publisher 필드는 조직(Organization) 정보다. 사이트 자체의 신뢰도를 나타낸다.
로고 이미지가 설정돼 있으면 publisher 안에 logo 필드로 함께 넣는다.
이 세 가지, 날짜 두 개와 작성자·발행자 정보가 합쳐지면 이게 바로 E-E-A-T의 뼈대다.
경험과 전문성은 콘텐츠 자체의 몫이지만, 권위성과 신뢰성은 이 구조화 데이터가 구글에게 전달하는 최소한의 증거다.
대표 이미지 하나로는 부족했다
여기서부터가 이 기능에서 내가 가장 공들인 부분이다.
처음 버전에서는 image 필드에 대표 이미지 하나만 넣었다. 그런데 실제 사용자들의 사이트를 살펴보면서 이게 잘못됐다는 걸 깨달았다.
사람들이 진짜 신경 쓰는 사진, 직접 찍어서 저작권 정보를 일부러 남겨둔 여행이나 맛집 사진들은 대부분 대표 이미지가 아니라 본문 중간에 삽입된 사진들이었다.
이 사진들이 구조화 데이터에 전혀 노출되지 않으면, 구글 입장에서는 이 글에 사진이 하나밖에 없는 것처럼 보인다.
나머지 사진들은 이미지 검색에서 이 글과 제대로 연결되지 못한다.

그래서 지금은 대표 이미지와 본문 속 콘텐츠 이미지를 모두 모아 배열로 채운다.
이미지가 여러 개면 배열, 하나면 단일 객체로 넣는다. 다만 이걸 무한정 넣지는 않는다.
요스트 같은 경쟁 플러그인도 이 부분에 문서화된 표준값이 없어서, 나는 실용적으로 충분히 넉넉한 값으로 직접 정했다.
저작권 정보는 지어내지 않는다
이미지마다 저작권(copyrightNotice)과 촬영자(creator, creditText) 정보를 채우는데, 이건 사용자가 사진을 업로드할 때 일부러 지우지 않고 남겨둔 EXIF·IPTC 메타데이터에서 가져온다.
워드프레스가 업로드 시점에 이미 첨부파일 메타로 읽어서 저장해둔 값을 그대로 활용하는 것이다.
나는 이 원칙을 플러그인 전체에 일관되게 적용했다.
값이 없으면 채우지 않는다. 빈 문자열이나 사이트 이름 같은 걸로 억지로 채우지 않는다.
이게 왜 중요한가.
license 필드도 같은 원칙으로 처리했다. 구글 이미지 검색의 “라이선스 있음(Licensable)” 배지는 license 필드가 있어야 뜬다.
관리자가 설정 화면에 저작권·이용정책 페이지 URL을 등록해두면 이 필드를 채울 수 있다.
그런데 나는 이걸 저작권이나 촬영자 정보가 실제로 확인된 사진에만 한정해서 붙였다.
이유가 있다. 무료 공용 이미지에 대해 사용자 소유가 아닌 사진에 소유권을 주장하는 것처럼 보일 수 있다.
나는 이런 애매한 상황을 만들고 싶지 않았다. 근거 없는 정보를 만들어내지 않는다는 원칙을, 편의보다 우선시했다.

첨부파일을 정확히 찾아내는 문제
기술적으로 까다로웠던 부분이 하나 더 있다.
본문에 삽입된 이미지의 URL만 보고 어떤 첨부파일인지 역추적하는 게 항상 성공하지는 않는다는 걸 발견했다.
글을 쓸 당시 본문에 적힌 이미지 주소가 예전 파일명(.jpg)을 가리키고 있는데, 그 사이 실제 첨부파일은 WebP로 변환되어 등록 파일명이 달라진 경우가 실제로 있었다.
그런데 그 img 태그 자체에는 워드프레스가 항상 자동으로 붙이는 class="wp-image-1400" 같은 표시가 이미 있다.
나는 URL 역추적보다 이 클래스에서 직접 읽은 첨부파일 ID를 우선 쓰도록 바꿨다.
더 정확하고 데이터베이스 조회도 필요 없어서 더 빠르다.
이 클래스가 없는 경우에만 URL 역추적으로 보완한다.
작은 버그 하나를 고치면서 배운 건, 워드프레스가 이미 만들어둔 정보를 잘 활용하는 게 새로운 추론 로직을 짜는 것보다 나을 때가 많다는 것이다.

robots 메타는 왜 강제로 덮어쓰는가
이 클래스에는 구조화 데이터 말고 하나 더 하는 일이 있다.
robots 메타에 max-image-preview:large를 강제로 보장하는 것이다.
나는 이런 충돌을 여러 번 목격했다.
그래서 다른 코드가 이미 이 값을 건드렸든 말든, SOHO SEO가 마지막에 한 번 더 이 값을 확실하게 보장하도록 만들었다.
이게 없으면 앞서 다룬 체크리스트에서 “대표 이미지 1200px 이상”을 아무리 잘 지켜도, 실제로 큰 이미지 카드로 노출될 자격 자체가 사라진다.
보안도 함께 고려했다
마지막으로 하나만 더 짚고 싶다.
JSON-LD를 출력할 때 JSON_HEX_TAG 옵션을 쓴다.
잠재적인 XSS다. <와 >를 이스케이프하면 이 문자열 자체가 결과물에 나타날 수 없어서 이 위험이 원천 차단된다.
이건 워드프레스 공식 디렉토리 심사 과정에서 지적받고 고친 부분이다.
SEO 기능 하나를 만들 때도, 보이지 않는 곳에서 이런 안전장치까지 같이 챙겨야 한다고 생각한다.
SOHO SEO 구조화데이터 결론
Article JSON-LD는 단순한 태그 하나가 아니다.
발행일과 수정일로 최신성을, 작성자와 발행자로 신뢰성을, 이미지 배열과 저작권 정보로 콘텐츠의 진정성을 구글에게 구조적으로 증명하는 장치다.
나는 이걸 만들면서 두 가지 원칙을 지켰다. 근거 없는 정보는 채우지 않는다는 것, 그리고 사용자가 이미 남겨둔 정보를 최대한 정확하게 찾아내서 활용한다는 것이다.
다음 글에서는 이 구조화 데이터와 짝을 이루는 조건, max-image-preview:large가 왜 이미지 카드 노출의 필수 조건인지를 더 깊게 다룰 것이다.

이 글은 DECOBLOCKS를 사용하여 디자인된 글입니다.