# 스키마 마크업 전문가 > 별점, 자주 묻는 질문, 이동 경로와 같은 구글 리치 결과를 위한 스키마 마크업을 쉽게 추가하고 최적화하세요. - Canonical: https://nanoskill.ai/ko/skills/schema-markup-expert-skill - Markdown: https://nanoskill.ai/ko/skills/schema-markup-expert-skill.md - Author: coreyhaines31 - Published: 2026-09-15T02:00:00.000Z - Updated: 2026-09-15T07:14:03.770Z - Language: ko - Source type: github - Popularity signal: 41252 ## Sources - https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema ## Install ```shell npx skills add https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema ``` ## About 스키마 마크업은 구글 검색에서 리치 결과를 얻는 핵심입니다. 스키마 마크업 전문가 스킬은 JSON-LD 구현부터 검증까지 사이트의 구조화된 데이터를 손쉽게 추가, 수정, 최적화할 수 있게 해줍니다. 마케터, 개발자, 검색엔진 최적화 전문가가 별점, 자주 묻는 질문, 이동 경로 등을 지원하는 정확하고 구글 규격을 준수하는 마크업을 제공하여 검색 가시성을 높일 수 있도록 돕습니다. 기본 생성기와 달리 이 스킬은 구글 가이드라인을 정확히 따르며 기사, 제품, 자주 묻는 질문, 사용 방법 등 수십 가지 스키마 유형을 지원하고, @graph를 사용해 여러 유형을 결합하여 포괄적인 마크업을 만들 수 있습니다. 스키마를 페이지 콘텐츠에 매핑하고 업계 표준 도구로 검증하여 정확성을 보장하므로 오류 없이 리치 결과에 바로 사용할 수 있는 코드만 배포할 수 있습니다. 블로그에서 자주 묻는 질문 스니펫을 원하든, 제품 별점이 필요한 전자상거래 스토어를 운영하든, 지식 패널을 원하는 지역 비즈니스를 운영하든, 이 스킬은 바로 사용할 수 있는 템플릿과 단계별 안내를 제공합니다. 정적 HTML부터 넥스트.js와 워드프레스까지 모든 기술 스택에 통합되어 모든 프로젝트에서 스키마 마크업을 쉽게 사용할 수 있습니다. ## Key features - **리치 스니펫 생성**: 별점, FAQ, 이동 경로와 같은 Google 리치 결과 자격을 갖춘 스키마 마크업을 생성합니다. - **JSON-LD 형식**: 모든 페이지에 쉽게 통합할 수 있도록 Google에서 권장하는 형식인 JSON-LD를 사용하여 스키마를 구현합니다. - **포괄적인 유형 지원**: Article, Product부터 HowTo, Event까지 어떤 콘텐츠 유형이든 올바른 schema.org 어휘로 마크업하세요. - **자동 검증**: 배포 전에 오류를 발견하기 위해 Google 리치 결과 테스트 및 Schema.org 검증기로 스키마를 테스트합니다. - **유연한 구현**: 최소한의 코드 변경으로 정적 HTML, JavaScript 프레임워크 또는 WordPress와 같은 CMS 플랫폼에 스키마를 추가하세요. ## Use cases - **FAQ 리치 결과로 CTR 향상**: 콘텐츠 팀은 페이지에 FAQ 스키마를 추가하여 검색 결과에서 확장 가능한 Q&A를 활성화하고 클릭률을 높일 수 있습니다. - **검색에서 제품 세부 정보 표시**: 전자상거래 관리자는 제품 스키마를 구현하여 별점, 가격, 재고 여부를 Google에서 직접 표시할 수 있습니다. - **대규모 스키마 오류 수정**: SEO 전문가는 대규모 사이트 전반의 구조화된 데이터 문제를 검증하고 수정하여 리치 결과 자격을 복원할 수 있습니다. - **브랜드 지식 패널 향상**: 브랜드 관리자는 소셜 프로필이 포함된 Organization 스키마를 배포하여 Google 지식 패널의 정확성을 개선할 수 있습니다. ## Result preview 나노스킬을 위한 완전한 스키마 감사 및 최적화 전략을 확인하세요. 여기에는 이 에이전트 스킬이 생성한 구조화된 데이터 권장 사항, JSON-LD 구현, 리치 결과 최적화가 포함됩니다. ![the demo of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-demo-1.png) ![the demo of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-demo-2.png) ![the demo of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-demo-3.png) ![the demo of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-demo-4.png) ## Result walkthrough ### 설치 스키마 마크업 스킬을 AI 에이전트에 추가하세요. ![the first step of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-step-1.png) ### 작업 설명 웹사이트 URL, 페이지 유형, 스키마 최적화 목표를 제공하세요. ![the second step of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-step-2.png) ### 스키마 감사 받기 구조화된 데이터 권장 사항, JSON-LD 구현, 리치 결과 최적화 가이드를 받으세요. ![the third step of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-step-3.png) ## Skill definition # 스키마 마크업 당신은 구조화된 데이터와 스키마 마크업 전문가입니다. 목표는 검색 엔진이 콘텐츠를 이해하고 검색에서 리치 결과를 가능하게 하는 schema.org 마크업을 구현하는 것입니다. ## 초기 평가 **제품 마케팅 컨텍스트를 먼저 확인하세요:** `.agents/product-marketing.md` 파일이 존재하는 경우(또는 `.claude/product-marketing.md`, 또는 이전 설정에서의 레거시 파일명 `product-marketing-context.md`), 질문하기 전에 읽으세요. 해당 컨텍스트를 사용하고 이미 다루어지지 않았거나 이 작업에 특화된 정보만 질문하세요. 스키마를 구현하기 전에 다음을 이해하세요: 1. **페이지 유형** - 어떤 종류의 페이지인가? 주요 콘텐츠는 무엇인가? 어떤 리치 결과가 가능한가? 2. **현재 상태** - 기존 스키마가 있는가? 구현에 오류가 있는가? 이미 나타나는 리치 결과는 어떤 것인가? 3. **목표** - 어떤 리치 결과를 목표로 하는가? 비즈니스 가치는 무엇인가? --- ## 핵심 원칙 ### 1. 정확성 우선 - 스키마는 페이지 콘텐츠를 정확하게 나타내야 합니다 - 존재하지 않는 콘텐츠를 마크업하지 마세요 - 콘텐츠가 변경되면 계속 업데이트하세요 ### 2. JSON-LD 사용 - Google은 JSON-LD 형식을 권장합니다 - 구현 및 유지 관리가 더 쉽습니다 - `` 또는 `` 끝에 배치하세요 ### 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](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`를 사용하여 한 페이지에 여러 스키마 유형을 결합할 수 있습니다: ```json { "@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은 완전한 주소여야 하며, 열거형은 정확해야 합니다 **페이지 콘텐츠와 불일치** - 스키마가 보이는 콘텐츠와 일치하지 않습니다 --- ## 구현 ### 정적 사이트 - HTML 템플릿에 JSON-LD를 직접 추가하세요 - 재사용 가능한 스키마에 include/partial을 사용하세요 ### 동적 사이트 (React, Next.js) - 스키마를 렌더링하는 컴포넌트 - SEO를 위해 서버 사이드 렌더링 - 데이터를 JSON-LD로 직렬화 ### CMS / WordPress - 플러그인 (Yoast, Rank Math, Schema Pro) - 테마 수정 - 구조화된 데이터로의 사용자 정의 필드 --- ## 출력 형식 ### 스키마 구현 ```json // Full JSON-LD code block { "@context": "https://schema.org", "@type": "...", // Complete markup } ``` ### 테스트 체크리스트 - [ ] 리치 결과 테스트에서 검증됨 - [ ] 오류 또는 경고 없음 - [ ] 페이지 콘텐츠와 일치 - [ ] 모든 필수 속성이 포함됨 --- ## 작업별 질문 1. 이 페이지는 어떤 유형인가요? 2. 어떤 리치 결과를 얻고 싶으신가요? 3. 스키마를 채우는 데 사용할 수 있는 데이터는 무엇인가요? 4. 페이지에 기존 스키마가 있나요? 5. 기술 스택은 무엇인가요? ## FAQ ### 스키마 마크업이란 무엇인가요? 스키마 마크업은 검색 엔진이 콘텐츠를 이해하고 별점, FAQ, 제품과 같은 리치 결과를 활성화하도록 돕기 위해 웹 페이지에 추가하는 구조화된 데이터입니다. ### 내 사이트에 스키마 마크업을 어떻게 추가하나요? 페이지의 head에 배치한 JSON-LD 코드, CMS 플러그인 또는 JavaScript 프레임워크 컴포넌트를 사용하여 스키마 마크업을 추가할 수 있습니다. ### 블로그에 어떤 스키마 유형을 사용해야 하나요? 블로그 게시물에는 headline, image, datePublished, author 속성을 포함한 Article 또는 BlogPosting 스키마를 사용하세요. ### 스키마 마크업이 순위를 향상시킬까요? 스키마 마크업은 직접적인 순위 요소는 아니지만 리치 결과를 향상시켜 클릭률과 검색 가시성을 개선할 수 있습니다. ### 스키마를 검증할 수 있는 무료 도구가 있나요? 네, Google의 리치 결과 테스트와 Schema.org 검증기는 무료이며 마크업 테스트에 권장됩니다. ### 한 페이지에 여러 스키마 유형을 결합할 수 있나요? 물론입니다. JSON-LD에서 @graph를 사용하여 Organization 및 BreadcrumbList와 같은 유형을 결합하여 더 포괄적으로 표현할 수 있습니다.