FAQ 스키마 생성기

FAQ 스키마를 만드는 방법

각 쌍은 한 번만 씁니다. 같은 목록에서 두 결과물을 함께 만들어 내기 때문에, 마크업과 화면의 FAQ가 서로 다른 말을 할 수 없습니다.

1. 질문과 답변을 입력합니다. 한 쌍당 한 줄입니다. 질문은 검색창에 실제로 입력되는 말로 쓰고, 답변은 첫 문장만으로 답이 끝나도록 씁니다.
2. 경고를 읽습니다. 빈 줄은 건너뛰고, 질문만 있거나 답변만 있는 줄은 오류로 표시됩니다. 중복된 질문과 지나치게 긴 답변에는 경고가 붙습니다.
3. JSON-LD를 붙여넣습니다. 스크립트 블록을 페이지에 복사합니다. head든 body든 상관없으며, 한 페이지에 FAQPage는 하나만 둡니다.
4. 표시용 HTML을 붙여넣습니다. details/summary 블록을 방문자가 FAQ를 읽을 자리에 복사합니다. JSON-LD가 선언한 것과 똑같은 문장이 들어 있습니다. 나중에 한쪽을 고치면 둘 다 다시 만드세요.

마크업이 화면의 글자와 똑같아야 하는 이유

FAQ 스키마는 페이지에 실제로 표시되는 질문과 답변을 나열한 FAQPage 유형의 구조화된 데이터, 즉 JSON-LD 블록입니다. 검색엔진과 AI 답변 엔진이 화면 배치에서 추측하는 대신 데이터로 읽을 수 있게 해 줍니다. 핵심은 "실제로 표시되는"입니다. 구글의 구조화된 데이터 가이드라인은 마크업한 내용이 읽는 사람에게 보여야 하고, 마크업이 말하는 것과 같아야 한다고 요구합니다. 방문자가 볼 수 없는 질문을 JSON-LD가 나열하거나 화면과 다른 답변을 선언한 페이지는 이 가이드라인을 어기는 것이며, 수동 조치로 구조화된 데이터 적용 자격을 잃을 수 있습니다.

대부분의 생성기는 JSON-LD까지만 만들어 주고 보이는 쪽은 사용자에게 맡깁니다. 어긋남은 거기서 시작됩니다. 본문은 관리자 화면에서 수정되는데 스크립트 블록은 그대로 남고, 반년 뒤에는 존재하지 않는 페이지를 마크업이 설명하고 있습니다. 이 생성기는 표시용 HTML과 JSON-LD를 같은 목록에서 한 번에 써냅니다. <summary>의 문장이 곧 name이고, <p>의 문장이 곧 acceptedAnswer.text이며, 글자 하나까지 같습니다. 한쪽을 고칠 때마다 둘 다 다시 만들면 두 쪽이 어긋날 수가 없습니다.

이건 규정 준수만의 문제가 아닙니다. AI 답변 엔진이 인용하는 것은 화면에 보이는 문장이고, 그 인용을 보고 들어온 사람은 페이지에서 같은 문장을 찾을 것이라 기대합니다. 두 면을 한 원고에서 만드는 것은 그 기대를 지키는 방법입니다.

지금 FAQ 스키마로 할 수 있는 일, 솔직하게

2023년 8월 구글은 검색결과의 FAQ 리치 결과를 널리 알려진 권위 있는 정부·보건 기관 사이트로 제한했습니다. 나머지 사이트에서는 검색결과 아래 펼쳐지던 질문·답변 스니펫이 더 이상 나오지 않습니다. 아직도 그것을 약속하는 도구는 2022년 이야기를 하고 있는 셈입니다. 그렇다면 FAQ를 왜 마크업할까요?

• 화면에 보이는 FAQ 자체가 순위를 가져옵니다. 검색되는 말로 쓴 질문에 한 문장으로 끝나는 답변이 붙어 있으면, 그 구간만으로 순위가 잡히고 AI 엔진에 인용됩니다. 마크업은 그 구간을 기계가 읽을 수 있게 복사해 둔 것이지, 순위가 붙는 이유가 아닙니다.
• 구조화된 데이터는 지금도 읽힙니다. 구글은 리치 결과를 보여 주지 않는 자리에서도 FAQPage 마크업을 파싱하고, 빙과 답변 엔진, 그리고 직접 만든 에이전트에게는 깔끔한 추출 경로가 됩니다.
• 이 글쓰기 규율이 다른 곳에서 값을 합니다. 질문을 검색어처럼 쓰고 답변을 홀로 성립하는 문장으로 쓰는 것은, JSON-LD가 있든 없든 AI 답변에 인용되는 페이지의 조건 그 자체입니다.

기대하면 안 되는 것은 마크업 자체로 인한 순위 상승과, 상업 사이트에서의 리치 결과 노출입니다. 페이지에 진짜 FAQ가 있고 그 두 면을 일치시키고 싶어서 쓰는 것이 지금의 올바른 이유입니다.

인용되는 질문과 답변 쓰는 법

• 영어 질문을 그대로 옮기지 마세요. 한국어 검색창에 실제로 입력되는 것은 "배송 얼마나", "환불 방법" 같은 말입니다. 의도는 거기서 가져오되, 제목에는 "배송은 얼마나 걸리나요?"처럼 자연스러운 한 문장의 의문형을 씁니다. 검색되는 것은 단어지만 인용되는 것은 문장이기 때문입니다.
• 첫 문장에서 답을 끝내세요. 추출하는 쪽이 가져가는 것은 첫 문장이고, 나머지는 보충으로 읽힙니다.
• 문장마다 홀로 성립해야 합니다. "이것", "위에서 말한 대로"처럼 앞뒤가 있어야 뜻이 통하는 표현은 피하세요. 인용된 문장은 이웃 문장을 잃습니다.
• 한 쌍에 한 가지만. 답이 셋 필요한 질문은 사실 질문이 셋입니다.
• 형용사보다 사실을. 출처가 붙은 숫자는 인용되고, "업계 최고"는 인용되지 않습니다.
• 실제로 받는 질문만. FAQ는 홍보 문구를 물음표 뒤에 숨기는 자리가 아닙니다.
• 문체를 통일하세요. 답변마다 합니다체와 해요체가 섞이면, 인용된 한 문장이 사이트 안에서 혼자 튀어 보입니다.

코드를 넣는 자리

JSON-LD는 페이지 안 어디에 있어도 됩니다. <script type="application/ld+json"> 안에 넣으면 head든 body든 구글이 읽습니다. FAQPage는 한 페이지에 한 블록만 두고, 같은 질문을 여러 페이지에 반복하지 마세요. 마크업은 그것이 놓인 페이지를 설명하는 것입니다. 표시용 블록은 FAQ를 읽힐 자리에 넣습니다. <details>/<summary>는 JavaScript 한 줄 없이 펼치고 접히며, 크롤러에게는 HTML 안에 그대로 보입니다. 테마나 페이지의 HTML을 직접 편집할 수 있는 빌더라면 어디에서든 같은 방식으로 넣을 수 있습니다.

넣은 뒤에는 구글 리치 결과 테스트나 schema.org 검사기로 확인하세요. 블록이 FAQPage로 인식되는지, 어떤 질문을 읽어 갔는지 알려 줍니다. 리치 결과 미리보기가 나오지 않는다고 마크업이 잘못된 것은 아닙니다. 2023년 이후 그 미리보기는 아직 노출 대상으로 남아 있는 사이트에만 제공되기 때문입니다. 공개한 뒤에는 Search Console의 개선사항 보고서에서 실제로 검출된 FAQPage 수와 오류를 계속 확인할 수 있습니다.

그리고 FAQPage는 사이트가 스스로 묻고 스스로 답하는 질문을 위한 유형입니다. 방문자가 질문을 올리고 다른 사람이 답하는 페이지 — 게시판 스레드나 지원 커뮤니티 — 는 QAPage라는 다른 유형을 씁니다. JSON-LD가 설명하는 것은 이 페이지에 있는 내용뿐입니다. 언어별 버전 선언은 hreflang 태그 생성기가, 에이전트가 읽는 색인은 llms.txt 검사기가 맡습니다. 둘 다 이 페이지와 같은 규칙 — 원고는 하나, 결과물은 둘, 어긋남은 없음 — 으로 만들었습니다.

$ npm i -g @clize/clize && clize install
$ clize seo check --domain yourdomain.co.kr