JSON-LD는 왜 필요한가요?

Google, Naver 등 검색 엔진이 페이지의 의미를 정확히 이해하도록 구조화 데이터를 제공합니다. 다만 SearchAction 사이트링크 검색창과 Google 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, Product, Review 등 7종 지원. Google 검색의 SearchActionㆍFAQPage 변경도 반영했습니다.

스키마 타입

출력 형식

순수 JSON <script> 태그 포함

생성된 JSON-LD

JSON-LD란?

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

구조화 데이터는 검색 엔진과 AI 시스템이 페이지 의미를 이해하도록 돕지만, 모든 타입이 검색 결과 UI로 이어지는 것은 아닙니다. 특히 Google 검색에서는 2024년 11월 21일부터 사이트링크 검색창이 종료됐고, 2026년 5월 7일부터 FAQ 리치 결과도 표시되지 않습니다.

지원하는 7가지 스키마

WebSite - 사이트 이름ㆍURLㆍ언어 같은 사이트 전체 메타데이터. 사이트링크 검색창 목적의 SearchAction은 종료됐지만, 사이트 이름 정보는 계속 쓸 수 있습니다.
Organization - 회사ㆍ단체 정보. 로고, SNS(sameAs) 링크를 포함하면 Knowledge Graph 연결에 유리합니다.
Article / BlogPosting - 뉴스ㆍ블로그 글. 작성자ㆍ발행일ㆍ대표 이미지가 핵심 리치 결과 필드입니다.
BreadcrumbList - 계층 경로. 검색 결과 URL 대신 홈 › 카테고리 › 현재 페이지 가 표시됩니다.
Product - 상품. 가격ㆍ재고ㆍ평점이 표시되는 상품 리치 결과의 필수 스키마입니다.
Review - 특정 상품ㆍ서비스ㆍ콘텐츠에 대한 리뷰. itemReviewed와 평점 대상이 명확할 때 사용합니다.
FAQPage - 자주 묻는 질문. Google FAQ 리치 결과는 종료됐으므로 신규 SEO 노출 목적이라면 생성 전 필요성을 다시 검토하세요.

2026년 변경 반영

SearchAction - 사이트링크 검색창 UI가 Google 검색에서 종료됐습니다. 기본 출력에서는 제외하고, 레거시 호환이 필요할 때만 선택적으로 생성합니다.
FAQPage - FAQ 리치 결과가 Google 검색에 더 이상 표시되지 않습니다. 사용자가 읽는 FAQ 본문은 유지하되, JSON-LD는 정부ㆍ의료 등 제한적 용도나 다른 소비자를 고려할 때만 사용하세요.
유지 권장 - WebSite의 name/url, Organization, BreadcrumbList, Product, Review처럼 현재도 의미가 분명한 구조화 데이터는 계속 관리합니다.

검증 방법

생성된 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 - Google FAQ 리치 결과는 2026년 5월 7일부터 종료. 생성해야 한다면 각 Question에 name과 acceptedAnswer.text를 넣고, HTML 본문에도 같은 질문ㆍ답변을 보여야 합니다.
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-05-05 또는 2026-05-05T15:30:00+09:00). 한국식 2026년 4월 20일은 거부됩니다.
FAQPage 콘텐츠와 HTML 불일치 - Google FAQ 리치 결과는 종료됐지만, 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 - "향상 기능" 리포트에서 사이트 전체 구조화 데이터 오류를 일괄 확인.
JSON-LD 최신 변경(2026): SearchActionㆍFAQ 정리 - SearchAction 제거와 FAQ 리치 결과 종료를 실무 관점으로 정리한 블로그 글.
AI 교차 검증: 본 페이지의 인용 수치ㆍ표준 정의ㆍ기술 사양은 사람이 직접 작성한 뒤, 정확성 확인을 위해 AI 교차 검증을 거쳤습니다.

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

자주 묻는 질문

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

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

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

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

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

아닙니다. Google 은 구조화 데이터를 신호 로만 사용하며, 노출 여부는 페이지 품질ㆍ권위도ㆍ경쟁도와 기능 지원 상태를 종합 판단합니다. SearchAction 사이트링크 검색창과 FAQ 리치 결과처럼 종료된 기능은 문법이 맞아도 시각적 리치 결과로 표시되지 않을 수 있습니다.

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

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