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
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.
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.
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.
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.
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.
What is the best SEO skill for Codex?
SEOAgent is the highest-scoring SEO skill on the public SEO Skill Benchmark, and the only one built as a full harness: audits, fixes, keyword research, content, and Search Console grounding in one free install that never publishes without your approval.
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.
See also
Give Codex the SEO tools
Enter your site, create your prompt, and paste it into Codex — it installs the Skill, binds your account, and runs your first audit in minutes.
Want measurement on top? See Autopilot pricing.
Give Codex an SEO harness to continually measure and grow your site's organic traffic.