SEOAgent for Codex

The SEO Skill for Codex

A free Skill that gives OpenAI Codex the tools to grow your organic traffic — audit your site, fix technical SEO, and write optimized pages right in your repo, with you approving every change.

Install the Skill — free

What is the SEO Skill for Codex?

The SEOAgent Skill turns OpenAI Codex into an SEO engine for your codebase. Once installed, you can ask Codex to audit your site, fix technical issues, research keywords, and write landing pages and articles — and it does the work as real files in your repo. Nothing publishes on its own: every change comes back as a normal diff to approve before you commit. It is the opposite of an auto-blogging tool — it is SEO that lives where you already ship.

How to use SEOAgent in Codex

  1. 1

    Install the Skill globally

    Run `npm install -g @seoagent-official/seoagent` once, then `seoagent init` in your project. This scaffolds the Skill into your `.agents/skills/seoagent/` directory so Codex picks it up automatically — no config to wire up.

  2. 2

    Ask Codex to audit your site

    Tell Codex "audit my site." The Skill fetches your homepage, sitemap, and robots.txt, runs a full technical-SEO check, and reports the biggest issues with the exact fix for each — not a vague to-do list.

  3. 3

    Approve the fixes

    Codex proposes changes — metadata, schema, canonicals, internal links — as edits you review before committing. Apply what makes sense and skip the rest. Safe, reversible, shipped through your normal pipeline.

  4. 4

    Write content in your repo

    Ask it to research keywords and write articles or landing pages. It builds a topic cluster with internal linking and writes the files straight into your repo (or your CMS), so a reviewed commit puts them live.

  5. 5

    Connect Search Console (optional)

    Run `seoagent login` to connect Google Search Console. Now the Skill grounds its suggestions in your real traffic data — which queries sit on page two, which pages are slipping — instead of guessing.

What SEOAgent does in Codex

Technical SEO audits

Crawls your pages and flags indexing, canonical, metadata, render, and internal-link issues — with the fix attached to each finding.

In-repo fixes

Applies safe, mechanical fixes (titles, meta descriptions, schema, alt text) directly in your source, and proposes the rest for review.

Keyword & competitor research

Pulls real volume and difficulty and finds the queries you can realistically win, so content targets terms that matter.

Content that ranks and gets cited

Writes landing pages and articles structured for both readers and AI answer engines, with automatic internal linking into a topic cluster.

Search Console grounding

Reads your real GSC performance and suggests evidence-backed updates, so the work compounds instead of going stale.

Human-in-the-loop, always

Every change is a diff you review before committing. No autopilot, no AI slop published behind your back.

Frequently asked questions

How do I add SEO to Codex?

Install the SEOAgent Skill: run `npm install -g @seoagent-official/seoagent`, then `seoagent init` in your project. Codex detects the Skill automatically — then just ask it to "audit my site" to start.

Is the SEOAgent Skill for Codex free?

Yes. The Skill is free forever and runs locally. An optional cloud tier ($49 per site per month) adds Google Search Console analysis, competitor research, and cloud review of suggested updates.

Does it publish content automatically?

No. SEOAgent proposes every change as a diff you review and approve before committing. It writes files into your repo or CMS, but you decide what ships — it is intentionally not an auto-publishing blog spammer.

What can Codex actually do with the Skill?

Run technical SEO audits, fix metadata/schema/canonicals/internal links in your source, research keywords and competitors, and write optimized landing pages and articles into your codebase — grounded in your Search Console data once connected.

Does it work with Claude Code and Cursor too?

Yes. The same Skill works in Claude Code and Cursor, plus a standalone CLI. See the SEO Skill for Claude Code and for Cursor.

Give Codex the SEO tools

Install the free Skill and run your first audit in minutes.

Get started — free