$git clone https://github.com/AgriciDaniel/codex-seoCodex-first SEO analysis suite with 1 orchestrator skill, 26 specialist workflows, 24 TOML agent profiles, MCP/API extensions, deterministic headless runners, and premium audit report generation.
| 1 | <p align="center"> |
| 2 | <img src="screenshots/cover-image.webp" alt="Codex SEO: SEO audit skill suite for Codex" width="100%"> |
| 3 | </p> |
| 4 | |
| 5 | <h2 align="center"> |
| 6 | <a href="https://www.youtube.com/watch?v=39FE6_oRcYY">Watch on YouTube</a> |
| 7 | </h2> |
| 8 | |
| 9 | # Codex SEO - SEO Audit Skill Suite for Codex |
| 10 | |
| 11 | Codex-first SEO analysis suite with 1 orchestrator skill, 26 specialist workflows, 24 TOML agent profiles, MCP/API extensions, deterministic headless runners, and premium audit report generation. |
| 12 | |
| 13 | [](https://github.com/AgriciDaniel/codex-seo/actions/workflows/runners-ci.yml) |
| 14 | [](https://github.com/AgriciDaniel/codex-seo/releases) |
| 15 | [](https://github.com/openai/codex) |
| 16 | [](LICENSE) |
| 17 | [](pyproject.toml) |
| 18 | [](docs/COMMANDS.md) |
| 19 | |
| 20 | Codex SEO is a Codex-native port of [`AgriciDaniel/claude-seo`](https://github.com/AgriciDaniel/claude-seo), synchronized to upstream `main` at `a9cf338` and adapted for Codex skills, Codex plugins, TOML agents, shared cache artifacts, and repeatable local/API execution. |
| 21 | |
| 22 | It covers technical SEO, on-page analysis, content quality, E-E-A-T, schema markup, image optimization, sitemap architecture, Core Web Vitals, GEO/AEO for AI search, backlinks, local SEO, maps intelligence, Google APIs, semantic clustering, SXO, drift monitoring, e-commerce SEO, hreflang, FLOW prompts, DataForSEO, Firecrawl, and Gemini/nanobanana image workflows. |
| 23 | |
| 24 | ## Contents |
| 25 | |
| 26 | - [Status](#status) |
| 27 | - [Install](#install) |
| 28 | - [Quick Start](#quick-start) |
| 29 | - [Visual Overview](#visual-overview) |
| 30 | - [Commands](#commands) |
| 31 | - [Features](#features) |
| 32 | - [Extensions](#extensions) |
| 33 | - [Headless/API Usage](#headlessapi-usage) |
| 34 | - [Architecture](#architecture) |
| 35 | - [Verification](#verification) |
| 36 | - [Requirements](#requirements) |
| 37 | - [Credentials And Cache](#credentials-and-cache) |
| 38 | - [Security](#security) |
| 39 | - [Uninstall](#uninstall) |
| 40 | - [Contributing](#contributing) |
| 41 | - [Related Projects](#related-projects) |
| 42 | - [Credits](#credits) |
| 43 | - [Attribution](#attribution) |
| 44 | |
| 45 | ## Status |
| 46 | |
| 47 | - Repository visibility: public. |
| 48 | - Current release: [`v1.9.6-codex.5`](https://github.com/AgriciDaniel/codex-seo/releases/tag/v1.9.6-codex.5). |
| 49 | - Installer default ref: `v1.9.6-codex.5`. |
| 50 | - Latest local validation: 52 tests passing, full installed smoke suite passing, demo readiness passing. |
| 51 | - Runtime credentials stay outside the repo under Codex/local config paths. |
| 52 | - Discovery topics: `codex`, `codex-cli`, `codex-skills`, `seo`, `ai-seo`, `ai-search`, `technical-seo`, `generative-engine-optimization`, `core-web-vitals`, `schema-markup`, `local-seo`, `ecommerce-seo`, `content-strategy`, `google-search-console`, `dataforseo`, `mcp`, `python`, `automation`, `marketing-automation`, `open-source`. |
| 53 | |
| 54 | ## Install |
| 55 | |
| 56 | ### One-Line Install |
| 57 | |
| 58 | ```bash |
| 59 | curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/codex-seo/v1.9.6-codex.5/install.sh | bash |
| 60 | ``` |
| 61 | |
| 62 | Windows: |
| 63 | |
| 64 | ```powershell |
| 65 | irm https://raw.githubusercontent.com/AgriciDaniel/codex-seo/v1.9.6-codex.5/install.ps1 | iex |
| 66 | ``` |
| 67 | |
| 68 | ### Review Before Installing |
| 69 | |
| 70 | ```bash |
| 71 | git clone https://github.com/AgriciDaniel/codex-seo.git |
| 72 | cd codex-seo |
| 73 | bash install.sh |
| 74 | ``` |
| 75 | |
| 76 | Windows: |
| 77 | |
| 78 | ```powershell |
| 79 | git clone https://github.com/AgriciDaniel/codex-seo.git |
| 80 | cd codex-seo |
| 81 | powershell -ExecutionPolicy Bypass -File .\install.ps1 |
| 82 | ``` |
| 83 | |
| 84 | The installer copies the skill suite into `~/.codex/skills/`, installs TOML agents into `~/.codex/agents/`, creates a Python virtualenv at `~/.codex/skills/seo/.venv/`, installs core runtime dependencies, attempts optional capability groups, and verifies the runtime. |
| 85 | |
| 86 | ### Installer Overrides |
| 87 | |
| 88 | ```bash |
| 89 | CODEX_HOME=~/.codex \ |
| 90 | CODEX_SEO_REPO=https://github.com/AgriciDaniel/codex-seo \ |
| 91 | CODEX_SEO |