음성 검색 / GEO / AEO
Speakable 스키마 검증기
speakable JSON-LD(또는 전체 페이지)를 붙여넣으면 SpeakableSpecification 구조, cssSelector 구문 및 일치 여부, 숨겨지거나 비어 있는 선택 영역, 지나치게 넓은 선택자, 자연스럽게 읽히는 요약을 위한 적절한 단어 수까지 실제 사양에 따라 검사합니다. 페이지에 아직 speakable이 없다면 시작용 선택자도 제안합니다.
모든 처리는 브라우저 안에서만 이루어집니다. 여기에 붙여넣은 내용은 익명화된 사용 횟수 외에는 어디로도 전송되지 않습니다.
<script type="application/ld+json"> 블록의 내용, 또는 전체 HTML 페이지를 붙여넣으세요 — 모든 "speakable" 속성이 자동으로 검색됩니다. JSON-LD만이 아니라 전체 페이지를 붙여넣으면 각 선택자가 실제 콘텐츠와 일치하는지, 숨겨져 있는지, 몇 단어가 읽히게 될지도 함께 확인할 수 있습니다.
이 도구가 검사하는 항목과 흔한 실수 수정 방법
"speakable" SpeakableSpecification은 음성 비서와 답변 엔진에게 페이지의 어느 부분을 소리 내어 읽어야 하는지 정확히 알려줍니다 — 보통 전체 기사가 아니라 제목과 짧은 리드 문단 하나입니다. 이 도구는 크롤러와 동일한 방식으로 JSON-LD 그래프를 탐색하여 어디에 있든 모든 "speakable" 속성을 찾아내고 그 구조를 검증합니다. 이는 반드시 비어 있지 않은 "cssSelector" 또는 "xpath" 항목을 하나 이상 가진 객체(또는 객체 목록)여야 합니다.
Google의 현재 구현은 "cssSelector"만 읽습니다 — "xpath"는 schema.org 사양상 유효하지만 Google에서는 지원되지 않으므로, 이 도구는 xpath만 있는 사양을 치명적 오류가 아닌 호환성 경고로 표시합니다. 다른 소비자를 위해 이미 제공 중인 xpath와 함께 최소한 하나의 동등한 cssSelector를 유지하세요.
JSON-LD만이 아니라 전체 페이지를 붙여넣으면 모든 선택자가 실제 DOM을 기준으로 실행됩니다. 아무것도 일치하지 않는 선택자는 오류입니다(읽을 내용이 없기 때문). 일치한 요소가 인라인 스타일, 스타일시트 규칙, "aria-hidden", 또는 "hidden" 속성으로 숨겨져 있는 경우에도 오류이며, 여러 요소와 일치하는 ID 선택자는 대개 마크업에 중복된 id가 있다는 뜻입니다.
자연스럽게 들리는 결과를 위해서는 단어 수도 중요합니다: 매우 짧은 선택 영역(5단어 미만)은 내용이 부실하다고 표시되고, 매우 긴 선택 영역(70단어 초과, 또는 페이지 전체 텍스트의 대부분)도 표시됩니다. 사실상 기사 전체인 "요약"은 요약의 목적을 잃고 소리 내어 읽었을 때 부자연스럽게 들릴 수 있기 때문입니다 — 진짜로 짧고 그 자체로 완결된 요약을 선택하세요.
speakable 마크업이 전혀 없고 전체 페이지 HTML을 붙여넣은 경우, 이 도구는 페이지 자체의 제목과 가장 짧은 리드 문단을 기반으로 시작용 선택자를 제안하며, 바로 편집 가능한 JSON-LD 스니펫도 함께 제공합니다. 안정적인 "id" 속성으로 만들어진 선택자는 더 신뢰할 수 있는 선택으로 표시됩니다 — 도구가 태그 위치를 추측하는 데 의존하기보다는, 리디자인 후 조용히 깨질 수 있으므로 제목과 요약 요소에 id를 추가하는 것이 좋습니다.