Communitygithub.com

astudio · 스키마 마크업

Schema.org 구조화된 데이터(JSON-LD)를 작성, 검증하고 2026년에도 유효한 리치 결과 유형을 선택합니다. 구글 리치 결과 테스트와 Yandex 마이크로데이터 검사기를 지원합니다.

astudio · 스키마 마크업란 무엇인가요?

이 스킬은 AI 에이전트가 웹사이트에 Schema.org JSON-LD 구조화된 데이터를 생성, 검증 및 유지 관리할 수 있도록 설계되었습니다. 마크업이 항상 페이지에 보이는 콘텐츠와 일치하도록 보장하며, Organization, LocalBusiness, Product + Offer + AggregateRating, Article, BreadcrumbList, VideoObject, Event, JobPosting, Course, QAPage 등 2026년에도 여전히 가치 있는 유형에 중점을 둡니다. 기존 마크업을 분석하고, 템플릿별로 적절한 유형을 추천하며, 출력을 자동으로 린트합니다. 이 스킬은 FAQPage, HowTo, 2025년 배치 등 Google 리치 결과에서 더 이상 지원되지 않거나 효과가 없는 유형을 식별하여 플래그를 지정합니다. 또한 Google Rich Results Test와 Yandex Webmaster 마이크로데이터 검사기를 지원하여 다양한 검색 엔진과의 호환성을 보장합니다. 'микроразметка', 'schema.org', 'JSON-LD', 'rich snippets', 'расширенные сниппеты', 'разметка товара', 'разметка организации'와 같은 키워드로 검색되는 프로젝트에 유용하며, astudio-ai-seo 제품군의 일부입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/whoamnesia/ai-seo/tree/HEAD/skills/schema-markup

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

astudio · 스키마 마크업은(는) 무엇을 하나요?

<root> = 이 스킬의 기본 디렉토리에서 두 단계 위. 린트: <root>/scripts/schema_lint.py. 유형 상태: <root>/reference/facts.md § 리치 결과 상태.

구조화된 데이터는 AI 답변에 필수는 아니지만(Google 확인), 사실을 명확히 명시합니다: 당신이 누구인지, 제품 가격이 얼마인지, 위치가 어디인지, 기사를 작성한 사람이 누구인지. 이는 리치 결과, 지식 패널, JSON-LD를 읽는 모든 소비자에게 도움이 됩니다. 페이지에 표시되는 내용과 일치할 때만 도움이 됩니다.

워크플로우

  1. 페이지 템플릿(홈, 카테고리, 제품, 기사, 연락처, 이벤트, 채용)을 인벤토리화합니다.
  2. 기존 마크업을 린트합니다: 템플릿별로 schema_lint.py <url>.
  3. 템플릿별 유형을 선택합니다(아래 표). 페이지당 하나의 @graph; 엔티티에 안정적인 @id 값(https://site.ru/#organization)을 부여하고 반복하지 말고 참조합니다.
  4. 페이지와 동일한 데이터 소스(CMS 필드)에서 JSON-LD를 작성합니다. 절대 수동으로 숫자를 복사하지 마십시오.
  5. 검증합니다: schema_lint.py, Google Rich Results Test, Schema Markup Validator, 러시아의 경우 Yandex Webmaster 마이크로데이터 검사기. 결과를 보고서에 붙여넣습니다.
  6. 차이점을 보여주고; 승인 후 배포합니다.

템플릿별 유형

템플릿유형페이지와 일치해야 하는 항목
홈Organization(또는 LocalBusiness 하위 유형), WebSite이름, 로고, 연락처; 공식 프로필(VK, Telegram, Яндекс Карты, 2ГИС, Wikipedia)의 sameAs
제품Product + Offer (+ AggregateRating, Review (표시된 경우))가격, 통화 RUB, 재고 여부, 평점 값 및 개수
카테고리BreadcrumbList, ItemList(선택 사항)이동 경로 텍스트
기사 / 블로그Article/BlogPosting + Person(저자)제목, 프로필 페이지가 있는 저자 이름, 날짜
연락처 / 지점주소, geo, openingHoursSpecification, telephone이 있는 LocalBusiness 하위 유형지도 및 디렉토리와 동일한 NAP
동영상 페이지VideoObject썸네일, 업로드 날짜, 길이
이벤트 / 강좌 / 채용Event, Course, JobPosting날짜, 가격, 위치, 급여
Q&A 포럼 페이지QAPage실제 사용자 질문과 답변

지원 중단되거나 효과 없는 유형(성과로 판매하지 마십시오)

FAQPage(2026-05-07 이후 Google 리치 결과 없음), HowTo(2023), ClaimReview, EstimatedSalary, Learning Video, SpecialAnnouncement, Vehicle Listing, Book Actions(2025-06-12). 보이는 콘텐츠를 반영하고 다른 곳에서 소비하는 경우에만 FAQPage/HowTo를 유지하십시오. Google SERP 효과는 없다고 말하십시오.

규칙

  • 사용자가 볼 수 있는 것만 마크업하십시오. 숨겨진 평점, 자체 조직에 대한 자기 칭찬 리뷰, 페이지와 다른 가격은 Google 정책을 위반하며 수동 조치를 초래할 수 있습니다.
  • 가격: price에 공백 없는 숫자("4990"), priceCurrency: "RUB"; HTML에도 동일한 가격을 표시하십시오.
  • 날짜: 시간대가 있는 ISO 8601 형식(2026-11-06T10:00:00+03:00).
  • 사이트당 하나의 조직 엔티티, @id로 참조.

예시: LocalBusiness

{"@context":"https://schema.org","@graph":[{"@type":"CafeOrCoffeeShop","@id":"https://zerno.ru/#org",
"name":"Кофейня «Зерно»","url":"https://zerno.ru/","logo":"https://zerno.ru/logo.svg","telephone":"+7 843 000-00-00",
"address":{"@type":"PostalAddress","streetAddress":"ул. Баумана, 1","addressLocality":"Казань","postalCode":"420111","addressCountry":"RU"},
"geo":{"@type":"GeoCoordinates","latitude":55.7887,"longitude":49.1221},
"openingHoursSpecification":[{"@type":"OpeningHoursSpecification","dayOfWeek":["Monday","Tuesday","Wednesday","Thursday","Friday","Saturday","Sunday"],"opens":"08:00","closes":"22:00"}],
"sameAs":["https://vk.com/zerno","https://yandex.ru/maps/org/000"]}]}

관련 스킬