JSON-LD 검증하는 법 — 흔한 문법 오류 7가지와 랭킹AI 사유 메시지별 대처

랭킹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 에서도 메인 페이지 전용입니다.

흔한 문법 오류 7가지는 무엇인가요?

{
  "@context": "https://schema.org",
  "@type": "Dentist",
  "name": "송도바른치과",
  "telephone": "032-123-4567",   ← ① 마지막 항목 뒤 쉼표
}
  1. 후행 쉼표: 마지막 속성이나 배열 원소 뒤의 ,. 가장 흔합니다.
  2. 홑따옴표: 'name': '치과' 는 JSON 이 아닙니다. 키와 문자열은 모두 큰따옴표.
  3. 문자열 안의 큰따옴표: "name": "송도 "바른" 치과" → \"바른\" 으로 이스케이프하거나 작은따옴표로 바꿉니다.
  4. 주석: // 전화번호 나 /* */ 는 허용되지 않습니다.
  5. 문자열 안 줄바꿈: 설명문을 여러 줄로 적으면 깨집니다. 한 줄로 쓰거나 \n 을 씁니다.
  6. 괄호 짝 불일치: 중첩된 address·openingHoursSpecification 에서 } 나 ] 가 하나 빠지는 경우.
  7. 템플릿 변수 미치환: "name": "{{site_name}}" 처럼 플랫폼 변수가 그대로 남은 경우. 문법은 맞지만 값이 비어 AI 에게 쓸모가 없습니다.

@type 이 없는 경우는 보통 {"@context": "https://schema.org"} 만 있거나, @graph 안에 노드를 넣고 각 노드의 @type 을 빠뜨린 경우입니다.

어떤 순서로 검증하나요?

  1. 페이지 소스에서 블록 전부 찾기: 브라우저에서 소스 보기(Ctrl+U) → ld+json 검색. 테마·플러그인이 넣은 블록까지 모두 셉니다.
  2. 브라우저 콘솔에서 파싱: 개발자 도구 콘솔에 아래를 붙여 넣으면 깨진 블록의 번호와 오류 위치가 나옵니다.
    [...document.querySelectorAll('script[type="application/ld+json"]')].forEach((s, i) => {
      try { JSON.parse(s.textContent); console.log(i, 'OK'); }
      catch (e) { console.error(i, e.message); }
    });
    
  3. Schema.org 검증기(validator.schema.org)에 URL 을 넣어 타입·속성 경고를 확인합니다. Google 리치 결과 테스트는 FAQPage 같은 리치 결과 대상만 보여 주므로 보조로 씁니다.
  4. 랭킹AI 재진단: 캐시가 6시간이므로 고친 직후에는 결과 페이지의 "재진단"을 쓰거나 주소 뒤에 ?v=2 처럼 쿼리를 바꿔 넣습니다.

사유 메시지별로 무엇을 고치나요?

사유 할 일
JSON-LD 스크립트 없음 메인 <head> 또는 <body> 끝에 업종 타입 블록 1개 추가. LocalBusiness 필수 속성 예시를 그대로 쓰면 됩니다
N개 전부 JSON 문법 오류 위 콘솔 스니펫으로 오류 위치를 찾아 쉼표·따옴표를 고칩니다
유효하나 @type 없음 각 노드에 "@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로 옮기는 것이 좋습니다.

您的网站按这些标准得几分?10秒、免费、无需注册。

诊断我的网站自行修改有困难?申请改善咨询
每月1日发送新文章和行业平均分只需邮箱,无需注册。点击确认邮件中的按钮即可开始订阅,随时可退订。确认订阅后可获取行业AI搜索准备清单(PDF)。

相关文章

광고 · 그룹디그룹디 — 디자인·홈페이지 제작