<p align="center">
<img src="screenshots/cover-image.webp" alt="Codex SEO: SEO audit skill suite for Codex" width="100%">
</p>
<h2 align="center">
<a href="https://www.youtube.com/watch?v=39FE6_oRcYY">Watch on YouTube</a>
</h2>
# Codex SEO - SEO Audit Skill Suite for Codex
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.
[](https://github.com/AgriciDaniel/codex-seo/actions/workflows/runners-ci.yml)
[](https://github.com/AgriciDaniel/codex-seo/releases)
[](https://github.com/openai/codex)
[](LICENSE)
[](pyproject.toml)
[](docs/COMMANDS.md)
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.
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.
## Contents
- [Status](#status)
- [Install](#install)
- [Quick Start](#quick-start)
- [Visual Overview](#visual-overview)
- [Commands](#commands)
- [Features](#features)
- [Extensions](#extensions)
- [Headless/API Usage](#headlessapi-usage)
- [Architecture](#architecture)
- [Verification](#verification)
- [Requirements](#requirements)
- [Credentials And Cache](#credentials-and-cache)
- [Security](#security)
- [Uninstall](#uninstall)
- [Contributing](#contributing)
- [Related Projects](#related-projects)
- [Credits](#credits)
- [Attribution](#attribution)
## Status
- Repository visibility: public.
- Current release: [`v1.9.6-codex.5`](https://github.com/AgriciDaniel/codex-seo/releases/tag/v1.9.6-codex.5).
- Installer default ref: `v1.9.6-codex.5`.
- Latest local validation: 52 tests passing, full installed smoke suite passing, demo readiness passing.
- Runtime credentials stay outside the repo under Codex/local config paths.
- 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`.
## Install
### One-Line Install
```bash
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/codex-seo/v1.9.6-codex.5/install.sh | bash
```
Windows:
```powershell
irm https://raw.githubusercontent.com/AgriciDaniel/codex-seo/v1.9.6-codex.5/install.ps1 | iex
```
### Review Before Installing
```bash
git clone https://github.com/AgriciDaniel/codex-seo.git
cd codex-seo
bash install.sh
```
Windows:
```powershell
git clone https://github.com/AgriciDaniel/codex-seo.git
cd codex-seo
powershell -ExecutionPolicy Bypass -File .\install.ps1
```
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.
### Installer Overrides
```bash
CODEX_HOME=~/.codex \
CODEX_SEO_REPO=https://github.com/AgriciDaniel/codex-seo \
CODEX_SEO_REF=v1.9.6-codex.5 \
bash install.sh
```
| Variable | Purpose |
|---|---|
| `CODEX_HOME` | Alternate Codex home. Defaults to `~/.codex`. |
| `CODEX_SEO_REPO` | Git URL, fork URL, or local repository path. |
| `CODEX_SEO_REF` | Branch, tag, or commit. Defaults to `v1.9.6-codex.5`. |
| `CODEX_SEO_SKIP_PLAYWRIGHT_BROWSER=1` | Skip Chromium install for visual/PDF workflows. |
| `CODEX_SEO_PLAYWRIGHT_WITH_DEPS=1` | Ask Playwright to install system dependencies where supported. |
## Quick Start
Restart Codex after installation. Then ask naturally; a `/seo` command is not required:
```text
Do a full SEO check on https://example.com following best practices.
```
```text
Review this page for schema, Core Web Vitals, image SEO, and AI search readiness.
```
```text
Create an SEO strategy and content roadmap for a local dental clinic.
```
Command-style prompts also work:
```text
/seo audit https://example.com
/seo technical https://example.com
/seo schema https://example.com
/seo dataforseo serp "best seo tools"
```
## Visual Overview
Codex SEO is designed as a Codex-first routing layer: the user can ask naturally, the orchestrator selects the right specialist workflow, and deterministic runners write repeatable artifacts instead of relying on invisible chat-only output.
```mermaid
%%{init: {"theme":"base","themeVariables":{"background":"#05080d","primaryColor":"#07131c","primaryTextColor":"#f5fbff","primaryBorderColor":"#00d7e6","lineColor":"#00d7e6","secondaryColor":"#06222a","tertiaryColor":"#ff9f1c","edgeLabelBackground":"#05080d","fontFamily":"Inter, ui-sans-serif, system-ui, sans-serif"}}}%%
flowchart LR
user["User prompt<br/>natural language or /seo"] --> orchestrator["skills/seo/SKILL.md<br/>main orchestrator"]
orchestrator --> cache[".seo-cache<br/>shared evidence"]
orchestrator --> skills["26 specialist<br/>SEO workflows"]
skills --> agents["24 TOML agents<br/>parallel analysis slices"]
skills --> scripts["scripts/<br/>deterministic runners"]
scripts --> output["output/<br/>Markdown, JSON, HTML, PDF"]
cache --> skills
class user,orchestrator accent
class cache,scripts data
class output output
classDef default fill:#07131c,stroke:#00d7e6,color:#f5fbff,stroke-width:1.4px
classDef accent fill:#10151a,stroke:#ff9f1c,color:#fff7ed,stroke-width:2px
classDef data fill:#06222a,stroke:#21e6c1,color:#ecfeff,stroke-width:1.5px
classDef output fill:#15101a,stroke:#ff9f1c,color:#fff7ed,stroke-width:1.8px
```
## Commands
| Prompt | Purpose |
|---|---|
| `/seo audit <url>` | Full site audit with specialist routing and premium report support |
| `/seo page <url>` | Deep single-page SEO analysis |
| `/seo technical <url>` | Crawlability, indexability, security, JavaScript, CWV |
| `/seo content <url>` | E-E-A-T, helpfulness, readability, AI citation readiness |
| `/seo schema <url>` | Structured data detection, validation, and JSON-LD generation |
| `/seo images <url>` | Alt text, image weight, formats, metadata, image SERP opportunities |
| `/seo sitemap <url>` | XML sitemap discovery, quality gates, generation guidance |
| `/seo geo <url>` | AI Overviews, ChatGPT, Perplexity, llms.txt, citability |
| `/seo performance <url>` | Core Web Vitals, Lighthouse-oriented performance signals |
| `/seo visual <url>` | Screenshots, mobile rendering, above-the-fold analysis |
| `/seo plan <business-type>` | Strategic SEO roadmap and content plan |
| `/seo programmatic <url>` | Programmatic SEO risk and scale planning |
| `/seo competitor-pages <url>` | Comparison and alternatives page opportunities |
| `/seo hreflang <url>` | International SEO, locale validation, content parity |
| `/seo local <url>` | Local SEO, GBP signals, NAP, citations, reviews |
| `/seo maps <command>` | Geo-grid, GBP audit, review intelligence, local maps signals |
| `/seo google <command>` | GSC, PageSpeed, CrUX, Indexing API, GA4 workflows |
| `/seo backlinks <url>` | Backlink profile summary and source-tier detection |
| `/seo cluster <keyword>` | SERP-based topic clustering and hub-spoke planning |
| `/seo sxo <url>` | Search Experience Optimization, intent/page-type fit |
| `/seo drift baseline <url>` | Capture an SEO baseline before changes |
| `/seo drift compare <url>` | Compare current SEO signals against a baseline |
| `/seo ecommerce <url>` | Product SEO, marketplace visibility, product schema |
| `/seo flow <stage>` | FLOW framework prompts for Find, Leverage, Optimize, Win |
| `/seo dataforseo <command>` | Live SERP, keyword, backlink, content, and AI visibility data |
| `/seo firecrawl <command>` | JS-rendered crawling and site mapping via Firecrawl |
| `/seo image-gen <use-case>` | OG images, hero images, product visuals, infographics |
Full command details live in [docs/COMMANDS.md](docs/COMMANDS.md).
## Features
### Full Audit Pipeline
- Detects site/business type.
- Runs technical, content, schema, sitemap, performance, visual, GEO, image, and on-page analysis.
- Adds conditional specialists for local, maps, Google APIs, backlinks, clusters, SXO, drift, and e-commerce.
- Writes markdown reports, JSON summaries, cache artifacts, and optional premium HTML/PDF output.
```mermaid
%%{init: {"theme":"base","themeVariables":{"background":"#05080d","primaryColor":"#07131c","primaryTextColor":"#f5fbff","primaryBorderColor":"#00d7e6","lineColor":"#00d7e6","secondaryColor":"#06222a","tertiaryColor":"#ff9f1c","edgeLabelBackground":"#05080d","fontFamily":"Inter, ui-sans-serif, system-ui, sans-serif"}}}%%
flowchart TD
request["Audit request"] --> detect["Detect site type<br/>business model and context"]
detect --> core["Core audit specialists"]
core --> technical["Technical"]
core --> content["Content"]
core --> schema["Schema"]
core --> sitemap["Sitemap"]
core --> geo["GEO / AI search"]
core --> images["Images"]
core --> performance["Performance"]
core --> visual["Visual"]
detect --> conditional["Conditional specialists"]
conditional --> local["Local / Maps"]
conditional --> backlinks["Backlinks"]
conditional --> google["Google APIs"]
conditional --> ecommerce["E-commerce"]
conditional --> drift["Drift"]
technical --> report["Unified SEO report"]
content --> report
schema --> report
sitemap --> report
geo --> report
images --> report
performance --> report
visual --> report
local --> report
backlinks --> report
google --> report
ecommerce --> report
drift --> report
report --> artifacts["SUMMARY.json<br/>FULL-AUDIT-REPORT.md<br/>ACTION-PLAN.md<br/>optional HTML/PDF"]
class request,detect accent
class core,conditional data
class report,artifacts output
classDef default fill:#07131c,stroke:#00d7e6,color:#f5fbff,stroke-width:1.4px
classDef accent fill:#10151a,stroke:#ff9f1c,color:#fff7ed,stroke-width:2px
classDef data fill:#06222a,stroke:#21e6c1,color:#ecfeff,stroke-width:1.5px
classDef output fill:#15101a,stroke:#ff9f1c,color:#fff7ed,stroke-width:1.8px
```
### Technical SEO
- Robots.txt, sitemap discovery, canonical checks, indexability, URL hygiene.
- Security headers, JavaScript rendering risk, mobile basics, IndexNow.
- Core Web Vitals with INP, LCP, CLS, FCP, TTFB, and PageSpeed/CrUX integrations where available.
### Content, GEO, And SXO
- E-E-A-T and helpful content signals.
- AI citation readiness, answer-first formatting, entity clarity, llms.txt support.
- Search experience analysis: page type, user stories, persona fit, intent mismatch.
### Structured Data
- JSON-LD extraction and validation.
- Schema recommendations for Organization, LocalBusiness, Product, Article, FAQ, Breadcrumb, and related types.
- Generated schema artifacts for downstream use.
### Local, Maps, And E-Commerce SEO
- Local SEO signals, GBP readiness, citations, reviews, NAP consistency.
- Maps intelligence via free sources and DataForSEO when configured.
- Product schema, marketplace endpoints, merchant visibility, and e-commerce template checks.
### Drift Monitoring
- Capture SEO-critical baselines.
- Compare deployments or page changes.
- Track title, meta, headings, canonical, schema, robots, links, and content deltas.
```mermaid
%%{init: {"theme":"base","themeVariables":{"background":"#05080d","primaryColor":"#07131c","primaryTextColor":"#f5fbff","primaryBorderColor":"#00d7e6","lineColor":"#00d7e6","actorBkg":"#07131c","actorBorder":"#00d7e6","actorTextColor":"#f5fbff","actorLineColor":"#21e6c1","signalColor":"#21e6c1","signalTextColor":"#f5fbff","labelBoxBkgColor":"#10151a","labelTextColor":"#f5fbff","noteBkgColor":"#10151a","noteTextColor":"#f5fbff","activationBkgColor":"#06222a","activationBorderColor":"#ff9f1c","fontFamily":"Inter, ui-sans-serif, system-ui, sans-serif"}}}%%
sequenceDiagram
participant Before as Baseline
participant Runner as Drift runner
participant After as Current page
participant Cache as .seo-cache
participant Report as Drift report
Before->>Runner: Capture titles, metas, canonicals, schema, headings
Runner->>Cache: Store baseline snapshot
After->>Runner: Re-check current SEO signals
Cache->>Runner: Load prior snapshot
Runner->>Report: Write changed, missing, and regressed signals
```
### Deterministic Runners
- `scripts/run_skill_workflow.py` standardizes output for every user-invokable workflow.
- `scripts/run_api_smoke_suite.py` runs all supported workflows in one pass.
- Setup-required workflows return structured fallback results instead of pretending live data exists.
## Extensions
| Extension | Skill | Setup | Notes |
|---|---|---|---|
| DataForSEO | `seo-dataforseo`, `seo-maps`, `seo-ecommerce`, `seo-cluster` | `./extensions/dataforseo/install.sh` | Live SERP, keyword, backlinks, on-page, content, business data, AI visibility |
| Google APIs | `seo-google`, `seo-performance` | `python scripts/google_auth.py --setup` | PageSpeed, CrUX, GSC, URL Inspection, Indexing API, GA4 |
| Firecrawl | `seo-firecrawl` | `./extensions/firecrawl/install.sh` | JS-rendered crawl, scrape, site map |
| Banana / Gemini | `seo-image-gen` | `./extensions/banana/install.sh` | AI image generation through `nanobanana-mcp` |
Optional integrations enrich the same workflow surface. If credentials or MCP servers are missing, wrappers return `setup_required` or `mcp_configured` states with no fabricated live data.
```mermaid
%%{init: {"theme":"base","themeVariables":{"background":"#05080d","primaryColor":"#07131c","primaryTextColor":"#f5fbff","primaryBorderColor":"#00d7e6","lineColor":"#00d7e6","secondaryColor":"#06222a","tertiaryColor":"#ff9f1c","edgeLabelBackground":"#05080d","fontFamily":"Inter, ui-sans-serif, system-ui, sans-serif"}}}%%
flowchart LR
codex["Codex SEO workflows"] --> local["Local evidence<br/>HTML, robots, sitemaps, screenshots"]
codex --> dfs["DataForSEO MCP<br/>SERP, keywords, backlinks, maps"]
codex --> google["Google APIs<br/>GSC, PageSpeed, CrUX, GA4"]
codex --> firecrawl["Firecrawl MCP<br/>JS crawl and site maps"]
codex --> banana["Gemini / nanobanana<br/>SEO image assets"]
local --> artifacts["Reports and .seo-cache"]
dfs --> artifacts
google --> artifacts
firecrawl --> artifacts
banana --> artifacts
class codex accent
class local,dfs,google,firecrawl,banana data
class artifacts output
classDef default fill:#07131c,stroke:#00d7e6,color:#f5fbff,stroke-width:1.4px
classDef accent fill:#10151a,stroke:#ff9f1c,color:#fff7ed,stroke-width:2px
classDef data fill:#06222a,stroke:#21e6c1,color:#ecfeff,stroke-width:1.5px
classDef output fill:#15101a,stroke:#ff9f1c,color:#fff7ed,stroke-width:1.8px
```
Demo readiness:
```bash
python scripts/demo_readiness.py --target https://example.com --live-apis --workflows --json
```
One low-depth DataForSEO proof:
```bash
python scripts/demo_readiness.py --target https://example.com --live-apis --live-serp --serp-keyword "seo tools" --json
```
## Headless/API Usage
Run a single workflow:
```bash
python scripts/run_skill_workflow.py --skill seo-technical https://example.com --json
python scripts/run_skill_workflow.py --skill seo-google https://example.com --json
python scripts/run_skill_workflow.py --skill seo-dataforseo https://example.com --json
```
Run the full smoke suite:
```bash
python scripts/run_api_smoke_suite.py https://example.com --json
```
Verify environment:
```bash
python scripts/verify_environment.py --target https://example.com --json
```
Bootstrap a clean runtime:
```bash
python scripts/bootstrap_environment.py --venv .venv --json
```
Artifacts are written to `output/`. Shared project cache is written to `.seo-cache/`. Both are ignored by git.
```mermaid
%%{init: {"theme":"base","themeVariables":{"background":"#05080d","primaryColor":"#07131c","primaryTextColor":"#f5fbff","primaryBorderColor":"#00d7e6","lineColor":"#00d7e6","secondaryColor":"#06222a","tertiaryColor":"#ff9f1c","edgeLabelBackground":"#05080d","fontFamily":"Inter, ui-sans-serif, system-ui, sans-serif"}}}%%
flowchart LR
cli["run_skill_workflow.py<br/>single workflow"] --> json["JSON result"]
cli --> markdown["Markdown report"]
cli --> cacheWrite[".seo-cache update"]
suite["run_api_smoke_suite.py<br/>all workflows"] --> json
suite --> outputRoot["output/api-smoke-*"]
verify["verify_environment.py"] --> readiness["ready / setup_required<br/>capability status"]
markdown --> outputRoot
json --> outputRoot
cacheWrite --> cache[".seo-cache"]
class cli,suite,verify accent
class cacheWrite,readiness data
class json,markdown,outputRoot,cache output
classDef default fill:#07131c,stroke:#00d7e6,color:#f5fbff,stroke-width:1.4px
classDef accent fill:#10151a,stroke:#ff9f1c,color:#fff7ed,stroke-width:2px
classDef data fill:#06222a,stroke:#21e6c1,color:#ecfeff,stroke-width:1.5px
classDef output fill:#15101a,stroke:#ff9f1c,color:#fff7ed,stroke-width:1.8px
```
## Architecture
The repository separates Codex-facing instructions, deterministic runtime code, optional provider setup, and validation contracts. That keeps the skill system usable in chat, installable as a suite, and testable from CI/API workflows.
```mermaid
%%{init: {"theme":"base","themeVariables":{"background":"#05080d","primaryColor":"#07131c","primaryTextColor":"#f5fbff","primaryBorderColor":"#00d7e6","lineColor":"#00d7e6","secondaryColor":"#06222a","tertiaryColor":"#ff9f1c","edgeLabelBackground":"#05080d","fontFamily":"Inter, ui-sans-serif, system-ui, sans-serif"}}}%%
flowchart TB
manifest[".codex-plugin/plugin.json"] --> skillsRoot["skills/"]
skillsRoot --> orchestrator["seo/SKILL.md<br/>routing and orchestration"]
skillsRoot --> specialists["seo-*/SKILL.md<br/>specialist workflows"]
agentsDir["agents/seo-*.toml"] --> specialists
scriptsDir["scripts/<br/>deterministic runners"] --> specialists
extensionsDir["extensions/<br/>optional MCP setup"] --> specialists
references["skills/seo/references/<br/>thresholds and shared contracts"] --> specialists
specialists --> cacheDir[".seo-cache/<br/>cross-skill memory"]
specialists --> outputDir["output/<br/>reports and artifacts"]
testsDir["tests/<br/>contract and smoke coverage"] --> manifest
testsDir --> skillsRoot
testsDir --> scriptsDir
class manifest,orchestrator accent
class skillsRoot,specialists,agentsDir,scriptsDir,extensionsDir,references,testsDir data
class cacheDir,outputDir output
classDef default fill:#07131c,stroke:#00d7e6,color:#f5fbff,stroke-width:1.4px
classDef accent fill:#10151a,stroke:#ff9f1c,color:#fff7ed,stroke-width:2px
classDef data fill:#06222a,stroke:#21e6c1,color:#ecfeff,stroke-width:1.5px
classDef output fill:#15101a,stroke:#ff9f1c,color:#fff7ed,stroke-width:1.8px
```
```text
codex-seo/
├── .codex-plugin/plugin.json # Codex plugin manifest
├── skills/
│ ├── seo/SKILL.md # Main orchestrator
│ └── seo-*/SKILL.md # 26 specialist workflows
├── agents/ # 24 Codex TOML agent profiles
├── scripts/ # Deterministic runners and API helpers
├── extensions/
│ ├── dataforseo/ # DataForSEO MCP setup and docs
│ ├── firecrawl/ # Firecrawl MCP setup and docs
│ └── banana/ # Gemini/nanobanana image generation setup
├── hooks/ # Quality-gate hooks
├── schema/ # Schema.org templates
├── docs/ # Architecture, commands, installation, MCP, demo
└── tests/ # Contract and workflow tests
```
Design principles:
- `skills/` is the source of truth.
- `skills/seo/SKILL.md` routes natural-language SEO requests.
- TOML agents are Codex-native and mirror specialist workflows.
- Runtime credentials stay in `~/.config/codex-seo/` or `~/.codex/settings.json`.
- Legacy `claude-seo` config/cache paths are read only as migration fallback.
More detail: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
## Verification
Local release gate:
```bash
python -m pytest tests/
bash -n install.sh uninstall.sh
python -m compileall -q scripts hooks
python scripts/run_api_smoke_suite.py https://example.com --json
```
PowerShell parse check:
```powershell
$files = Get-ChildItem -Recurse -Filter *.ps1
foreach ($f in $files) {
$tokens = $null
$errs = $null
[System.Management.Automation.Language.Parser]::ParseFile($f.FullName, [ref]$tokens, [ref]$errs) > $null
if ($errs.Count) { $errs; exit 1 }
}
```
Current GitHub CI runs:
- dependency install
- shell syntax checks
- Python compile checks
- `--help` checks for runner scripts
- `python -m pytest tests/`
- contract smoke checks for MCP-aware workflows
## Requirements
- Codex CLI with local skills support
- Python 3.10+
- Git
- Optional: Playwright Chromium for screenshots and PDF reports
- Optional: DataForSEO account for live SEO data
- Optional: Google API credentials for PageSpeed/CrUX/GSC/GA4
- Optional: Firecrawl API key for JS-rendered crawling
- Optional: Google AI API key for Gemini/nanobanana image generation
## Credentials And Cache
Codex SEO writes new local credentials and state to Codex-specific paths:
- `~/.codex/settings.json` for MCP server configuration
- `~/.config/codex-seo/` for API configs and cost ledgers
- `~/.cache/codex-seo/` for runtime caches
- `.seo-cache/` inside the active project for cross-skill summaries
Legacy `~/.config/claude-seo/` and `~/.cache/claude-seo/` paths are read only as migration fallback. Do not commit `.seo-cache/`, `output/`, `.mcp.json`, `.env`, OAuth tokens, service accounts, or provider keys.
## Security
- URL-aware scripts block private, loopback, reserved, multicast, unspecified, and metadata hosts.
- Credential setup writes outside tracked repo files.
- Sensitive local settings are expected to use `0600` file permissions.
- DataForSEO calls use cost guardrails through `scripts/dataforseo_costs.py`.
- Report vulnerabilities through [SECURITY.md](SECURITY.md).
## Uninstall
```bash
bash uninstall.sh
```
Windows:
```powershell
powershell -ExecutionPolicy Bypass -File .\uninstall.ps1
```
## Contributing
Use [CONTRIBUTING.md](CONTRIBUTING.md) for local setup and validation, [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) for project standards, [SECURITY.md](SECURITY.md) for vulnerability reporting, and [CREDITS.md](CREDITS.md) for project credits. Agent-facing project context is also available in [llms.txt](llms.txt).
## Related Projects
- [`claude-seo`](https://github.com/AgriciDaniel/claude-seo) - original Claude Code SEO skill suite
- [`claude-blog`](https://github.com/AgriciDaniel/claude-blog) - blog creation and optimization skill ecosystem
- [`claude-ads`](https://github.com/AgriciDaniel/claude-ads) - paid advertising audit skill suite
- [`flow`](https://github.com/AgriciDaniel/flow) - evidence-led SEO framework for AI search
- [`wp-mcp-ultimate`](https://github.com/AgriciDaniel/wp-mcp-ultimate) - WordPress MCP server
## Credits
Special thanks to [avalonreset](https://github.com/avalonreset) for making the Codex conversion possible and for creating the initial Codex SEO version that this repository builds on.
## Attribution
Original project and concept by [AgriciDaniel](https://github.com/AgriciDaniel) in [`claude-seo`](https://github.com/AgriciDaniel/claude-seo). This Codex port preserves upstream SEO capabilities and adapts the runtime for Codex skills, TOML agents, plugin discovery, cache sharing, MCP extension setup, and API-safe wrappers.
Codex SEO is released under the MIT License. FLOW prompt references retain their upstream attribution and licensing notices where included.
