> ## 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

> Run a technical SEO audit on your published app with Replit's SEO Agent, then apply one-click fixes for crawlability, metadata, and structured data.

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 runs a technical SEO audit across your project and surfaces the issues that limit how well search engines and AI crawlers can find and understand your app. Each finding becomes a one-click fix you can review and apply with Agent.

It lives in the **Growth** pane in the Project Editor and works on apps you have already published. For most builders, the workflow is: publish your app, open SEO Agent, run a scan, review the findings, and apply the fixes.

## What SEO Agent does

SEO Agent focuses on **technical SEO**, the structural and machine-readable parts of your app that determine how easily search engines and AI crawlers can discover, index, and understand it.

It reviews your project and proposes fixes for issues such as:

* **Crawlability and indexing**: `robots.txt`, `sitemap.xml`, and a crawlable link and page structure.
* **Page metadata**: unique, descriptive `<title>` tags and meta descriptions on every page.
* **Structured data**: JSON-LD markup that helps search engines show rich results.
* **Open Graph and social tags**: the metadata that controls how your links preview when shared.
* **Semantic markup**: proper heading order, landmark elements, and descriptive `alt` text on images.

<Note>
  SEO Agent makes sure the app you have built is technically sound for search,
  and does not write content or build topical authority for you.
</Note>

## Before you start

SEO Agent requires:

* **A published app.** SEO Agent audits a live, public web deployment, so publish your app first if you haven't yet. See [SEO Rating](/references/publishing/seo-rating) for the deployment types that support SEO.
* **A paid plan.** SEO Agent is available to builders on a paid plan. If you're on the free plan, you'll see an upgrade option in the Growth pane.

There are two ways to reach SEO Agent: open the **Growth** pane in the Project Editor directly, or select **Optimize SEO with Agent** next to your SEO Rating in the **Publishing** tool, which opens the Growth pane ready to scan.

## Where to find it

SEO Agent works on a published app. Until you publish, the **Growth** pane is locked and prompts you to **Go to Publishing**.

<Frame caption="Before you publish, the Growth pane is locked with a Go to Publishing prompt">
  <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="The Growth pane showing the locked state with the heading Publish your app to unlock Growth tools and a Go to Publishing button" width="1657" height="947" data-path="images/deployments/seo-agent/01-growth-locked.png" />
</Frame>

Once your app is published, the **SEO Rating** card in the Growth pane shows your current rating and a **Run scan with Agent** button.

<Frame caption="After publishing, the SEO Rating card shows a Run scan with Agent button">
  <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="A zoomed-in view of the SEO Rating card with a red rectangle highlighting the Run scan with Agent button" width="1656" height="946" data-path="images/deployments/seo-agent/02-run-scan.png" />
</Frame>

For the full step-by-step walkthrough — running a scan, applying fixes, and merging the changes — see [Improve your app's SEO](/build/improve-seo).

<Tip>
  To control how your app previews when shared on social platforms, connect a
  [custom domain](/build/add-custom-domain) and republish. Social and link
  previews use your app's public production URL, so a published custom domain
  gives you accurate previews.
</Tip>

## SEO Agent and your SEO Rating

The **SEO Rating** shown next to SEO Agent comes from an automatic [Lighthouse audit](/references/publishing/seo-rating) that runs after every publish and rates your app as Healthy, Needs Work, or Weak. The rating tells you *where your app stands*.
SEO Agent helps you *improve it* by scanning for issues and applying fixes. Republishing after a fix refreshes the rating.

You can also skip the scan UI entirely and just ask Agent directly:

<AiPrompt>
  Audit my site for SEO best practices and apply the fixes. Add a sitemap,
  robots.txt, Open Graph tags, structured data where it makes sense, and make
  sure every page has a unique title and meta description.
</AiPrompt>

## Next steps

<CardGroup cols={2}>
  <Card title="SEO Rating" icon="magnifying-glass-chart" href="/references/publishing/seo-rating">
    See how the Lighthouse SEO rating is calculated, what each rating means, and
    which deployment types support it.
  </Card>

  <Card title="Improve your app's SEO" icon="chart-line-up" href="/build/improve-seo">
    A step-by-step guide to publishing, scoring, and optimizing your app's SEO.
  </Card>

  <Card title="Add a custom domain" icon="globe" href="/build/add-custom-domain">
    Move your app to your own domain for accurate social previews and stronger
    search signals.
  </Card>

  <Card title="Static Deployments" icon="file-code" href="/references/publishing/static-deployments">
    The best deployment type for content-heavy, SEO-critical sites.
  </Card>
</CardGroup>