SEO Agent

The SEO Agent checks the pages of your website for common SEO problems and fixes the ones it safely can, using one small script you add to your site. It is part of Pro and lives in the sidebar under Site Optimizers → SEO Agent.

Why it helps

• Search engines and AI assistants read details that visitors rarely see: the page title, the search description, and structured data (a short, machine-readable summary of what a page is about). The SEO Agent finds pages where these are missing, unclear or broken.
• You get a plain list of what needs work on each page, with the reason for every suggestion.
• Many fixes apply with one click, or automatically if you allow it, without opening your website editor.
• Every change is checked on your live page, and you can undo any of them at any time.

SEO Agent or Existing Content?

Both sit under Site Optimizers, but they do different jobs.

To refresh old articles, see Existing Content.

Before you start

• The brand must use Pro. In Simple, the SEO Agent is not available (see Common questions).
• Your website address in Brand must be the exact public address of your homepage, including www if your site uses it.
• It must be your own website. If your Brand uses a social media or marketplace profile instead, the SEO Agent and Existing content explain that they need your own website and don't start.
• You need access to your website's settings so you can add code to every page. The install guides below walk you through it.
• Later scans and applied fixes use credits. Your first audit is included.

Set it up

1. In the sidebar, open Site Optimizers → SEO Agent.
2. Click Connect your website. outwrite.ai creates a script that is unique to your website and shows it.
3. Click Copy script.
4. Add the script to every page of your site with the guide for your platform: WordPress, WordPress.com, Shopify, Webflow, Ghost, Wix, Framer or any other website.
5. Publish your website.
6. Back in outwrite.ai, click Check installation. Simply opening a page of your published website also starts this check.
7. When the badge next to Script settings says Installation verified, your first audit starts on its own. It uses 0 credits, and you can leave the page while it runs.

What it checks

The audit reads each page the way a search engine first receives it. It finds pages through your sitemap and the links between your pages. Some checks only report a problem. Others come with a fix outwrite.ai can apply for you. In the app, the list on the left groups suggestions by type, such as Page titles, Descriptions and Structured data.

On sites built with frameworks such as React, Vue or Angular, including Framer and Wix sites, heading changes and new links are left to you. Changing them in the browser can conflict with how those sites load.

The three scores

Your results show three scores out of 100: Search appearance, Crawling & links and Page structure. Each score is the share of checks that passed in that area. A score of 51 means 51% of the check points passed. It is not a Google ranking. Click How scoring works for the details.

Scores go up when a fix is confirmed on your live page, or when a later scan finds you fixed the issue in your website editor.

Review and apply fixes

Suggestions are sorted into tabs:

To apply a fix:

1. Open the Ready fixes tab.
2. Click Why this change? to see the current value, the suggested change and why it matters. Titles and descriptions include a search preview.
3. Click Apply fix. outwrite.ai first checks the live page again. If the page changed since the audit, nothing is applied.
4. Click Open & check to open the page. The script reports back, and the fix moves to Confirmed.

To apply several at once, tick their boxes, click Review & apply selected, then Apply selected changes.

For a broken link, click Choose page, paste the address of the page it should point to, then click Check & replace link. outwrite.ai makes sure the new page loads first.

For a For you item, click View steps, make the change in your website editor, then click Check my fix. This rechecks only that page, at no cost.

To ignore a suggestion, click the archive icon (Dismiss this suggestion). It moves to Dismissed, where Restore brings it back.

Let the agent handle routine fixes

By default, nothing changes on your site until you click Apply fix. To let outwrite.ai apply fixes for you:

1. Click Fix settings.
2. Choose Fix automatically. The button then reads Automatic fixes on.

Fix automatically becomes available after your script is verified. Once a day, outwrite.ai then applies up to 20 ready fixes from your most recent audit, if it finished in the last 8 days: titles, descriptions, caption-based image descriptions, heading levels that move one step, structured data, the mobile setting, preferred addresses and internal links. Each page is checked again first. Anything that no longer passes is kept for you to review, and Recent activity says so. Fixes you dismissed or undid are never applied again on their own. Broken-link replacements always wait for you to choose the page.

Each confirmed fix costs 5 credits, so automatic fixes use up to 100 credits a day. To stop, choose Review fixes first. Fixes already applied stay until you undo them. Automatic fixes are separate from scheduled scans.

Scans: Manual or Autopilot

Your first audit is included. After that, you choose when to scan again:

1. Click Choose pages & scan.
2. Set a Page limit and, if you like, pick Website sections.
3. Under Analyze, choose All selected pages, or New and changed pages to skip pages that haven't changed.
4. Click Review scan to see the Maximum cost.
5. Click Approve · [number] credits. The estimate is valid for 30 minutes.

To scan on a schedule, click Manual / Autopilot, choose Autopilot, then set Run every, Analyze, Maximum pages per run and Maximum credits per run. Click Enable scheduled scans. Each run first looks for new pages. To go back, choose Manual and click Save manual mode.

While a scan runs, you can Pause it, Resume it, or Stop scan. Stopping keeps the results finished so far.

What it costs

Example: a scan of 300 pages costs up to 600 credits. When you apply a fix, 5 credits are set aside. They are charged once the fix is seen on your page. If nobody visits that page within 7 days, the fix switches off and the credits go back to your balance. See Credits and usage.

How to undo a change

• In Pro: find the fix in the Checking, Confirmed or Changed tab and click Undo. The change stops on the next page load. Reload any page you already have open.
• If the brand now uses Simple: open Account and settings → Saved website changes and click Undo change. Undone changes show No longer applied.
• To stop everything: remove the script from your website.

Undo never touches your website's own content, because the SEO Agent never edits it in the first place.

How to tell it's working

"Seen on page" means your page shows the change. It doesn't mean Google has updated its results yet.

Common questions

Will the SEO Agent break my site?

It only changes page details: titles, descriptions, image descriptions, link addresses, heading levels, and the hidden tags described above. It applies a change only if the page still shows exactly what the audit saw. It never touches login, account, cart or checkout pages. Two changes can affect looks: a new heading level may use different styling, and the mobile setting can change your layout on phones. Preview those pages after applying.

What happens if I remove the script?

All SEO Agent changes stop on the next page load, and your pages go back to how they were. Your fixes stay listed in outwrite.ai. If you add the script back later, any fix you haven't undone applies again.

Does it change my CMS or website content?

No. Changes happen in the visitor's browser when the page loads. Your website editor, theme and saved content stay exactly as they are.

Will search engines and AI assistants see the changes?

Search engines that run JavaScript, such as Google, may see them. Tools that only read the original page code, including many link previews, may not. For your most important pages, also make the change in your website editor. The next scan then shows it as Fixed in website source.

Why didn't my first audit start?

The included audit is given once per website domain. If this domain already had one (for example, you reinstalled the script), Check installation tells you so and no scan starts. Click Find website pages (if shown), then Choose pages & scan to review the cost and run a paid scan. If you see an error after Check installation, follow its message and check again.

Why can't I click Apply fix?

The button works once the script is verified and the current scan has finished. Applying also fails if the script isn't on that particular page, so install it site-wide, not just on your homepage.

Why are some pages missing?

The audit only finds public pages that are in your sitemap or linked from other pages. Private pages, members-only content, pages blocked for search engines and pages whose content only appears with JavaScript may be missed or show little content.

A scan paused. What do I do?

Scans pause when your credits run out or you reach a spending limit. Add credits or raise your limit, then click Resume. If there is no Resume button, that scan can't continue as approved. Start a new one with Choose pages & scan.

Does it work with my SEO plugin?

Yes. It never adds structured data or a preferred address to a page that already has one, and it won't override a title or description that changed since the audit.

What does the script send to outwrite.ai?

Only the page address, to load the fixes for that page, and whether each fix was seen. It doesn't send page text, form entries or cookies, and it doesn't track your visitors.

Can I use the SEO Agent in Simple?

No, it is a Pro tool. If you switch a brand from Pro to Simple, fixes you already applied stay on your site. You can review and undo them in Account and settings → Saved website changes. See Simple or Pro?.

Related guides

• Existing Content
• Credits and usage
• SEO reports
• Install on any other website
• Simple or Pro?