JSON-LD 구조화 데이터 검증기
HTML이나 원시 JSON-LD를 붙여넣기만 하면 FAQPage・BreadcrumbList・Article 구조화 데이터를 검증합니다. 누락된 필수 속성과 구글 리치 결과에서 자주 발생하는 실수를 한눈에 확인할 수 있습니다.
JSON-LD 구조화 데이터 검증기란
JSON-LD는 페이지 콘텐츠가 실제로 무엇인지—FAQ인지, 기사인지, 이동 경로인지 등—를 구글에 기계가 읽을 수 있는 형태로 전달하는 마크업 형식입니다. <script type="application/ld+json"> 태그 안에 JSON으로 작성하기만 하면, 화면에 보이는 HTML에는 전혀 영향을 주지 않으면서 구조화 데이터를 추가할 수 있습니다. 올바르게 구현되어 있으면 검색 결과에 FAQ 펼침 표시나 이동 경로 표시 같은 리치 결과가 나타나, 순위 변화가 없더라도 클릭률 향상으로 이어질 수 있습니다.
이 도구는 붙여넣은 HTML에서 <script> 블록을 자동으로 추출하거나(원시 JSON-LD를 직접 입력해도 됩니다) 감지된 FAQPage・BreadcrumbList・Article 계열(Article / NewsArticle / BlogPosting) 엔티티마다 Schema.org가 정한 필수 속성이 갖춰져 있는지 확인합니다. 또한 acceptedAnswer.text가 문자열이 아니라 객체로 되어 있다거나 position 값이 연속되지 않는 등, 구글 리치 결과를 조용히 무력화시키는 대표적인 실수도 함께 찾아냅니다. 게시 전이나 수정 직후에 이렇게 점검해두면, 나중에 Search Console에서 오류를 발견하는 것보다 더 빨리 문제를 잡을 수 있습니다.
JSON-LD 구조화 데이터 검증기 사용법
- 페이지의 HTML 소스나 JSON-LD를 준비합니다 "페이지 소스 보기"로 얻은 HTML 전체를 사용해도 되고, <script> 태그 안의 내용만 추출해서 사용해도 됩니다.
- 입력창에 붙여넣거나 URL에서 가져옵니다 텍스트를 직접 붙여넣을 수도 있고, 이미 게시된 페이지라면 URL을 입력해 자동으로 가져올 수도 있습니다.
- 감지된 엔티티와 검증 결과를 확인합니다 입력 내용에 여러 개의 <script> 블록이나 여러 개의 @type 엔티티가 포함되어 있으면 각각 개별적으로 나열되어 검증됩니다.
- "누락" 또는 "경고"로 표시된 항목을 수정합니다 각 속성은 OK・경고・누락 중 하나로 표시되므로, 해당 부분을 원본 JSON-LD에서 바로 찾아 수정할 수 있습니다.
- 수정 후 다시 검증한 다음 게시합니다 수정한 JSON-LD를 다시 붙여넣어 모든 항목이 OK로 표시되는지 확인한 뒤 실제 페이지에 반영하세요.
더 잘 활용하기 위한 팁
- FAQPage의 acceptedAnswer는 반드시 text 속성에 문자열을 직접 입력해야 합니다. 객체나 배열을 넣으면 구글 리치 결과가 이를 인식하지 못합니다.
- BreadcrumbList의 position은 1부터 시작하는 연속 번호로 지정하세요. 결번이나 중복이 있으면 올바른 이동 경로로 인식되지 않습니다.
- Article의 headline은 구글의 대략적인 기준인 110자 이내로 유지하는 것이 좋습니다. 너무 길면 검색 결과에서 뒷부분이 잘릴 수 있습니다.
- HTML 소스 전체를 그대로 붙여넣어도 됩니다. <script type="application/ld+json">의 내용만 자동으로 추출하여 검증합니다. JSON 부분만 붙여넣어도 정상적으로 동작합니다.
- 한 페이지에 여러 구조화 데이터를 배치할 때는 각각을 별도의 <script> 태그로 나누어 작성하면 관리가 쉬워집니다.
이럴 때 활용할 수 있습니다
FAQPage를 Search Console에 제출하기 전 확인
acceptedAnswer.text 형식 오류처럼 FAQ 리치 결과가 표시되지 않게 만드는 대표적인 문제를 게시 전에 발견할 수 있습니다.
사이트 구조 변경 후 이동 경로 점검
카테고리 이동이나 URL 변경으로 BreadcrumbList의 position이 어긋나지 않았는지 한 번에 확인할 수 있습니다.
블로그 글의 Article 스키마 점검
headline 글자 수 초과나 author・datePublished・image 누락 등 기사형 스키마의 권장 속성을 한꺼번에 점검할 수 있습니다.
리치 결과 테스트에서 지적된 오류의 원인 조사
구글 공식 도구에서 오류가 나올 때, 어떤 속성이 문제인지 이 도구로 먼저 좁힌 다음 수정할 수 있습니다.
용어집
- JSON-LD
- JSON 형식으로 구조화 데이터를 작성하기 위한 규격입니다. <script type="application/ld+json"> 태그 안에 독립적인 JSON으로 삽입되어, 기존 HTML 레이아웃을 바꾸지 않고도 검색엔진용 정보를 추가할 수 있습니다.
- Schema.org
- 구글・마이크로소프트・야후 등이 공동으로 제정한 구조화 데이터 어휘 모음입니다. FAQPage나 Article처럼 콘텐츠 종류별 타입(@type)과 각 타입의 속성을 정의합니다.
- FAQPage
- 자주 묻는 질문과 답변을 구글에 전달하기 위한 Schema.org 타입입니다. mainEntity에 Question 타입의 배열을 가지며, 각 Question은 name(질문 텍스트)과 acceptedAnswer.text(답변 텍스트)가 필수입니다.
- BreadcrumbList
- 이동 경로(사이트 내 계층 위치)를 나타내는 Schema.org 타입입니다. itemListElement에 ListItem 배열을 가지며, 각 항목은 position(순서)・name・item이 필수입니다.
- 리치 결과
- 검색 결과에 일반적인 제목・설명 이상의 정보(FAQ 펼침 표시, 이동 경로 표시 등)를 보여주는 기능입니다. 구조화 데이터가 올바르게 구현되어 있어야 표시됩니다.
- 필수 속성
- 해당 타입의 리치 결과를 표시하기 위해 구글이 반드시 요구하는 속성입니다. 이 속성이 없으면 리치 결과 자체가 표시되지 않습니다. 권장 속성은 없어도 표시될 수 있지만 있는 편이 바람직한 속성입니다.
- Google Search Console
- 자사 사이트의 검색 성과와 색인 현황을 확인할 수 있는 구글 공식 도구입니다. "향상" 보고서에서 게시된 페이지의 구조화 데이터를 구글이 실제로 어떻게 인식하고 있는지 확인할 수 있습니다.
자주 묻는 질문
여담 ― JSON-LD가 Microdata・RDFa를 대체한 이유
JSON-LD(JSON for Linking Data)는 2010년대 초 W3C 커뮤니티 그룹이 제정한 링크드 데이터 형식에서 시작되었습니다. HTML 요소의 속성에 마크업을 직접 삽입하는 기존의 구조화 데이터 표기법인 Microdata・RDFa와 달리, JSON-LD는 독립적인 JSON 블록으로 <script> 태그 안에 완전히 존재하기 때문에 기존 HTML 레이아웃을 전혀 건드리지 않고도 구조화 데이터를 추가・수정・삭제할 수 있다는 것이 가장 큰 장점입니다. 구글은 2015년 무렵부터 JSON-LD를 권장 형식으로 자리매김했고, 현재의 리치 결과 문서도 거의 전적으로 JSON-LD 표기법을 전제로 작성되어 있습니다.
이 사이트 자체의 FAQ 영역도 마찬가지 방식으로 동작합니다. 작성자가 질문과 답변을 한 번만 작성하면, 내부적으로 이에 대응하는 FAQPage 형식의 JSON-LD가 자동으로 생성됩니다. 사람이 보는 아코디언 형태의 HTML과 검색엔진이 읽는 JSON-LD를 두 번 손으로 작성할 필요가 없어, 한쪽을 수정하면 다른 쪽도 자동으로 반영되므로 표시 내용과 구조화 데이터가 서로 어긋나는 문제가 잘 발생하지 않습니다.
문법적으로 완전히 올바른 JSON이라도 Schema.org가 요구하는 필수 속성이 빠져 있거나 구글이 권장하는 속성이 없으면 리치 결과(검색 결과의 FAQ 펼침 표시, 이동 경로 표시 등)가 반영되지 않을 수 있습니다. 특히 acceptedAnswer.text처럼 중첩 구조가 깊은 속성은 구현 시 실수하기 쉬운 대표적인 사례입니다. 게시 전에 이러한 도구로 기계적으로 점검해두면, 나중에 Search Console의 "향상" 보고서에서 오류를 발견하는 것보다 더 빨리 문제를 찾아낼 수 있습니다.