codex-seo
Free, open-source SEO audits inside OpenAI Codex CLI. Port of claude-seo: 26 skills, 19 specialist roles, technical SEO / schema / GEO / local / ecommerce.
What is codex-seo?
Free, open-source SEO audits inside OpenAI Codex CLI. Port of claude-seo: 26 skills, 19 specialist roles, technical SEO / schema / GEO / local / ecommerce.
Overview of codex-seo
What it is
Codex SEO is a free, open-source SEO audit tool designed to run inside OpenAI Codex CLI. It is a port of Agrici Daniel's claude-seo (MIT license) and adapts its audit methodology and scripts for the Codex CLI environment. The tool performs a complete SEO audit on any given website and produces a prioritized action plan. It checks technical SEO, content quality, structured data, AI search readiness (GEO), local SEO, and ecommerce SEO. The project consists of 26 sub-skills and 19 specialist role scripts. A full audit sequentially runs through each analysis role, with findings saved to disk. Each recommendation explains its importance and how to verify its effect.
Key features
- 26 sub-skills and 19 specialist roles covering technical SEO, content quality, structured data, AI search (GEO), local SEO, and ecommerce SEO.
- Automated business type detection (SaaS, local service, ecommerce, publisher, agency) to adjust checks accordingly.
- Full audit produces a prioritized action plan with scoring and verification guidance.
- Reports saved as Markdown; PDF generation available via
$seo google report. - Supports JavaScript-heavy sites (Next.js, React, Vue) via headless browser.
- No API key required for basic use; optional free Google APIs (PageSpeed Insights, Chrome UX Report, Search Console, GA4) can be connected for real field data.
- Runs locally in Codex CLI; data is sent to the OpenAI model behind the Codex session and saved as files on the local machine.
Use cases
- Performing a comprehensive SEO audit for any website, including technical, content, structured data, and AI search aspects.
- Analyzing single pages in depth with
$seo page. - Evaluating AI search readiness (AI Overviews, ChatGPT, Perplexity, Gemini) with
$seo geo. - Detecting and generating Schema.org structured data with
$seo schema. - Conducting local SEO audits (Google Business Profile, citations, reviews, map pack) with
$seo local. - Monitoring SEO drift over time using SQLite snapshots with
$seo drift.
Getting started
bashgit clone --depth 1 https://github.com/zhtyyx/codex-seo.gitbash codex-seo/install.shWindows (PowerShell):powershellgit clone --depth 1 https://github.com/zhtyyx/codex-seo.gitpowershell -ExecutionPolicy Bypass -File codex-seo/install.ps1After installation, start Codex CLI and run:bash$seo audit https://example.com$seo page https://example.com/pricing$seo geo https://example.com$seo schema https://example.com
License and pricing
MIT license. The project is free and open-source. No per-site fees or tracking. Some optional extensions may connect to paid services (user provides own account), but the core tool is fully usable without them.
Based on the project's public README and repository metadata.