Skip to main content
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.
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.

​
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 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.
The Growth pane showing the locked state with the heading Publish your app to unlock Growth tools and a Go to Publishing button
Once your app is published, the SEO Rating card in the Growth pane shows your current rating and a Run scan with Agent button.
A zoomed-in view of the SEO Rating card with a red rectangle highlighting the Run scan with Agent button
For the full step-by-step walkthrough — running a scan, applying fixes, and merging the changes — see Improve your app’s SEO.
To control how your app previews when shared on social platforms, connect a custom domain and republish. Social and link previews use your app’s public production URL, so a published custom domain gives you accurate previews.

​
SEO Agent and your SEO Rating

The SEO Rating shown next to SEO Agent comes from an automatic Lighthouse audit 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:

​
Next steps

SEO Rating

See how the Lighthouse SEO rating is calculated, what each rating means, and which deployment types support it.

Improve your app's SEO

A step-by-step guide to publishing, scoring, and optimizing your app’s SEO.

Add a custom domain

Move your app to your own domain for accurate social previews and stronger search signals.

Static Deployments

The best deployment type for content-heavy, SEO-critical sites.