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

# SEO Agent

> Replit의 SEO Agent로 게시된 앱에 기술적 SEO 감사를 실행하고, 크롤 가능성, 메타데이터, 구조화된 데이터에 대한 원클릭 수정을 적용하세요.

export const AiPrompt = ({children}) => {
  return <CodeBlock className="relative block font-sans whitespace-pre-wrap break-words">
      <div className="pr-7">
        {children}
      </div>
    </CodeBlock>;
};

SEO Agent는 프로젝트 전반에 걸쳐 기술적 SEO 감사를 실행하고 검색 엔진과 AI 크롤러가 앱을 얼마나 잘 찾고 이해할 수 있는지를 제한하는 문제를 표시합니다. 각 발견 사항은 Agent로 검토하고 적용할 수 있는 원클릭 수정이 됩니다.

Project Editor의 **Growth** 패널에 있으며 이미 게시한 앱에서 작동합니다. 대부분의 빌더에게 워크플로우는 앱 게시, SEO Agent 열기, 스캔 실행, 발견 사항 검토, 수정 적용입니다.

## SEO Agent가 하는 것

SEO Agent는 **기술적 SEO**에 집중합니다 — 검색 엔진과 AI 크롤러가 앱을 얼마나 쉽게 검색하고, 인덱싱하고, 이해할 수 있는지를 결정하는 구조적이고 기계 판독 가능한 부분입니다.

다음과 같은 문제에 대해 프로젝트를 검토하고 수정을 제안합니다:

* **크롤 가능성 및 인덱싱**: `robots.txt`, `sitemap.xml`, 크롤 가능한 링크 및 페이지 구조.
* **페이지 메타데이터**: 모든 페이지의 고유하고 설명적인 `<title>` 태그와 메타 설명.
* **구조화된 데이터**: 검색 엔진이 리치 결과를 표시하는 데 도움이 되는 JSON-LD 마크업.
* **Open Graph 및 소셜 태그**: 링크가 공유될 때 미리보기 방식을 제어하는 메타데이터.
* **시맨틱 마크업**: 올바른 제목 순서, 랜드마크 요소, 이미지의 설명적인 `alt` 텍스트.

<Note>
  SEO Agent는 구축한 앱이 검색에 기술적으로 건전한지 확인하며, 콘텐츠를 작성하거나 주제적 권위를 구축하지는 않습니다.
</Note>

## 시작하기 전에

SEO Agent에는 다음이 필요합니다:

* **게시된 앱.** SEO Agent는 라이브, 공개 웹 배포를 감사하므로 아직 게시하지 않았다면 먼저 앱을 게시하세요. SEO를 지원하는 배포 유형은 [SEO 등급](/references/publishing/seo-rating)을 참조하세요.
* **유료 플랜.** SEO Agent는 유료 플랜의 빌더에게 제공됩니다. 무료 플랜을 사용 중이라면 Growth 패널에서 업그레이드 옵션이 표시됩니다.

SEO Agent에 접근하는 두 가지 방법이 있습니다: Project Editor에서 직접 **Growth** 패널을 열거나, **Publishing** 도구의 SEO 등급 옆에서 **Optimize SEO with Agent**를 선택하면 스캔 준비가 된 Growth 패널이 열립니다.

## 찾는 방법

SEO Agent는 게시된 앱에서 작동합니다. 게시하기 전에는 **Growth** 패널이 잠겨 있고 **Go to Publishing**을 안내합니다.

<Frame caption="게시 전에는 Growth 패널이 Go to Publishing 안내와 함께 잠겨 있습니다">
  <img src="https://mintcdn.com/replit/H2YQXOP8FssoA8VI/images/deployments/seo-agent/01-growth-locked.png?fit=max&auto=format&n=H2YQXOP8FssoA8VI&q=85&s=7e91cef3ebd191171c305f2a98d59fc7" alt="Growth 패널에 '앱을 게시하여 Growth 도구를 잠금 해제하세요' 제목과 Go to Publishing 버튼이 있는 잠긴 상태 표시" width="1657" height="947" data-path="images/deployments/seo-agent/01-growth-locked.png" />
</Frame>

앱을 게시하면 Growth 패널의 **SEO Rating** 카드에 현재 등급과 **Run scan with Agent** 버튼이 표시됩니다.

<Frame caption="게시 후 SEO Rating 카드에 Run scan with Agent 버튼이 표시됩니다">
  <img src="https://mintcdn.com/replit/H2YQXOP8FssoA8VI/images/deployments/seo-agent/02-run-scan.png?fit=max&auto=format&n=H2YQXOP8FssoA8VI&q=85&s=16c07094556e97393d541aa59f5ecfe4" alt="Run scan with Agent 버튼이 빨간 사각형으로 강조 표시된 SEO Rating 카드의 확대 보기" width="1656" height="946" data-path="images/deployments/seo-agent/02-run-scan.png" />
</Frame>

스캔 실행, 수정 적용, 변경 사항 병합에 대한 전체 단계별 안내는 [앱의 SEO 개선하기](/build/improve-seo)를 참조하세요.

<Tip>
  소셜 플랫폼에서 앱 공유 시 미리보기 방식을 제어하려면 [커스텀 도메인](/build/add-custom-domain)을 연결하고 다시 게시하세요. 소셜 및 링크 미리보기는 앱의 공개 프로덕션 URL을 사용하므로, 게시된 커스텀 도메인이 있으면 정확한 미리보기를 볼 수 있습니다.
</Tip>

## SEO Agent와 SEO 등급

SEO Agent 옆에 표시되는 **SEO 등급**은 게시 후마다 실행되어 앱을 Healthy, Needs Work, Weak로 평가하는 자동 [Lighthouse 감사](/references/publishing/seo-rating)에서 나옵니다. 등급은 \_앱의 현재 상태\_를 알려줍니다.
SEO Agent는 문제를 스캔하고 수정을 적용하여 *개선하는 데* 도움을 줍니다. 수정 후 다시 게시하면 등급이 새로고침됩니다.

스캔 UI를 건너뛰고 Agent에게 직접 요청할 수도 있습니다:

<AiPrompt>
  SEO 모범 사례에 맞게 사이트를 감사하고 수정 사항을 적용하세요. 사이트맵, robots.txt, Open Graph 태그, 적절한 곳에 구조화된 데이터를 추가하고, 모든 페이지에 고유한 제목과 메타 설명이 있는지 확인하세요.
</AiPrompt>

## 다음 단계

<CardGroup cols={2}>
  <Card title="SEO 등급" icon="magnifying-glass-chart" href="/references/publishing/seo-rating">
    Lighthouse SEO 등급 계산 방법, 각 등급의 의미, 지원되는 배포 유형을 확인하세요.
  </Card>

  <Card title="앱의 SEO 개선하기" icon="chart-line-up" href="/build/improve-seo">
    앱의 SEO를 게시, 점수 측정, 최적화하는 단계별 가이드.
  </Card>

  <Card title="커스텀 도메인 추가하기" icon="globe" href="/build/add-custom-domain">
    정확한 소셜 미리보기와 더 강력한 검색 신호를 위해 앱을 자체 도메인으로 이전하세요.
  </Card>

  <Card title="Static Deployments" icon="file-code" href="/references/publishing/static-deployments">
    콘텐츠가 많고 SEO가 중요한 사이트에 최적의 배포 유형.
  </Card>
</CardGroup>