This project provides a comprehensive, Codex-native SEO analysis suite designed for technical users and SEO professionals. It automates detailed audits, content strategy generation, and reporting, integrating with multiple data providers to offer a robust solution for understanding and improving website search performance. The suite aims to deliver deterministic, repeatable SEO insights beyond typical chatbot outputs.

How It Works

Codex SEO operates as a Codex-first routing layer. A central orchestrator skill interprets natural language prompts or /seo commands, directing them to one of 26 specialist workflows. These workflows utilize 24 TOML agent profiles for parallel analysis. The core innovation lies in its "deterministic runners," which generate consistent, machine-readable artifacts (Markdown, JSON, PDF) rather than relying on ephemeral chat outputs. This approach ensures repeatability and facilitates integration into automated CI/CD or API-driven workflows.

Quick Start & Requirements

• Install: Execute curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/codex-seo/v1.9.6-codex.5/install.sh | bash or the equivalent PowerShell command.
• Prerequisites: Codex CLI with local skills support, Python 3.10+, Git.
• Optional: Playwright Chromium (for visual/PDF reports), DataForSEO account, Google API credentials (PageSpeed, CrUX, GSC, GA4), Firecrawl API key, Google AI API key (for image generation).
• Documentation: COMMANDS.md, ARCHITECTURE.md.

Highlighted Details

• Full Audit Pipeline: Conducts comprehensive audits covering technical SEO, content quality (E-E-A-T, helpfulness), schema markup, sitemaps, Core Web Vitals, visual analysis, GEO/AI search readiness, image SEO, backlinks, local SEO, and e-commerce specifics.
• Deterministic Output: Generates standardized reports in Markdown, JSON, and optional HTML/PDF formats, ensuring consistent and verifiable results.
• Extensive Integrations: Seamlessly integrates with DataForSEO, Google APIs (GSC, PageSpeed, CrUX, GA4), Firecrawl for JS-rendered crawling, and Gemini/nanobanana for AI image generation.
• TOML Agents: Employs 24 TOML agent profiles for structured, parallel analysis within workflows.

Maintenance & Community

This project is a Codex port of the original AgriciDaniel/claude-seo, with significant contributions noted from avalonreset for the initial Codex conversion. Specific community channels like Discord or Slack are not detailed in the README.

Licensing & Compatibility

Released under the MIT License, permitting commercial use and integration into closed-source projects.

Limitations & Caveats

Full functionality, particularly for live data integrations (DataForSEO, Google APIs, Firecrawl, Gemini), requires users to obtain and configure their own API credentials and accounts. Playwright Chromium is necessary for visual and PDF report generation. Workflows without configured credentials will return structured fallback data rather than fabricated live results.