Codex SEO Agent

codex-seo-agent is a native Codex-compatible SEO workflow repo for full-site audits, technical SEO reviews, keyword research, content briefs, local SEO, and client-facing reporting.

It is designed for Codex users who want structured, repeatable SEO work without relying on Claude-specific slash commands, plugin manifests, or agent installers.

Built by MavenUp.

What It Does

• Runs full SEO audits with business-type detection, weighted scoring, and prioritized action plans
• Separates technical SEO, on-page SEO, content SEO, local SEO, and reporting concerns
• Supports keyword discovery, clustering, and prioritization
• Produces content briefs for service pages, blog posts, BOFU pages, and comparison pages
• Reviews local SEO signals including GBP, citations, reviews, and location-page quality
• Provides reusable prompt templates for Codex workflows

Supported Codex Workflows

• Full website audit
• Technical SEO audit
• Keyword research and clustering
• Content brief creation
• Local SEO audit
• SEO report packaging

Installation

Detailed instructions live in docs/installation.md.

Quick start:

1. Clone or download this repository.
2. Open codex-seo-agent/ as your Codex workspace root.
3. Keep the skills/, .codex/prompts/, and AGENTS.md files together.
4. Use the prompt files directly or ask Codex to follow one of the repo skills.

For global installation, copy the folders in skills/ into $CODEX_HOME/skills/ or ~/.codex/skills/.

Usage Examples

• Use the seo-audit skill to audit https://example.com and produce a full report plus action plan.
• Follow .codex/prompts/technical-seo.md to audit https://example.com.
• Use the keyword-research skill to research "emergency plumber chicago".
• Use the content-brief skill to build a BOFU landing-page brief for accounting software for agencies.
• Use the local-seo skill to review https://example.com for map-pack readiness.

More examples live in docs/usage.md and examples/.

Folder Structure

codex-seo-agent/
  README.md
  LICENSE
  AGENTS.md
  skills/
  .codex/
    prompts/
  examples/
  docs/

Skills

• seo-audit: full-site audits, scoring, action plans, schema and GEO consolidation
• technical-seo: crawlability, indexability, security, CWV, rendering, sitemap validation
• keyword-research: keyword discovery, SERP-aware grouping, prioritization, cluster planning
• content-brief: SEO and conversion briefs with E-E-A-T and AI-citation requirements
• local-seo: GBP, citations, reviews, local schema, service-area and multi-location reviews
• seo-reporting: report packaging, QA, stakeholder-ready deliverables

Limitations

• This repo does not claim one-to-one runtime parity with every command from the source project.
• It does not ship the original plugin installer, slash-command parser, or source-specific subagent manifests.
• Live data parity still depends on the environment, external APIs, and what tools your Codex session can access.
• Niche source workflows like drift monitoring, hreflang, backlinks, ecommerce, maps intelligence, and standalone GEO are consolidated into broader Codex skills rather than exposed as separate public skills in this release.

Disclaimer

This project is not affiliated with OpenAI, Anthropic, or Claude. It is an independent Codex-oriented SEO workflow repository.