Schema 마크업 검증기

다음

거의 통과하는 구조화 데이터는 리치 결과를 조용히 만들어내지 못하는 구조화 데이터입니다. 여기에 JSON-LD 블록을 붙여넣으면 이 검증기가 두 가지를 곧바로 확인합니다. 유효한 JSON으로 파싱되는지, 그리고 모든 Schema.org 항목에 필요한 핵심 요소인 @context, @type, 그리고 name 또는 headline이 들어 있는지입니다. 더 느린 리치 결과 테스트를 돌리기 전에 하는 빠른 구조 점검이라고 생각하세요. 깨진 괄호나 빠진 타입을 몇 초 만에 찾아냅니다.

schema 마크업 점검 방법

  1. 1

    JSON-LD 붙여넣기

    `<script type="application/ld+json">` 블록 전체 또는 그 안의 JSON 객체만 붙여넣으세요. script 태그는 자동으로 제거됩니다.

  2. 2

    점검 실행

    검증기가 JSON을 파싱하고, 파싱되지 않으면 고쳐야 할 정확한 구문 오류를 짚어 줍니다.

  3. 3

    결과 읽기

    핵심 키(`@context`, `@type`, 그리고 `name` 또는 `headline`)가 모두 있는지 확인하거나, 어느 것이 빠졌는지 정확히 나열합니다.

  4. 4

    수정 후 다시 점검

    스니펫을 고치고 결과가 깨끗해질 때까지 다시 실행한 뒤, 타입별 세부 규칙은 구글의 리치 결과 테스트로 확인하세요.

흔한 검증 오류와 해결 방법

마크업을 구글의 리치 결과 테스트 같은 본격 검증기에 넣으면, 실패의 대부분은 똑같이 짧은 실수 목록에서 나옵니다. 이를 알아보는 법을 익히면 디버깅 시간이 크게 줄어듭니다.

자주 등장하는 실수

오류 메시지 의미 해결 방법
“image” 필드 누락 필수 필드가 빠짐 이미지 URL(절대 경로)을 최소 하나 추가
“datePublished”가 유효한 날짜가 아님 잘못된 형식 ISO 8601 사용: 2026-04-18 또는 시간+오프셋
알 수 없는 타입 “Offers” 잘못된 대소문자 offers 배열 안에 Offer(단수) 사용
필수 필드 “price” 누락 가격 없는 Product offers에 pricepriceCurrency 추가
“author” 값이 문자열 Person/Organization 객체여야 함 { "@type": "Person", "name": "..." }로 감싸기
@id 중복 두 노드에 같은 식별자 엔티티마다 고유한 @id 사용
reviewCount가 0인데 aggregateRating 있음 별점 스니펫은 리뷰 최소 1개 필요 평점을 빼거나 리뷰가 생길 때까지 대기
URL이 “/” (상대 경로) 파서는 절대 URL을 요구 전체 https://example.com/path 사용

경고 vs 오류

  • 오류는 리치 결과가 부적격임을 뜻합니다. 먼저 고치세요.
  • 경고는 적격이지만, 더 큰 스니펫을 여는 속성이 빠졌다는 뜻입니다(예: Product에 brandsku 추가).

신뢰할 수 있는 마크업을 위한 팁

  • 깊은 검증 전에 구조부터 점검하세요. 깨진 괄호나 빠진 @type을 여기서 고치면, 더 느린 타입별 도구로 오가는 왕복을 아낄 수 있습니다.
  • 마크업을 콘텐츠와 동기화하세요. headline을 업데이트하지 않고 페이지 제목만 바꾸는 것은 불일치로 표시되는 가장 빠른 길입니다.
  • 유지보수를 위해 JSON-LD를 선호하세요. 단일 블록이 HTML 곳곳에 흩어진 속성보다 점검하기 쉽습니다.
  • Search Console을 모니터링하세요. 구글은 타입별 구조화 데이터 오류와 개선 사항을 기록합니다. 월별로 확인하세요.

자주 묻는 질문

아니요. 이는 JSON-LD가 올바르게 구성되고 핵심 키를 갖췄다는 뜻일 뿐입니다. 리치 결과에는 타입별 필수 속성, 마크업과 실제로 일치하는 콘텐츠, 그리고 구글의 품질 기준도 필요합니다. 이 도구로 기본을 빠르게 고친 뒤, 구글의 리치 결과 테스트에서 적격 여부를 확인하세요.

이것은 가벼운 구조 점검입니다. JSON이 파싱되는지, 그리고 @context, @type, name 또는 headline이 있는지 확인합니다. 구글의 테스트는 한발 더 나아가 적격 타입마다 필수 속성을 검증합니다. 먼저 이 도구로 명백한 오류를 없애고, 그다음 구글의 테스트로 타입별 세부 규칙을 확인하세요.

네. <script type="application/ld+json">…</script> 블록 전체 또는 그 안의 JSON 객체만 붙여넣으세요. 감싸는 script 태그는 파싱 전에 제거됩니다. 한 번에 한 블록씩 검증하세요.

아니요. 스니펫은 점검을 실행하기 위해서만 저희 서버로 전송되며 직후에 폐기됩니다. 붙여넣은 내용은 어떤 것도 저장되지 않습니다.

관련 도구

이 도구는 다른 언어로도 제공됩니다