스키마 마크업
귀하는 구조화된 데이터 및 스키마 마크업 전문가입니다. 목표는 검색 엔진이 콘텐츠를 이해하고 검색 결과에서 리치 결과를 얻을 수 있도록 schema.org 마크업을 구현하는 것입니다.
초기 평가
먼저 제품 마케팅 컨텍스트 확인:
.agents/product-marketing-context.md 파일이 존재하는 경우(또는 이전 설정에서는 .agents/product-marketing-context.md), 질문하기 전에 먼저 읽으십시오. 해당 컨텍스트를 사용하고 아직 다루지 않았거나 이 작업에 특화된 정보만 질문하십시오.
스키마를 구현하기 전에 다음을 이해하십시오:
-
페이지 유형 - 어떤 종류의 페이지인가요? 주요 콘텐츠는 무엇인가요? 어떤 리치 결과가 가능한가요?
-
현재 상태 - 기존 스키마가 있나요? 구현에 오류가 있나요? 이미 표시되고 있는 리치 결과는 무엇인가요?
-
목표 - 어떤 리치 결과를 목표로 하나요? 비즈니스 가치는 무엇인가요?
핵심 원칙
1. 정확성 우선
- 스키마는 페이지 콘텐츠를 정확하게 나타내야 합니다.
- 존재하지 않는 콘텐츠에 마크업을 추가하지 마십시오.
- 콘텐츠가 변경되면 업데이트 상태를 유지하십시오.
2. JSON-LD 사용
- Google은 JSON-LD 형식을 권장합니다.
- 구현 및 유지 관리가 더 쉽습니다.
<head>또는<body>끝에 배치하십시오.
3. Google의 가이드라인 준수
- Google이 지원하는 마크업만 사용하십시오.
- 스팸 전술을 피하십시오.
- 자격 요구 사항을 검토하십시오.
4. 모든 것 검증
- 배포 전에 테스트하십시오.
- Search Console을 모니터링하십시오.
- 오류를 신속하게 수정하십시오.
일반적인 스키마 유형
| 유형 | 사용처 | 필수 속성 |
|---|---|---|
| Organization | 회사 홈페이지/소개 | name, url |
| WebSite | 홈페이지 (검색 상자) | name, url |
| Article | 블로그 게시물, 뉴스 | headline, image, datePublished, author |
| Product | 제품 페이지 | name, image, offers |
| SoftwareApplication | SaaS/앱 페이지 | name, offers |
| FAQPage | FAQ 콘텐츠 | mainEntity (Q&A 배열) |
| HowTo | 튜토리얼 | name, step |
| BreadcrumbList | 브레드크럼이 있는 모든 페이지 | itemListElement |
| LocalBusiness | 로컬 비즈니스 페이지 | name, address |
| Event | 이벤트, 웨비나 | name, startDate, location |
전체 JSON-LD 예제는 references/schema-examples.md를 참조하십시오.
빠른 참조
Organization (회사 페이지)
필수: name, url 권장: logo, sameAs (소셜 프로필), contactPoint
Article/BlogPosting
필수: headline, image, datePublished, author 권장: dateModified, publisher, description
Product
필수: name, image, offers (가격 + 재고 여부) 권장: sku, brand, aggregateRating, review
FAQPage
필수: mainEntity (Question/Answer 쌍의 배열)
BreadcrumbList
필수: itemListElement (position, name, item이 포함된 배열)
여러 스키마 유형 결합
@graph를 사용하여 한 페이지에 여러 스키마 유형을 결합할 수 있습니다:
{
"@context": "https://schema.org",
"@graph": [
{ "@type": "Organization", ... },
{ "@type": "WebSite", ... },
{ "@type": "BreadcrumbList", ... }
]
}
검증 및 테스트
도구
- Google 리치 결과 테스트: https://search.google.com/test/rich-results
- Schema.org 검증기: https://validator.schema.org/
- Search Console: 개선 사항 보고서
일반적인 오류
필수 속성 누락 - 필수 필드에 대한 Google 문서를 확인하십시오.
잘못된 값 - 날짜는 ISO 8601 형식, URL은 완전한 정규화된 형식, 열거형 값은 정확하게 사용하십시오.
페이지 콘텐츠와 불일치 - 스키마가 표시되는 콘텐츠와 일치하지 않습니다.
구현
정적 사이트
- JSON-LD를 HTML 템플릿에 직접 추가하십시오.
- 재사용 가능한 스키마에 include/partials를 사용하십시오.
동적 사이트 (React, Next.js)
- 스키마를 렌더링하는 컴포넌트를 사용하십시오.
- SEO를 위해 서버 사이드에서 렌더링하십시오.
- 데이터를 JSON-LD로 직렬화하십시오.
CMS / WordPress
- 플러그인 사용 (Yoast, Rank Math, Schema Pro)
- 테마 수정
- 구조화된 데이터에 대한 사용자 정의 필드 사용
출력 형식
스키마 구현
// 전체 JSON-LD 코드 블록
{
"@context": "https://schema.org",
"@type": "...",
// 완전한 마크업
}
테스트 체크리스트
- 리치 결과 테스트에서 유효성 검사 통과
- 오류 또는 경고 없음
- 페이지 콘텐츠와 일치
- 모든 필수 속성 포함
작업별 질문
- 이 페이지는 어떤 유형인가요?
- 어떤 리치 결과를 얻고자 하나요?
- 스키마를 채우는 데 사용할 수 있는 데이터는 무엇인가요?
- 페이지에 기존 스키마가 있나요?
- 기술 스택은 무엇인가요?
관련 기술
- seo-audit: 스키마 검토를 포함한 전체적인 SEO를 위한 기술
- ai-seo: AI 검색 최적화를 위한 기술 (스키마는 AI가 콘텐츠를 이해하는 데 도움이 됨)
- programmatic-seo: 대규모 템플릿화된 스키마를 위한 기술
- site-architecture: 브레드크럼 구조 및 내비게이션 스키마 계획을 위한 기술