JSON-LD는 왜 필요한가요?

Google, Naver 등 검색 엔진이 페이지의 의미를 정확히 이해하도록 구조화 데이터를 제공합니다. 리치 결과(별점, 가격, FAQ 등)로 노출되면 클릭률이 크게 높아집니다.

생성된 JSON-LD는 어디에 넣나요?

HTML의 또는 안 어디든 태그로 감싸서 넣으면 됩니다. 본 도구의 '스크립트 태그로 감싸기' 옵션을 켜면 바로 붙여넣기 가능한 형태로 출력됩니다.

입력한 값이 서버로 전송되나요?

아니요. 모든 생성은 브라우저 안에서만 이루어지며 외부로 전송되지 않습니다. 민감한 데이터를 넣어도 안전합니다.

유효성은 어떻게 확인하나요?

Google의 Rich Results Test(https://search.google.com/test/rich-results) 또는 Schema Markup Validator(https://validator.schema.org)에 출력된 JSON-LD를 붙여넣어 검증할 수 있습니다.

JSON-LD 생성기

Schema.org 구조화 데이터를 폼 입력만으로 생성합니다. WebSite, Organization, Article, BreadcrumbList, FAQPage, Product 6종 지원.

스키마 타입

출력 형식

순수 JSON <script> 태그 포함

생성된 JSON-LD

JSON-LD란?

JSON-LD(JSON for Linking Data) 는 Schema.org 어휘를 사용해 웹 페이지의 의미를 검색 엔진에 전달하는 구조화 데이터 형식입니다. Google·Naver·Bing 등이 공식 권장하는 방식으로, HTML <script type="application/ld+json"> 태그 안에 JSON 을 넣기만 하면 됩니다.

구조화 데이터를 넣으면 검색 결과가 단순 파란 링크가 아니라 별점·가격·FAQ 아코디언·브레드크럼·썸네일 같은 리치 형태로 확장돼 CTR 이 1.5~3배 상승하는 사례가 많습니다.

지원하는 6가지 스키마

WebSite - 사이트 전체 메타데이터. 홈페이지에 한 번 넣으면 사이트 링크 검색창(Sitelinks Search Box) 후보가 됩니다.
Organization - 회사·단체 정보. 로고, SNS(sameAs) 링크를 포함하면 Knowledge Graph 연결에 유리합니다.
Article / BlogPosting - 뉴스·블로그 글. 작성자·발행일·대표 이미지가 핵심 리치 결과 필드입니다.
BreadcrumbList - 계층 경로. 검색 결과 URL 대신 홈 › 카테고리 › 현재 페이지 가 표시됩니다.
FAQPage - 자주 묻는 질문. Google 이 아코디언으로 펼쳐서 보여줘 SERP 면적을 크게 차지합니다.
Product - 상품. 가격·재고·평점이 표시되는 상품 리치 결과의 필수 스키마입니다.

검증 방법

생성된 JSON-LD 는 반드시 아래 공식 도구로 검증하세요.

Google Rich Results Test - Google 리치 결과 노출 가능 여부 확인
Schema Markup Validator - Schema.org 표준 문법 검증

타입별 필수·권장 필드

Rich Results에 실제로 노출되려면 "필수" 필드가 모두 채워져야 합니다. Google 공식 가이드 기준으로 정리했습니다.

Article - 필수: headline, image, datePublished. 권장: author, dateModified, publisher.logo. 이미지는 최소 1200px 너비 권장.
FAQPage - 각 Question에 name과 acceptedAnswer.text 필수. HTML 본문에 동일한 질문·답변이 보여야 하며, 없는 내용을 JSON-LD에만 넣으면 스팸 정책 위반.
BreadcrumbList - 각 ListItem에 position, name, item(URL). 마지막 항목은 item 생략 가능.
Product - 필수: name, image, offers.price, offers.priceCurrency. 리뷰·평점을 넣으려면 aggregateRating 또는 review 추가.
Recipe - 필수: name, image, recipeIngredient, recipeInstructions. 조리시간·영양정보·평점 추가 시 리치 결과가 더 풍부해집니다.
Event - 필수: name, startDate, location. 온라인 이벤트는 eventAttendanceMode: OnlineEventAttendanceMode, location: VirtualLocation 형태.
LocalBusiness - 지역 비즈니스 정보. address, telephone, openingHoursSpecification. 구글 비즈니스 프로필과 별개이므로 둘 다 일관되게 운영.

자주 발생하는 오류와 해결

"The value provided for X is invalid" - 날짜는 ISO 8601(2026-04-20 또는 2026-04-20T15:30:00+09:00). 한국식 2026년 4월 20일은 거부됩니다.
FAQPage 콘텐츠와 HTML 불일치 - Google은 2023년부터 FAQPage를 일부 웹사이트에서만 리치 결과로 표시하며, JSON-LD의 질문이 페이지 HTML에 없으면 스팸으로 판단.
itemReviewed 누락 - 리뷰 관련 스키마(Review, AggregateRating)는 itemReviewed(Book·Product·Service 등)가 반드시 있어야 합니다.
이미지 URL이 상대 경로 - /image.jpg 같은 상대 경로는 Google이 해석 못 할 수 있습니다. https://example.com/image.jpg 절대 URL 사용.
여러 JSON-LD 블록 허용 - 한 페이지에 Article + BreadcrumbList + FAQPage를 각각 별도 <script type="application/ld+json">으로 둬도 무방.

공식 근거·참고 자료

Google Search 구조화 데이터 갤러리 - 지원되는 모든 리치 결과 타입 목록과 각 필드 요구사항.
Schema.org - JSON-LD 어휘 표준 공식 사이트.
Google 구조화 데이터 가이드라인 - 스팸 정책·품질 요구사항.
JSON-LD 공식 문서 - JSON-LD 1.1 스펙.
Google Search Console - "향상 기능" 리포트에서 사이트 전체 구조화 데이터 오류를 일괄 확인.

구조화 데이터와 함께 SEO 기반을 갖추려면 robots.txt 생성기로 크롤러 접근을 설정하고, 파비콘 생성기로 사이트 브랜딩을 완성하세요. 지원하는 스키마 타입의 전체 목록은 Schema.org 타입 정리에서 확인할 수 있습니다.

자주 묻는 질문

JSON-LD 를 HTML 어디에 넣어야 하나요?

<head> 안이 가장 일반적이지만, <body> 어디든 상관없습니다. Google 은 렌더링된 최종 HTML 에서 JSON-LD 를 파싱하므로 동적으로 삽입해도 인식됩니다.

한 페이지에 여러 스키마를 넣을 수 있나요?

네. 예를 들어 상품 상세 페이지에 Product + BreadcrumbList + FAQPage 를 동시에 넣을 수 있습니다. 각각 별도의 <script type="application/ld+json"> 블록으로 넣거나, @graph 배열로 묶어서 한 블록에 넣어도 됩니다.

구조화 데이터만 넣으면 리치 결과가 바로 나오나요?

아닙니다. Google 은 구조화 데이터를 신호 로만 사용하며, 노출 여부는 페이지 품질·권위도·경쟁도 등을 종합 판단합니다. 구조화 데이터 자체는 리치 결과 후보 가 되기 위한 최소 조건입니다.

잘못된 JSON-LD 가 SEO 에 해가 되나요?

문법 오류는 Google 이 무시하기 때문에 직접적인 페널티는 없습니다. 다만 가짜 리뷰·관련 없는 구조화 데이터로 사용자를 속이는 경우 스팸 정책 위반 으로 수동 조치 대상이 될 수 있습니다.