JSON-LD 검사기

사용 방법

1. 1

   JSON이나 스크립트 블록 붙여 넣기

   스크립트 태그 안쪽 내용이나 <script type="application/ld+json"> 블록 전체를 붙여 넣으세요. 태그는 알아서 벗겨 내고, 블록이 여러 개인 페이지는 블록별로 읽습니다. 512 KiB까지 받습니다.

2. 2

   입력하는 즉시 파싱

   객체 하나, 객체 배열, @graph를 받아들이고 모든 중첩 객체를 방문합니다. JSON 오류는 입력창 아래에 표시되고, 같은 객체 안의 중복 키는 경고하며, 마지막으로 정상이던 결과는 흐리게 남습니다.

3. 3

   요약 확인

   타일 네 개에 타입 노드 수, 빠진 필수 속성, 빠진 권장 속성, 형식 문제(날짜·URL·숫자)가 나옵니다. @context 누락 같은 문서 전체 지적은 그 옆에 나열됩니다.

4. 4

   노드별 점검표 따라가기

   중첩된 노드까지 포함해 타입 노드마다 경로, 상태(완전함·검토·수정 필요), 점검표가 담긴 카드가 나옵니다. 필수 항목이 먼저 나오고, offers | review | aggregateRating 같은 "다음 중 하나 이상" 행은 그중 하나만 있으면 충족됩니다.

5. 5

   공식 도구로 재확인

   모든 노드가 정상으로 나오면 구글 리치 결과 테스트나 Schema Markup Validator로 실제 자격 요건과 어휘를 확인하세요.

작동 원리

실제 예시

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "A practical guide",
  "author": { "@type": "Person", "name": "A. Writer" }
}

타입 노드 2, 필수 누락 0, 권장 누락 8
Article: 검토, 권장 누락 dateModified, datePublished, image
Person: 검토, 권장 누락 url, image, sameAs, description, alternateName

{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", "@id": "https://example.com/#org", "name": "Example" },
    { "@type": ["Product", "Thing"], "name": "Mug", "offers": "" },
    { "@type": "FAQPage" }
  ]
}

타입 노드 4, 필수 누락 2
Organization: 검토, 권장 누락 11
Product: 수정 필요, 필수 누락 offers | review | aggregateRating, offers: 속성이 있지만 값이 비어 있습니다.
Thing: 완전함(이 타입에는 점검표가 없습니다. 구조와 값 형식은 그대로 검사합니다.)
FAQPage: 수정 필요, 필수 누락 mainEntity

{ "name": "Example", "url": "https://example.com" }

문서 전체 점검: @context가 없습니다. 파서가 어휘를 알 수 있도록 "@context": "https://schema.org"를 추가하세요. 이 객체에 @type이 없습니다. 타입이 있는 노드를 찾지 못했습니다.

{ "@type": "Article", "headline": "x", "author": { "@type": "Person", "name": "y" } }

문서 전체 점검: 오류, @context가 없습니다. 파서가 어휘를 알 수 있도록 "@context": "https://schema.org"를 추가하세요.
Article과 Person 카드는 평소대로 표시

자주 하는 실수

• JSON-LD가 아닌 script 태그를 붙여 넣기

  <script type="application/ld+json"> 블록은 태그를 벗겨 주지만, 다른 type의 스크립트나 JavaScript가 든 스크립트는 JSON이 아니어서 파싱에 실패합니다. 페이지에 ld+json 블록이 없으면 그렇다고 알려 줍니다.

• 마지막 쉼표와 작은따옴표

  JSON은 마지막 쉼표, 주석, 작은따옴표 문자열을 허용하지 않습니다. 파싱 오류의 가장 흔한 원인입니다.

• "완전함"을 리치 결과 자격으로 착각

  완전함은 이 도구의 점검표에서 빠진 것이 없다는 뜻일 뿐입니다. 점검표가 없는 타입은 항상 완전함으로 나오고, 구글은 기능별로 자체 요구 사항을 적용합니다.

• 중첩 객체도 검사된다는 점을 잊는 경우

  다른 노드 안의 author Person이나 offers Offer도 자기 점검표를 가지므로, 빠진 속성이 합계에 반영됩니다. @type이 없는 중첩 객체는 검색엔진이 분류할 수 없으므로 지적합니다.

• 화면에 없는 내용을 마크업

  구조화 데이터는 방문자가 실제로 볼 수 있는 내용을 설명해야 합니다. 보이는 내용과 맞지 않는 마크업은 구글이 무시하거나 조치할 수 있는데, 이는 어떤 검사기로도 알 수 없습니다.

• @context를 안쪽 노드에만 두는 경우

  컨텍스트 검사는 최상위 객체나 배열 항목을 봅니다. @graph 항목 안쪽에만 둔 컨텍스트는 누락으로 표시됩니다.

자주 묻는 질문