구조화 데이터(JSON-LD) 생성기

마크업을 넣으면 리치 결과가 뜨나요 — 조건이 있습니다

구조화 데이터는 "자격 요건"이지 "보장"이 아닙니다. 마크업이 문법적으로 완벽해도 구글이 표시하지 않을 수 있습니다. 실제로 리치 결과가 붙으려면 대략 이 네 가지가 모두 맞아야 합니다.

• 문법과 필수 항목이 맞을 것 — 이 도구가 잡아 주는 부분입니다. 필수 항목이 비면 아예 대상에서 빠집니다.
• 페이지가 색인되어 있을 것 — 색인되지 않은 페이지에는 리치 결과가 없습니다. robots.txt로 막혀 있으면 마크업도 못 읽습니다.
• 마크업 내용이 화면에 실제로 있을 것 — 아래 항목에서 자세히 다룹니다.
• 구글이 그 유형을 그 상황에 쓸 만하다고 판단할 것 — 이건 통제할 수 없습니다. FAQ가 대표적인 예입니다.

화면에 없는 내용을 마크업에만 적으면 안 되는 이유

이 규칙 하나만 지켜도 사고의 대부분을 피합니다. 구글의 구조화 데이터 정책은 "마크업은 사용자에게 보이는 콘텐츠를 설명해야 한다"입니다. 위반하면 수동 조치를 받고, 그 사이트의 리치 결과가 통째로 사라집니다. 한 페이지가 아니라 사이트 전체가 대상이 될 수 있습니다.

실제로 자주 나오는 위반 유형입니다.

• 리뷰가 하나도 없는 상품 페이지에 aggregateRating 4.8, 리뷰 128개를 적음 — 가장 흔하고 가장 확실하게 걸리는 사례입니다. 자기 회사가 자기 상품에 매긴 별점도 정책 위반입니다.
• 페이지에는 없는 FAQ를 마크업에만 넣음 — 답변이 화면에 있어야 합니다. 접혀 있는 아코디언은 괜찮지만 아예 없으면 안 됩니다.
• 화면의 빵부스러기 메뉴와 다른 순서로 BreadcrumbList를 적음.
• 실제 가격과 다른 price — 값이 다르면 쇼핑 관련 기능에서 제외됩니다.

LocalBusiness — 국내 사업장에서 실제로 중요한 것

동네 가게라면 LocalBusiness가 가장 실익이 큰 유형입니다. 다만 국내 환경에서는 짚어야 할 것이 몇 가지 있습니다.

먼저 이름·주소·전화(NAP)는 홈페이지, 구글 비즈니스 프로필, 네이버 플레이스, 카카오맵에서 글자 단위로 같아야 합니다. "테헤란로 123, 4층"과 "테헤란로123 4층"처럼 미묘하게 다르면 검색엔진이 같은 업체인지 확신하지 못합니다. 이 마크업은 구글이 이미 가진 정보와 대조하는 근거로 쓰이므로, 값이 어긋나면 도움이 안 되거나 오히려 혼란을 줍니다.

@type은 가능한 한 구체적으로 고르세요. LocalBusiness보다 CafeOrCoffeeShop, Dentist, ExerciseGym 처럼 하위 유형이 정확할수록 검색엔진의 이해가 정확해집니다. 목록에 딱 맞는 게 없을 때만 LocalBusiness나 ProfessionalService를 씁니다.

• 지점이 여러 곳이면 지점마다 별도 페이지에 각각의 마크업을 넣습니다. 한 페이지에 여러 지점을 몰아넣으면 인식되지 않습니다.
• 영업시간은 요일 체크만 풀면 그 요일이 휴무로 처리되어 빠지고, 같은 시간대인 요일은 자동으로 한 항목에 묶입니다. 24시간 영업은 00:00 ~ 23:59.
• 브레이크 타임처럼 하루에 두 구간인 영업시간은 이 폼으로 만들 수 없습니다. 생성된 JSON의 openingHoursSpecification 항목을 손으로 복제해 시간을 나눠 적으세요.
• 위도·경도는 네이버 지도나 구글 지도에서 해당 위치를 우클릭하면 확인됩니다. 둘 다 있어야 geo 가 만들어집니다.
• sameAs 에는 네이버 플레이스·인스타그램·블로그 주소를 넣습니다. 검색엔진이 흩어진 계정을 이 사업장과 연결하는 근거가 됩니다.

유형 고르기와 페이지당 개수

한 페이지에 여러 유형을 넣어도 됩니다. 블로그 글 페이지에 BlogPosting과 BreadcrumbList를 각각 만들어 script 블록 두 개로 넣는 것이 일반적입니다. 이 도구는 한 번에 한 유형씩 만들므로, 유형을 바꿔 가며 두 번 복사해 붙여넣으면 됩니다. 입력값은 유형별로 각각 브라우저에 저장되니 왔다 갔다 해도 지워지지 않습니다.

FAQPage는 기대치를 낮춰 잡으세요. 구글은 2023년부터 FAQ 리치 결과를 정부·의료 등 일부 사이트에만 표시합니다. 마크업을 넣는 것 자체는 문제없고 페이지 이해에는 도움이 되지만, 검색결과에 펼침 UI가 뜰 것으로 기대하고 작업량을 들일 필요는 없습니다.

붙여넣은 뒤 반드시 확인하세요

1. 생성된 script 블록을 그 페이지 HTML의 head 안이나 body 끝 어디든 붙여넣습니다. 위치는 상관없습니다.
2. 구글 리치 결과 테스트(search.google.com/test/rich-results)에 페이지 주소를 넣어 인식되는지 봅니다. 배포 전이라면 코드를 직접 붙여 검사할 수도 있습니다.
3. schema.org 검증기(validator.schema.org)로 스키마 문법 자체도 확인합니다. 구글 도구는 구글이 쓰는 유형만 검사합니다.
4. 며칠 뒤 서치 콘솔의 향상 기능 보고서에서 오류·경고를 확인합니다. 여기서 잡히는 것이 실제 반영 상태입니다.
5. 페이지 내용을 고칠 때마다 마크업도 같이 고칩니다. 가격을 바꿨는데 마크업이 옛 가격이면 그때부터 불일치입니다.