웹마스터와 SEO

구조화 데이터 검사게시 전 JSON-LD 점검

코드를 편집하며 정리된 결과와 용어 안내, 현재 입력의 노드 관계를 함께 확인하세요.

자동 검사

JSON-LD 입력

정리된 결과

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "WebSite",
      "@id": "https://example.com/#site",
      "name": "Example",
      "url": "https://example.com/"
    },
    {
      "@type": "WebPage",
      "@id": "https://example.com/#page",
      "name": "About",
      "isPartOf": {
        "@id": "https://example.com/#site"
      }
    }
  ]
}

JSON-LD는 이 브라우저 탭에서만 처리하며 URL이나 외부 문맥을 가져오지 않습니다.

옵션

Schema.org 어휘 스냅샷 30.1

엄격한 JSON, 보이는 노드와 용어 존재 여부만 확인합니다.

노드 2개 · 안내 0개

진단

Schema.org 30.1 어휘를 대조했습니다.

문제가 없습니다.

현재 입력의 노드

2/2개 표시

/@graph/0 · 타입: WebSite · ID: https://example.com/#site
/@graph/1 · 타입: WebPage · ID: https://example.com/#page

명시적 참조 1개

https://example.com/#page · isPartOf → https://example.com/#site · 대상이 입력에 있음

Schema.org 공식 검사 열기 Google 리치 결과 테스트 열기

CMS가 만든 JSON이 파싱되더라도 속성 철자가 틀리거나 @id 참조가 다른 노드를 가리킬 수 있습니다. 구조화 데이터 검사는 원본 옆에서 문법, 어휘, 관계를 나누어 보여 줍니다.

이 JSON-LD 검증기의 스키마 마크업 검사는 고정된 Schema.org 용어 목록을 사용합니다. 실제 검색 노출은 게시된 페이지와 Google의 현재 규칙에 따라 달라집니다.

구조화 데이터 검사가 필요한 이유

읽기 좋은 코드와 검사 범위를 분명히 밝힌 진단을 제공합니다.

엔터티 연결을 한눈에

구조화 데이터 검사는 배열, 중첩 객체, @graph의 노드와 명시적인 @id 참조를 나열합니다. 현재 붙여 넣은 부분에 대상이 없어도 유효하지 않다고 단정하지 않습니다.

검사 범위 보기

두 JSON-LD 노드가 @id 참조로 이어져 노드 및 관계 목록에 표시된 모습.

철자 안내와 검색 판정을 구분

Schema.org 30.1 목록에 없는 타입과 속성을 알려 줍니다. 다른 @context는 어휘 검사를 건너뛰며, 안내를 Google 리치 결과 판정으로 표시하지 않습니다.

잘못 쓴 Schema.org 속성에 로컬 어휘 안내가 붙고 원본 코드는 유지되는 모습.

게시 전 코드 조각을 확인하는 순서

JSON-LD 본문 준비

최상위 배열과 @graph를 그대로 붙일 수 있습니다. HTML에서 script를 뽑거나 URL을 가져오지 않으므로 태그 안의 JSON만 복사하세요.

예제에는 @id로 연결된 노드 두 개가 있습니다.

진단 층위를 구분

기본 자동 검사는 입력 뒤 350ms에 실행됩니다. 문법, 구조, Schema.org 30.1 어휘를 따로 읽고 자동을 끄면 Ctrl/Cmd+Enter로 실행하세요.

목록에 없는 용어는 경고이며 다른 문맥에서는 어휘 검사를 생략합니다.

게시 페이지와 대조

입력이 바뀌면 이전 결과의 복사와 다운로드가 막힙니다. 일반 마크업 확인은 Schema.org Validator, Google 적격성은 리치 결과 테스트를 직접 여세요.

공식 링크는 입력 내용을 싣지 않은 빈 도구 화면을 엽니다.

문법, 용어와 입력 안의 노드 관계

엄격한 JSON 오류 위치

중복 키와 문장 부호 오류를 행과 열로 알리고 해당 입력 줄을 강조합니다. 정리된 출력은 숫자 표기와 키 순서를 유지합니다.

버전을 밝힌 어휘 조회

구조화 데이터 검사는 Schema.org 문맥임이 확인된 타입과 속성만 30.1 현재 용어 목록과 대조합니다. 사용자 지정 매핑은 이 결과로 판정하지 않습니다.

범위를 제한한 그래프 요약

각 노드의 경로, @type, @id와 명시적 참조를 보여 줍니다. 전체 RDF 확장이나 정규화 대신 지금 붙인 텍스트의 관계만 요약합니다.

로컬 결과로 확정할 수 없는 사항

Google 표시 적격성은 별개: 구조화 데이터 검사는 Google 필수 필드나 실제 페이지 렌더링을 판단하지 않습니다. 문법 통과가 검색 순위나 리치 결과를 보장하지 않습니다.
붙여 넣은 JSON-LD만 처리: URL 가져오기, HTML script 추출, Microdata와 RDFa 파싱은 제공하지 않습니다. 공식 링크를 눌러도 초안이 자동 전송되지 않습니다.
어휘는 30.1 고정 목록: 목록에 없는 이름은 안내일 뿐 사용자 확장이나 새 버전에서 무효라는 뜻이 아닙니다. domainIncludes와 rangeIncludes를 필수 조건으로 쓰지 않습니다.
참조 대상은 현재 입력 기준: @id 대상이 다른 블록에 있을 수 있고 같은 @id를 여러 번 기술할 수도 있습니다. 이 경우를 치명적 오류로 표시하지 않습니다.

구조화 데이터 검사 자주 묻는 질문

JSON-LD와 Microdata·RDFa는 무엇이 다른가요?

JSON-LD는 별도 JSON 스크립트이고 나머지는 HTML 속성에 표시합니다. 이 페이지는 붙여 넣은 JSON-LD만 읽습니다.

구조화 데이터를 넣으면 검색 순위가 오르나요?

순위는 보장되지 않습니다. 구조화 데이터 검사는 문법과 제한된 어휘만 확인하며 검색 결과 표시는 Google이 결정합니다.

acceptedAnswer.text 오류는 왜 발생하나요?

먼저 JSON 문법 오류인지 공식 도구의 타입별 요구 사항인지 구분하세요. 이 도구는 Google의 FAQ 규칙을 일반 Schema.org 오류로 단정하지 않습니다.

한 페이지에 여러 종류의 구조화 데이터를 넣어도 되나요?

네. 배열이나 @graph로 여러 엔터티를 둘 수 있습니다. 다른 script 블록까지 자동으로 가져오지는 않습니다.

Google이 구현한 구조화 데이터를 인식했는지 어떻게 확인하나요?

게시된 URL을 Google 리치 결과 테스트와 Search Console에서 확인하세요. 이곳의 로컬 통과만으로 실제 크롤링 여부를 알 수 없습니다.

빠진 사례가 있나요?

구조화 데이터 검사 시작

연결된 두 노드 예제로 보고서를 익힌 뒤 내 코드에 구조화 데이터 검사를 실행하고 공식 도구에서 최종 확인하세요.

도구로 돌아가기 모든 도구 보기

구조화 데이터 검사게시 전 JSON-LD 점검