랭킹AI ‘JSON-LD 존재·문법 유효’(4점)는 메인 페이지의 application/ld+json 블록이 JSON으로 파싱되고 @type 노드가 있으면 통과입니다. 블록이 없으면 실패, 전부 문법 오류면 부분, 유효하지만 @type이 없어도 부분입니다. 흔한 원인은 마지막 항목 뒤 쉼표, 홑따옴표, 주석, 줄바꿈이 들어간 문자열, 중괄호 짝 불일치입니다. 브라우저 콘솔에서 JSON.parse로 확인하는 것이 가장 빠르며, 이 항목은 하위 페이지로 보완되지 않으므로 메인 페이지에서 고쳐야 합니다.
광고 · 백결보감
이 항목은 무엇을 보나요?
"JSON-LD 존재·문법 유효"는 구조화 데이터 영역의 4점 항목입니다. 메인 페이지의 <script type="application/ld+json"> 블록을 전부 모아 다음 순서로 판정합니다.
결과
조건
사유 메시지
실패 (0점)
블록이 하나도 없음
JSON-LD 스크립트 없음
부분 (2점)
블록은 있지만 전부 JSON 문법 오류
JSON-LD N개 전부 JSON 문법 오류
부분 (2점)
파싱은 되지만 @type 이 있는 노드가 없음
JSON-LD는 유효하나 @type 없음
통과 (4점)
유효한 블록 1개 이상 + @type 노드 1개 이상
JSON-LD N개, @type 노드 M개 (파싱 실패 k개 포함)
통과여도 "파싱 실패 k개 포함"이 붙어 있으면 깨진 블록이 같이 있다는 뜻입니다. AI 가 어느 블록을 읽을지 알 수 없으니 깨진 블록도 고치는 것이 안전합니다. 이 항목은 SCORING_V2 에서도 메인 페이지 전용입니다.
각 노드에 "@type": "Dentist" 처럼 타입을 넣습니다. @graph 를 쓰면 안쪽 노드마다
통과 (파싱 실패 k개 포함)
깨진 블록을 찾아 고치거나, 중복 플러그인 블록이면 하나를 끕니다
JSON-LD 가 유효해지면 같은 블록으로 "업종 스키마 적합성"(5점), "LocalBusiness 필수 속성 4종"(7점), "FAQPage 스키마"(9점)까지 이어서 챙길 수 있습니다. 관련 글: FAQPage 스키마 가이드, LocalBusiness 필수 속성. 무료 진단에서 현재 사유를 확인하세요.
자주 묻는 질문
구조화 데이터 플러그인을 쓰는데 왜 문법 오류가 나나요?
플러그인이 만든 JSON-LD는 대개 유효합니다. 문제는 테마나 다른 플러그인이 같은 페이지에 또 다른 JSON-LD를 넣거나, 상호·설명에 큰따옴표가 들어가 이스케이프되지 않은 경우입니다. 결과 사유에 "파싱 실패 1개 포함"이 보이면 블록이 여러 개이니 페이지 소스에서 application/ld+json을 전부 찾아 하나씩 확인하세요.
JSON-LD를 하위 페이지에만 넣어도 되나요?
FAQPage·업종 스키마·LocalBusiness 속성은 하위 페이지에서도 인정되지만, "JSON-LD 존재·문법 유효" 항목은 메인 페이지만 봅니다. 메인에 깨진 스키마가 있으면 AI가 메인을 읽을 때 그대로 실패하기 때문입니다. 메인에 최소 하나의 유효한 블록을 두세요.
Microdata나 RDFa는 인정되나요?
랭킹AI는 JSON-LD만 봅니다. Google도 JSON-LD를 권장하므로, Microdata로 적힌 스키마가 있다면 같은 내용을 JSON-LD로 옮기는 것이 좋습니다.