schemaWorks 사용 가이드

병원 홈페이지의 SEO·GEO 노출을 30초에 진단하고, 클라이언트(원장님·마케터)에게 자기 브랜드로 리포트를 전달하는 전체 흐름을 설명합니다.

1. schemaWorks가 하는 일

전통적인 SEO는 Google 검색 결과 10개 링크에서 순위를 높이는 것이었습니다. 하지만 이제 환자들은 AI에게 직접 질문합니다.

"강남에서 토요일 진료 가능한 정형외과 어디야?"
"비염 잘 보는 한의원 추천해줘"
"임플란트 잘하는 치과 비교해줘"

이 질문에 ChatGPT·Gemini·Perplexity 같은 AI가 우리 병원을 언급하는지 안 하는지가 신환 매출에 직결됩니다. schemaWorks는 병원 홈페이지가 검색·AI 노출에 적합하게 설정돼 있는지 14개 항목으로 자동 점검하고 리포트로 만들어 줍니다.

점검 항목 (총 14개, 100점 만점)

카테고리	검사 내용
구조화 데이터 (Schema.org)	MedicalClinic, Physician, FAQPage 등 병원 특화 JSON-LD 유무·품질
메타태그	description 고유성 / 중복, canonical, Open Graph, Twitter Card
사이트맵	sitemap.xml 존재, lastmod 신선도
robots.txt	sitemap 선언, GPTBot·ClaudeBot·PerplexityBot 등 AI 크롤러 허용
AI 검색 대응 (GEO)	llms.txt 존재 여부
기술 스택	UA/GA4 사용, jQuery 버전

2. 빠른 시작 (3단계)

Step 1. Google 로그인

schemaworks.thevuemedia.com 우측 상단 「Google 로 로그인」 클릭. 가입은 1초, 신용카드 불필요.

Step 2. 새 진단 시작

대시보드 우측의 「+ 새 진단」 클릭 후 입력합니다.

병원명 — 예: "서울건우정형외과"
홈페이지 URL — 예: https://example.com (서버 로그인·API 키는 요구하지 않음)
업종 — 양방·한의원·치과·한방병원·기타 중 선택
「진단 시작」 클릭

TIP — 한의원으로 선택하면 한의사·한의학 전용 스키마 체크가 추가로 실행됩니다.

Step 3. 결과 확인

진단은 평균 12~15초 소요됩니다. 진행 화면에서 5단계(사이트 정보 수집 → 메타태그 점검 → JSON-LD 분석 → robots/sitemap 검증 → 점수 계산)를 실시간으로 확인할 수 있고, 완료되면 자동으로 리포트 페이지로 이동합니다.

3. 리포트 보는 법

종합 점수 카드

큰 숫자 = 100점 만점 환산 백분율. 색상은 점수대를 의미합니다.

등급	점수	의미
A (우수)	90~100	검색·AI 노출 준비 완료
B (양호)	75~89	미세 보완으로 충분
C (보통)	60~74	핵심 항목 손볼 시점
D (주의)	40~59	다수 항목 누락
F (심각)	0~39	검색·AI 노출 자체가 어려움

발견된 문제

심각도별로 그룹핑됩니다.

🔴 치명적 — 검색/AI 노출 직결. 가장 먼저 처리.
🟠 높음 — 수 주 내 보완 권장.
🟡 중간 — 분기별 정비 시 함께.
⚪ 낮음 — 여유 있을 때.

각 카드를 클릭하면 상세한 처방이 펼쳐집니다.

4. 리포트 다운로드 / 공유

리포트 페이지 상단에서 다음 형식으로 받을 수 있습니다.

형식	용도
`.pdf`	클라이언트 미팅·이메일 첨부에 가장 적합
`.html`	사내 위키·내부 공유. 링크/표 그대로
`.md`	Notion·GitHub·블로그 본문 옮길 때

공유 링크

공유 카드의 「공유하기」 버튼은 모바일에서 카카오톡 공유 시트를 열고, 데스크톱에서는 X(트위터)·Facebook·링크 복사를 제공합니다. 공유 URL은 schemaworks.thevuemedia.com/share/{토큰} 형식으로 누구나 로그인 없이 볼 수 있습니다.

5. 화이트라벨 (대행사·마케터용)

자신의 회사명/로고로 schemaWorks 카드를 교체해 클라이언트에게 자기 브랜드로 전달할 수 있습니다.

설정 방법

우측 상단 「설정」 → 화이트라벨 카드
회사명 입력 (필수, 80자 이하)
웹사이트 URL (선택)
로고 업로드 — PNG/JPEG/WebP, 최대 500KB
「저장」

적용 결과

.md .html .pdf 파일의 schemaWorks 홍보 카드가 회사 카드로 교체
PDF 페이지 푸터의 "schemaworks.thevuemedia.com"이 회사명으로 교체
공유 페이지(/share/...) 헤더가 회사명 + 로고
공유 페이지의 "우리 병원도 무료 진단" CTA 자동 숨김

TIP — schemaWorks 흔적을 모두 제거하므로 클라이언트는 schemaWorks의 존재를 모릅니다.

비활성하려면 같은 화면의 **「화이트라벨 비활성」**을 누르면 됩니다.

6. 일일 진단 한도와 BYOK

운영 비용 관리를 위해 일반 사용자는 하루 진단 횟수에 제한이 있습니다.

사용자 유형	일일 한도
일반 사용자	기본 3건 (관리자가 사용자별로 조정 가능)
동일 IP 글로벌 cap	3건 (계정 우회 방어)
BYOK 등록자	무제한
운영자	무제한

BYOK = Bring Your Own Key

본인의 Anthropic Claude API 키를 등록하면 일일/IP 한도를 모두 우회합니다. 사용 비용은 본인 Anthropic 콘솔에서 직접 청구됩니다.

등록 방법

console.anthropic.com → Settings → API Keys 접속
「Create Key」 클릭, 이름 입력 (예: schemaworks)
생성된 sk-ant-… 키 복사
schemaWorks 설정 → Claude API 키 카드에 붙여넣고 「키 등록 및 검증」

검증은 Anthropic API에 ping을 보내 valid한지 즉시 확인합니다. 잘못된 키는 저장되지 않습니다.

TIP — 키 등록 즉시 네브바 크레딧 표시가 "BYOK 무제한"으로 바뀝니다. 삭제하면 다시 일일 한도가 적용됩니다.

한도 소진 시

하루 한도를 모두 쓰면 진단 시도 시 모달이 열려 BYOK 등록 단계 안내를 보여줍니다. 다음 날 KST 자정 이후 자동 복구됩니다.

7. 자주 묻는 질문

Q. 진단 결과는 얼마나 정확한가요?

공개 URL을 크롤링한 결정적(deterministic) 검사입니다. 점수와 발견 항목은 매번 동일하게 재현됩니다. 단 페이지가 최초 6개까지(홈 + sitemap 시드 5개)만 검사되므로 사이트 구조에 따라 일부 페이지는 평가 대상에 포함되지 않을 수 있습니다.

Q. 한 사이트를 여러 번 진단하면 안 되나요?

가능합니다. 일일 한도 안에서 자유롭게 재진단할 수 있고, 대시보드에서 가장 최근 결과만 카드에 노출됩니다.

Q. 동일 IP 한도가 너무 빡빡합니다.

공용 네트워크(병원·카페·회사)에서 한도가 빨리 소진될 수 있습니다. 본인 BYOK 키를 등록하면 IP 한도까지 우회됩니다.

Q. 진단이 실패합니다.

사이트가 JavaScript로만 콘텐츠를 그리는 SPA인 경우 일부 항목이 감지되지 않을 수 있습니다.
robots.txt에서 외부 크롤러를 차단하고 있다면 가져오지 못합니다.
HTTPS 인증서 오류·서버 응답 지연(>8초) 시 fetch가 실패합니다.

문제가 반복되면 본 사용 가이드 하단 메일 주소로 문의 주세요.

Q. 데이터는 어디에 저장되나요?

Cloudflare Tunnel 뒤의 자체 서버에 저장됩니다. 외부 클라우드(AWS/GCP/Vercel)에 진단 데이터를 보내지 않습니다. 화이트라벨 로고는 base64로 DB에만 저장되어 외부 CDN을 거치지 않습니다.

문의: [email protected]