Schema 마크업 검증기
거의 통과하는 구조화 데이터는 리치 결과를 조용히 만들어내지 못하는 구조화 데이터입니다. 여기에 JSON-LD 블록을 붙여넣으면 이 검증기가 두 가지를 곧바로 확인합니다. 유효한 JSON으로 파싱되는지, 그리고 모든 Schema.org 항목에 필요한 핵심 요소인 @context, @type, 그리고 name 또는 headline이 들어 있는지입니다. 더 느린 리치 결과 테스트를 돌리기 전에 하는 빠른 구조 점검이라고 생각하세요. 깨진 괄호나 빠진 타입을 몇 초 만에 찾아냅니다.
schema 마크업 점검 방법
-
1
JSON-LD 붙여넣기
`<script type="application/ld+json">` 블록 전체 또는 그 안의 JSON 객체만 붙여넣으세요. script 태그는 자동으로 제거됩니다.
-
2
점검 실행
검증기가 JSON을 파싱하고, 파싱되지 않으면 고쳐야 할 정확한 구문 오류를 짚어 줍니다.
-
3
결과 읽기
핵심 키(`@context`, `@type`, 그리고 `name` 또는 `headline`)가 모두 있는지 확인하거나, 어느 것이 빠졌는지 정확히 나열합니다.
-
4
수정 후 다시 점검
스니펫을 고치고 결과가 깨끗해질 때까지 다시 실행한 뒤, 타입별 세부 규칙은 구글의 리치 결과 테스트로 확인하세요.
흔한 검증 오류와 해결 방법
마크업을 구글의 리치 결과 테스트 같은 본격 검증기에 넣으면, 실패의 대부분은 똑같이 짧은 실수 목록에서 나옵니다. 이를 알아보는 법을 익히면 디버깅 시간이 크게 줄어듭니다.
자주 등장하는 실수
| 오류 메시지 | 의미 | 해결 방법 |
|---|---|---|
| “image” 필드 누락 | 필수 필드가 빠짐 | 이미지 URL(절대 경로)을 최소 하나 추가 |
| “datePublished”가 유효한 날짜가 아님 | 잘못된 형식 | ISO 8601 사용: 2026-04-18 또는 시간+오프셋 |
| 알 수 없는 타입 “Offers” | 잘못된 대소문자 | offers 배열 안에 Offer(단수) 사용 |
| 필수 필드 “price” 누락 | 가격 없는 Product | offers에 price와 priceCurrency 추가 |
| “author” 값이 문자열 | Person/Organization 객체여야 함 | { "@type": "Person", "name": "..." }로 감싸기 |
@id 중복 |
두 노드에 같은 식별자 | 엔티티마다 고유한 @id 사용 |
reviewCount가 0인데 aggregateRating 있음 |
별점 스니펫은 리뷰 최소 1개 필요 | 평점을 빼거나 리뷰가 생길 때까지 대기 |
| URL이 “/” (상대 경로) | 파서는 절대 URL을 요구 | 전체 https://example.com/path 사용 |
경고 vs 오류
- 오류는 리치 결과가 부적격임을 뜻합니다. 먼저 고치세요.
- 경고는 적격이지만, 더 큰 스니펫을 여는 속성이 빠졌다는 뜻입니다(예: Product에
brand와sku추가).
신뢰할 수 있는 마크업을 위한 팁
- 깊은 검증 전에 구조부터 점검하세요. 깨진 괄호나 빠진
@type을 여기서 고치면, 더 느린 타입별 도구로 오가는 왕복을 아낄 수 있습니다. - 마크업을 콘텐츠와 동기화하세요.
headline을 업데이트하지 않고 페이지 제목만 바꾸는 것은 불일치로 표시되는 가장 빠른 길입니다. - 유지보수를 위해 JSON-LD를 선호하세요. 단일 블록이 HTML 곳곳에 흩어진 속성보다 점검하기 쉽습니다.
- Search Console을 모니터링하세요. 구글은 타입별 구조화 데이터 오류와 개선 사항을 기록합니다. 월별로 확인하세요.
자주 묻는 질문
아니요. 이는 JSON-LD가 올바르게 구성되고 핵심 키를 갖췄다는 뜻일 뿐입니다. 리치 결과에는 타입별 필수 속성, 마크업과 실제로 일치하는 콘텐츠, 그리고 구글의 품질 기준도 필요합니다. 이 도구로 기본을 빠르게 고친 뒤, 구글의 리치 결과 테스트에서 적격 여부를 확인하세요.
이것은 가벼운 구조 점검입니다. JSON이 파싱되는지, 그리고 @context, @type, name 또는 headline이 있는지 확인합니다. 구글의 테스트는 한발 더 나아가 적격 타입마다 필수 속성을 검증합니다. 먼저 이 도구로 명백한 오류를 없애고, 그다음 구글의 테스트로 타입별 세부 규칙을 확인하세요.
네. <script type="application/ld+json">…</script> 블록 전체 또는 그 안의 JSON 객체만 붙여넣으세요. 감싸는 script 태그는 파싱 전에 제거됩니다. 한 번에 한 블록씩 검증하세요.
아니요. 스니펫은 점검을 실행하기 위해서만 저희 서버로 전송되며 직후에 폐기됩니다. 붙여넣은 내용은 어떤 것도 저장되지 않습니다.
관련 도구
외부 링크 추출기
원시 HTML을 붙여넣고 필요에 따라 기본 URL을 지정하면, 코드에 포함된 모든 외부 http/https 링크를 중복 없이 정리된 목록으로 제공합니다. 링크 감사와 SEO 검토에 유용합니다.
FAQ 스키마 생성기
질문과 답변 쌍으로 FAQPage JSON-LD 마크업을 생성해 Google의 리치 결과와 답변 상자 노출 자격을 얻으세요.
hreflang 검사기
붙여 넣은 HTML의 hreflang을 로컬에서 검사합니다. 코드, 전체 URL, 중복, 위치와 선택적 자기 참조를 확인하세요.
HTTP 보안 헤더 검사기
HTTP 응답 헤더를 붙여넣고 HSTS, CSP, 클릭재킹, MIME, 리퍼러, 교차 출처 정책을 브라우저에서 점검하세요.
Google SERP 시뮬레이터
모바일과 데스크톱의 글자 수 제한으로 Google 스타일 검색 스니펫을 대략 확인하세요. 초안은 이 브라우저 세션에만 남습니다.
링크 단축 해독기
bit.ly, t.co, tinyurl 등 단축 링크를 펼칩니다. 클릭하기 전에 모든 리디렉트 홉, 상태 코드, 최종 목적지를 확인하세요.
이 도구는 다른 언어로도 제공됩니다
- Validador de Marcado de Esquema [ES]
- Validateur de balisage Schema [FR]
- Validator Markup Skema [ID]
- Schema Markup-validator [SV]
- مُدقّق ترميز المخطط (Schema) [AR]
- スキーママークアップ検証ツール [JA]
- Walidator znaczników schema [PL]
- Schema-markup-validator [NL]
- Trình xác thực đánh dấu Schema [VI]
- เครื่องมือตรวจสอบสกีมามาร์กอัป (Schema Markup Validator) [TH]
- Validador de Marcação de Schema [PT]
- Schema-Markup-Validator [DE]
- Валидатор разметки Schema [RU]
- Şema İşaretlemesi Doğrulayıcı [TR]
- 结构化数据标记验证器 [ZH]
- Schema Markup Validator [EN]
- Validatore di Schema Markup [IT]