> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anymorph.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 사이트 진단

> AI 엔진의 접근, 신뢰, 인용에 영향을 주는 사이트 이슈를 진단하고 개선합니다

사이트 진단은 우리 사이트가 AI 엔진에 제대로 읽히는지 점검하는 화면입니다. 콘텐츠를 아무리 잘 써도 AI가 페이지에 접근하지 못하거나 핵심 정보를 추출하지 못하면 인용되지 않습니다.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/opactor/images/dashboard/site-audit-overview.png" alt="사이트 진단 결과" />
</Frame>

## 진단 실행

**진단 실행**을 누르면 세 단계로 진행됩니다.

| 단계       | 하는 일                        |
| -------- | --------------------------- |
| 페이지 발견 중 | 사이트맵과 내부 링크를 크롤링해 페이지를 찾습니다 |
| 페이지 측정 중 | 페이지별로 기술 검사를 실행합니다          |
| 이슈 분석 중  | 발견한 이슈를 실행 가능한 추천으로 묶습니다    |

<Note>
  큰 사이트는 몇 분이 걸립니다. 창을 닫아도 진행되며 나중에 다시 들어와 결과를 확인할 수 있습니다.
</Note>

<Note>
  사이트가 크면 전체 URL이 아니라 **대표 샘플**을 측정합니다. 결과 화면에 샘플 여부가 표시됩니다.
</Note>

## GEO 준비도

진단 결과를 하나의 점수로 요약한 것이 GEO 준비도입니다. 다섯 영역으로 나뉩니다.

| 영역      | 묻는 질문                      |
| ------- | -------------------------- |
| 접근성     | AI와 검색 크롤러가 페이지에 도달할 수 있는가 |
| 발견성     | 중요한 페이지를 찾을 경로가 있는가        |
| 기술 상태   | 페이지가 깨지지 않고 정상 동작하는가       |
| 구조화 데이터 | 페이지 정보를 기계가 읽을 수 있는가       |
| 측정      | 개선 결과를 반복 확인할 체계가 있는가      |

각 항목은 **준비됨 / 주의 필요 / 차단됨** 중 하나로 표시됩니다.

<Warning>
  접근성이 차단됨이면 다른 영역을 개선해도 효과가 없습니다. 접근성부터 해결하세요.
</Warning>

### 요약 3줄

준비도 아래에 이번 실행의 결론이 세 줄로 나옵니다.

| 항목        | 내용           |
| --------- | ------------ |
| 잘 동작하는 항목 | 상태가 양호한 영역   |
| 가장 큰 병목   | 가장 점수가 낮은 영역 |
| 먼저 할 일    | 지금 착수할 단일 작업 |

이전 실행이 있으면 **해결 / 신규 / 회귀** 건수도 함께 표시됩니다. 회귀는 전에 고쳤던 항목이 다시 발생한 것이므로 원인을 확인해야 합니다.

## 개선 추천

이슈는 두 종류로 나뉩니다.

| 구분        | 성격                          | 특징                  |
| --------- | --------------------------- | ------------------- |
| 사이트 전역 개선 | 테마나 사이트 설정에서 한 번만 바꾸면 되는 수정 | 효율이 가장 높음           |
| 페이지별 개선   | 페이지 단위 작업                   | 영향받는 페이지가 많은 순으로 정렬 |

<Tip>
  사이트 전역 개선을 먼저 처리하세요. 한 번의 변경으로 전체 페이지가 개선되는 경우가 많습니다.
</Tip>

각 추천에는 세 가지 배지가 붙습니다.

| 배지  | 값                  | 용도      |
| --- | ------------------ | ------- |
| 영향  | 높음 / 중간 / 낮음       | 우선순위 판단 |
| 난이도 | 높음 / 중간 / 낮음       | 일정 산정   |
| 담당  | 개발 / 콘텐츠 / 분석 / 복합 | 배분      |

**영향이 높고 난이도가 낮은 항목부터** 처리하는 것이 기본 순서입니다.

### 주요 추천 유형

| 추천                      | 문제                             | 조치                           |
| ----------------------- | ------------------------------ | ---------------------------- |
| 중요 페이지에 접근 가능하게 만들기     | 오류 반환, noindex, 접근 제어로 크롤링이 막힘 | 의도치 않은 차단 규칙 제거              |
| JavaScript 전 핵심 정보 노출   | 렌더링 후에만 정보가 보임                 | 핵심 사실을 서버 렌더링하거나 초기 HTML에 포함 |
| 누락된 사실 추가               | 답변에 쓸 구체적 정보가 부족               | 가격, 재고, 작성자, 날짜, 서비스 지역 등 추가 |
| 페이지 정보를 기계가 읽을 수 있게 만들기 | 구조화 데이터 없음 또는 콘텐츠와 불일치         | 보이는 내용과 일치하는 JSON-LD 추가      |
| 페이지 제목과 요약 명확히 하기       | 제목, 설명, 헤딩이 중복되거나 비어 있음        | 페이지별 고유 목적이 드러나게 수정          |
| 중복 또는 경쟁 페이지 통합         | 여러 URL이 같은 역할을 두고 경쟁           | 대표 URL 선정, canonical 정리      |
| AI/검색이 우선순위 페이지를 찾게 하기  | 사이트맵이나 내부 링크에서 누락              | 사이트맵 등록, 내부 링크 연결            |
| 깨진 페이지 경험 문제 수정         | 깨진 리소스, 느린 렌더링, 보안 이슈          | 해당 기술 이슈 수정                  |
| 검증 설정                   | 개선 효과를 확인할 체계 부재               | 진단 재실행 주기 설정                 |

## 추천 상세

추천을 클릭하면 상세 화면이 열립니다.

| 섹션       | 내용                            |
| -------- | ----------------------------- |
| 검사 방식    | 어떻게 판정했는지                     |
| 왜 중요한가   | AI 인용에 미치는 영향                 |
| 주요 액션    | 실제로 해야 할 작업                   |
| 검증 방법    | 수정 후 확인하는 법                   |
| 영향받는 페이지 | 해당 페이지 목록. 이슈별 또는 페이지별로 전환 가능 |
| 근거       | 확인한 신호와 샘플 URL                |

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/opactor/images/dashboard/site-audit-finding.png" alt="추천 상세" />
</Frame>

페이지 목록은 **CSV 내보내기**로 받아 개발팀에 전달할 수 있습니다.

## 추천 근거

**추천 근거**를 열면 준비도 점수의 산출 근거인 개별 검사 결과를 볼 수 있습니다. 통과 / 주의 필요 / 미확인으로 분류됩니다.

판단은 규칙 기반 또는 모델 기반으로 생성되며, 어느 방식인지 화면에 표시됩니다.

## 개선 루프

<Steps>
  <Step title="진단 실행">
    현재 상태의 기준선을 만듭니다.
  </Step>

  <Step title="사이트 전역 개선 먼저">
    영향이 높고 난이도가 낮은 항목부터 처리합니다.
  </Step>

  <Step title="페이지별 개선">
    영향받는 페이지 수가 많은 순으로 진행합니다. CSV로 목록을 넘기면 편합니다.
  </Step>

  <Step title="진단 다시 실행">
    해결 / 신규 / 회귀 건수로 실제 개선 여부를 확인합니다.
  </Step>

  <Step title="가시성으로 검증">
    사이트 진단은 기술 상태만 확인합니다. 실제 성과는 [AI 가시성](/ko/dashboard/visibility)에서 별도로 확인합니다.
  </Step>
</Steps>

<Warning>
  사이트 진단 점수가 올라도 AI 언급률이 즉시 오르지는 않습니다. 진단은 인용될 수 있는 조건을 만드는 작업이고, 실제 인용은 콘텐츠와 출처가 함께 필요합니다.
</Warning>

## 문제 해결

<AccordionGroup>
  <Accordion title="진단이 실패했습니다">
    진단 다시 실행을 눌러 재시도하세요. 반복 실패하면 사이트가 크롤러를 차단하고 있을 수 있습니다. robots.txt와 방화벽 설정을 확인하세요.
  </Accordion>

  <Accordion title="발견된 페이지 수가 실제보다 적습니다">
    사이트맵에 없고 내부 링크로도 도달하지 못하는 페이지는 발견되지 않습니다. 이것 자체가 발견성 이슈입니다.
  </Accordion>

  <Accordion title="페이지 목록에 일부만 나옵니다">
    큰 사이트는 대표 샘플만 측정합니다. 목록 상단에 샘플 안내가 표시됩니다.
  </Accordion>

  <Accordion title="고쳤는데 회귀로 표시됩니다">
    배포 이후 다시 발생했거나, 수정이 일부 페이지에만 적용된 경우입니다. 영향받는 페이지 목록에서 어떤 URL이 남아 있는지 확인하세요.
  </Accordion>

  <Accordion title="사이드바에 없는 예전 화면이 열립니다">
    이전 버전 화면일 수 있습니다. 사이드바의 사이트 진단으로 접근하세요.
  </Accordion>
</AccordionGroup>

## 관련 문서

<CardGroup cols={2}>
  <Card title="온사이트" icon="file-lines" href="/ko/dashboard/on-site">
    진단으로 조건을 갖춘 뒤 콘텐츠를 만듭니다.
  </Card>

  <Card title="AI 가시성" icon="eye" href="/ko/dashboard/visibility">
    개선의 실제 효과를 확인합니다.
  </Card>

  <Card title="인용" icon="link" href="/ko/dashboard/citation">
    우리 페이지가 근거로 채택되는지 봅니다.
  </Card>

  <Card title="도메인" icon="globe" href="/ko/settings/domain">
    도메인 연결과 서빙 설정을 확인합니다.
  </Card>
</CardGroup>