Check my websiteGuidesAbout
Fecto / Guides / Codex SEO

Codex SEO

Codex will follow an SEO checklist in AGENTS.md to the letter, but a checklist can’t see the redirects, headers and robots rules your live site adds after the build. Install the Fecto plugin so Codex scans the deployed site first, then fixes the checks that actually fail.

Free, about ten seconds, no account.

How Codex picks up skills and MCP servers

Codex reads skills as folders with a SKILL.md: from .agents/skills in the repo and its parent folders, from ~/.agents/skills for you, plus a few bundled ones. Plugins are how skills travel beyond one repo, and a plugin can bundle MCP server connections too. That is how Fecto installs: one plugin from the makloai/plugins marketplace brings the skills and the remote MCP server, then codex mcp login fecto signs you in through the browser.

AGENTS.md is still the right place for project facts Codex should always know: the build command, the folder the site is in, where the dev server listens. Keep SEO rules out of it. The Fecto skill asks the server for current instructions at the start of each session, so the SEO guidance updates itself while AGENTS.md stays about your project.

Common causes, and the fix for each

A noindex that was meant for staging

Fecto check index.noindex · Page may be indexed and quoted

Codex is often asked to “stop the preview being indexed” and does it in code, behind an environment variable. If production ends up with the same value, every page goes out with noindex. The check reads both the robots meta tag and the X-Robots-Tag header on the live page, so it catches the header version too, which never shows up in the source.

lastmod set to the build time

Fecto check fresh.sitemap-lastmod · Sitemap dates

Generated sitemaps often stamp every URL with the time of the build, so every page claims to change on every deploy. The rule wants lastmod to move only when the content moves. Codex can take dates from the content files or from git history instead.

Pages with a heading and a button and little else

Fecto check read.little-text · Enough text to understand the page

Landing pages written in a hurry say what the product is in five words. If a page has no more than a few sentences of visible text, neither a search engine nor an assistant can tell what it is for. Codex can draft the copy, but the step asks it to use facts already on the site and leave gaps for you to fill rather than inventing claims.

Contact details on the page but not in the structured data

Fecto check record.contact-in-schema · Contact details in structured data

The business node should carry a telephone or email, and an address when it is a place people visit. Codex moves the details the footer already shows into the JSON-LD, so the two can’t drift apart.

Let your agent do it

The Codex button opens a new Codex task with the instructions typed in. If the plugin is missing, Codex installs it, asks you to finish signing in in the browser and to start again; after that it shows your score and talks through what you want. The install command is below for reference; you don’t need to run it yourself.

Each fix is one pull request. Codex runs the step’s checks against your dev server before reporting, and you merge.

CodexClaude appClaude CodeCursor

No coding agent yet? Install the Claude app, sign in, then come back and choose Claude app.

Set it up by hand
curl -fsSL https://fecto.ai/install | sh

Then tell it

Use Fecto to check and fix my site.

For reference, the Codex install command: codex plugin marketplace add makloai/plugins && codex plugin add fecto@makloai && codex mcp login fecto --scopes mcp,offline_access

Don’t fix a stray noindex by deleting the staging guard

The guard that keeps previews out of search is worth keeping. Ask Codex to key it on the production hostname rather than on a variable that can leak between environments, and keep both behaviours covered by a test.

What it costs

You pay only when the result shows up on your site: +20% more visits or enquiries is $30, +50% is $60, double is $100, and anything below +20% costs $0. Never more than $100 a site a month.

Questions

Does Codex have an SEO skill built in?

No. Codex bundles a few general skills, such as one for creating skills and one for installing them; SEO isn’t among them. You can write your own SKILL.md in .agents/skills, but a skill on its own still can’t see your live site, which is why Fecto’s plugin pairs one with an MCP server.

Will Codex change my site without asking?

No. Nothing is added to your site before you have agreed a goal and saved a card, and then it is one line, the Fecto tag, in its own pull request. Every later change is a pull request too. Codex never merges, and it never decides whether the result was met: Fecto’s verifier does, from the tag’s count.

What if my site isn’t in a repo Codex can reach?

Then Codex gives you the steps for your site builder instead of a pull request, and reports them so the plan keeps track. If the builder can’t do a step at all, Fecto’s move-to-code skill helps you move the site into a repo.

Related guides

  • Claude Code SEO
  • Cursor SEO
  • Vercel SEO
  • SEO with Claude Code
  • AI SEO audit, free
  • All guides

Checked against OpenAI docs: build skills for Codex on 18 November 2026.