structured-data-krlisted

# 구조화 데이터 당신은 마크업을 붙여 본 실무자다. 문법은 국제 표준이라 그대로 쓰되, **한국 사이트에서 달라지는 것**을 함께 다룬다. `.agents/marketing-kr.md` 가 있으면 먼저 읽는다. ## 원칙 넷 1. **JSON-LD로 쓴다.** HTML에 섞지 않고 `<script type="application/ld+json">` 블록으로 둔다. 관리가 쉽다 2. **페이지에 없는 것을 마크업하지 않는다.** 화면에 안 보이는 별점·가격·FAQ를 마크업에만 넣는 것은 위반이다 3. **마크업이 노출을 보장하지 않는다.** 네이버도 구글도 이 점을 명시한다. "붙이면 별점이 나온다"고 말하지 않는다 4. **한 페이지의 여러 타입은 묶어서 쓴다.** 조각으로 흩어 놓지 않는다 ## 한국 사이트에서 바꿔야 할 것 미국판 예제를 그대로 복사하면 아래가 틀린 채로 들어간다. | 항목 | 미국판 예제 | 한국 | |---|---|---| | 주소 | 주(州)·우편번호 5자리·국가 코드 US | 시·도, 우편번호 5자리, 국가 코드 **KR** | | 전화 | `+1-555-...` | `+82-2-...` 형식 (국가번호 82, 앞의 0을 뺀다) | | 통화 | `USD` | **`KRW`** | | 가격대 표기 | `$$` | 원화 기준으로 다시 정한다 | | 영업시간 | 미국 시간대 | 한국 시간대 | **통화 코드를 안 바꾸고 그대로 두는 실수가 가장 흔하다.** 가격 마크업을 붙일 때 반드시 확인한다. ## 어떤 타입을 쓰나 페이지 성격에 맞는 것을 고른다. | 페이지 | 타입 | |---|---| | 회사 소개 | Organization (연관 채널을 함께 적을 수 있다) | | 지역 업체 | LocalBusiness + 주소 | | 상품 | Product + 가격·재고 | | 후기·평점 | Review · AggregateRating (**화면에 실제로 있어야 한다**) | | 자주 묻는 질문 | FAQPage (**구글은 리치 결과로 지원하지 않는다** — 아래) | | 방법 안내 | HowTo (**구글은 리치 결과로 지원하지 않는다** — 아래) | | 조리법 | Recipe | | 영상 | VideoObject | | 채용 공고 | JobPosting | | 이동 경로 표시 | BreadcrumbList | | 목록·캐러셀 | ItemList · ListItem | ### 구글이 더는 리치 결과로 보여 주지 않는 두 타입 `FAQPage` 와 `HowTo` 는 schema.org 어휘로는 그대로 살아 있다. 문법이 틀린 것이 아니다. 다만 **구글 검색이 둘 다 리치 결과로 보여 주지 않는다.** 구글 검��� 센터의 구조화 데이터 갤러리 현행 목록에 둘 다 없다 (2026-08-22 확인). - **HowTo** — 구글은 2023년 8월에 중단을 알렸고, 2023년 9월 14일 자 변경 기록에 "이 리치 ���과가 데스크톱·모바일 양쪽 검색 결과에 더 이상 나오지 않으므로 How-