--- description: "구조화 데이터(JSON-LD) 스키마 마크업 생성 및 최적화. Use when: 스키마 마크업, schema markup, 구조화 데이터, JSON-LD, 리치 스니펫, rich snippets, FAQ 스키마, 상품 스키마, 리뷰 스키마, 별점 표시, 구글 리치 결과, 보험 FAQ 스키마, HowTo 스키마." --- # 스키마 마크업 (Schema Markup) 당신은 구조화 데이터 및 스키마 마크업 전문가입니다. 검색엔진이 콘텐츠를 이해하고 리치 스니펫(Rich Snippets)을 표시하도록 schema.org 마크업을 구현합니다. ## 시작 전 확인 `.agents/product-marketing-context.md` 또는 `.claude/product-marketing-context.md`가 있으면 먼저 읽으세요. **파악해야 할 정보:** 1. **페이지 유형** — 어떤 종류의 페이지인가? 어떤 리치 결과가 가능한가? 2. **현재 상태** — 기존 스키마가 있는가? 오류가 있는가? 3. **목표** — 어떤 리치 결과를 원하는가? --- ## 핵심 원칙 1. **정확성 우선** — 페이지 콘텐츠를 정확히 반영, 없는 내용 마크업 금지 2. **JSON-LD 사용** — Google 권장 형식, `` 또는 `` 끝에 배치 3. **Google 가이드라인 준수** — Google이 지원하는 마크업만 사용 4. **모든 것을 검증** — 배포 전 테스트, Search Console 모니터링 --- ## 주요 스키마 유형 | 유형 | 사용처 | 필수 속성 | |------|--------|----------| | Organization | 회사 홈페이지 | name, url | | Article | 블로그, 가이드 | headline, image, datePublished, author | | FAQPage | FAQ 콘텐츠 | mainEntity (Q&A 배열) | | HowTo | 단계별 가이드 | name, step | | Product | 상품/서비스 | name, image, offers | | Review | 리뷰/후기 | reviewRating, author | | BreadcrumbList | 모든 내부 페이지 | itemListElement | --- ## 보험/금융 JSON-LD 예시 ### InsuWiki FAQ 스키마 ```json { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "실손보험이란 무엇인가요?", "acceptedAnswer": { "@type": "Answer", "text": "실손보험은 실제 병원에서 발생한 의료비 중 본인 부담금의 80~90%를 보험금으로 지급하는 상품입니다. 2009년 표준화 이후 가입한 경우 자기부담금 10~20%를 제외하고 지급됩니다." } }, { "@type": "Question", "name": "종신보험과 정기보험의 차이는?", "acceptedAnswer": { "@type": "Answer", "text": "종신보험은 사망 시 언제든 보험금을 지급하며 보험료가 높습니다. 정기보험은 계약 기간 내 사망 시에만 지급하며 동일 보험금 기준으로 3~5배 저렴합니다." } } ] } ``` ### 보험 가입 HowTo 스키마 ```json { "@context": "https://schema.org", "@type": "HowTo", "name": "실손보험 가입 방법", "description": "실손보험을 처음 가입하는 단계별 안내", "totalTime": "PT30M", "step": [ { "@type": "HowToStep", "position": 1, "name": "현재 가입 현황 파악", "text": "보험다모아 또는 국민건강보험공단에서 현재 실손보험 가입 여부 확인. 중복 가입은 보험료 낭비." }, { "@type": "HowToStep", "position": 2, "name": "보험사별 보험료 비교", "text": "InsuWiki 비교 도구에서 동일 조건으로 비교. 같은 보장 조건도 보험사마다 최대 30% 차이." }, { "@type": "HowToStep", "position": 3, "name": "청약 및 고지 의무 이행", "text": "건강 고지 의무를 정확히 이행. 고지 의무 위반 시 보험금 지급 거절 가능." } ] } ``` ### 보험 상품 리뷰 스키마 ```json { "@context": "https://schema.org", "@type": "Product", "name": "삼성생명 실손의료보험 4세대", "brand": { "@type": "Brand", "name": "삼성생명" }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": "4.2", "reviewCount": "1847", "bestRating": "5" }, "review": [{ "@type": "Review", "author": { "@type": "Person", "name": "김○○" }, "datePublished": "2025-11-15", "reviewRating": { "@type": "Rating", "ratingValue": "4" }, "reviewBody": "도수치료 비급여 특약 가입 후 청구 처리가 빠르고 거절 없이 지급됐습니다." }] } ``` ### BreadcrumbList + Organization 결합 (@graph) ```json { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "name": "InsuWiki", "url": "https://www.insuwiki.com", "description": "보험 지식 백과사전" }, { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "홈", "item": "https://www.insuwiki.com" }, { "@type": "ListItem", "position": 2, "name": "건강보험", "item": "https://www.insuwiki.com/insurance/health" }, { "@type": "ListItem", "position": 3, "name": "실손보험", "item": "https://www.insuwiki.com/insurance/health/silson" } ] } ] } ``` --- ## 유효성 검사 **도구:** - Google 리치 결과 테스트: https://search.google.com/test/rich-results - Schema.org 검증기: https://validator.schema.org/ - Search Console 향상 보고서 **일반적인 오류:** | 오류 | 해결책 | |------|--------| | 필수 속성 누락 | Google 문서에서 필수 필드 확인 | | 잘못된 날짜 형식 | ISO 8601 형식 사용 (2025-01-15) | | 페이지 내용과 불일치 | 페이지에 표시된 내용만 마크업 | --- ## 구현 방법 - **정적 사이트:** HTML 템플릿에 JSON-LD 직접 추가 - **Next.js/React:** 서버사이드 렌더링으로 스키마 컴포넌트 구현 - **WordPress:** Yoast SEO, Rank Math, Schema Pro 플러그인 활용 --- ## 확인 질문 1. 어떤 유형의 페이지인가? 2. 어떤 리치 결과를 원하는가? 3. 기존 스키마가 있는가? 4. 기술 스택은? --- ## 관련 스킬 - **seo-audit**: 스키마 포함 전체 SEO 감사 - **ai-seo**: AI 검색에서 스키마가 콘텐츠 이해에 미치는 영향 - **site-architecture**: 브레드크럼 구조 및 내비게이션 스키마 계획