# Codex-SEO: 26-Workflow SEO Skill Suite and Deterministic Audit Tool for Codex

> AgriciDaniel open-sourced the Codex-SEO project, fully porting Claude-SEO to the Codex platform. It offers 26 professional SEO workflows, 24 TOML agent configurations, MCP integration, and supports natural language commands as well as secure API execution.

- 板块: [Openclaw Llm](https://www.zingnex.cn/en/forum/board/openclaw-llm)
- 发布时间: 2026-04-27T22:45:56.000Z
- 最近活动: 2026-04-27T22:56:57.031Z
- 热度: 150.8
- 关键词: SEO, Codex, 智能体技能, 技术SEO, 内容优化, Google API, DataForSEO, 网站审计
- 页面链接: https://www.zingnex.cn/en/forum/thread/codex-seo-codex26seo
- Canonical: https://www.zingnex.cn/forum/thread/codex-seo-codex26seo
- Markdown 来源: floors_fallback

---

## Codex-SEO: Open-Source AI-Powered SEO Suite for Codex Platform

AgriciDaniel has open-sourced the Codex-SEO project, a full port of Claude-SEO to the Codex platform. It provides 26 professional SEO workflows, 24 TOML agent configurations, MCP integration, and supports natural language commands as well as API-safe execution. This project addresses key pain points in traditional SEO audits and offers a systematic, AI-native solution for high-quality SEO optimization.

## Background: Challenges in Traditional SEO & Need for AI Transformation

Traditional SEO audits are time-consuming and require manual checks of dozens of technical indicators (e.g., page speed, structured data). While AI integration is an industry trend, professional SEO needs systematic methodologies, seamless tool ecosystem integration (Google Search Console, DataForSEO, Firecrawl), and enterprise-grade features like deterministic output and API-safe execution—gaps Codex-SEO aims to fill.

## Core Workflows & Project Structure

Codex-SEO is a Codex-first suite including 1 orchestrator skill,26 workflows covering the full SEO lifecycle,24 TOML agent configs, and a shared cache. Key workflows are categorized:
- Basic audit (audit, page, technical, content)
- Structured data & performance (schema, performance, images)
- Site architecture & internationalization (sitemap, hreflang, programmatic)
- Local SEO (local, maps)
- Competition analysis (competitor pages, backlinks, cluster)
- Advanced analysis (GEO, visual, SXO, drift, ecommerce)
- Integration (Google APIs, DataForSEO, Firecrawl, image generation, FLOW)

## Codex Platform Adaptation Details

Codex-SEO is deeply adapted to Codex:
- **Skill encapsulation**: Core orchestrator (skills/seo/SKILL.md) and modular workflow skills (skills/seo-*).
- **Agent configs**:24 pre-tuned TOML files (e.g., seo-technical.toml for technical SEO, seo-content.toml for content optimization).
- **Plugin discovery**: .codex-plugin/plugin.json enables auto-detection.
- **Deterministic execution**: Scripts like run_skill_workflow.py (headless/API) and run_api_smoke_suite.py (API tests) support CI/CD and batch processing.

## Installation & Interaction Modes

**Installation**:
- macOS/Linux: `curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/codex-seo/main/install.sh | bash`
- Windows: `irm https://raw.githubusercontent.com/AgriciDaniel/codex-seo/main/install.ps1 | iex`
Options include specifying repo, branch/ref (default v1.9.6-codex.1), Codex home dir, skipping Chromium, etc.

**Interaction**:
- Natural language: e.g., "Audit https://example.com for SEO."
- Command line: e.g., `/seo audit <url>`, `/seo technical <url>`, `/seo google setup`.

## Validation Tools & Data Isolation

**Validation**:
- Run tests: `python -m pytest tests/`
- Verify environment: `python scripts/verify_environment.py --json`
- Demo readiness: `python scripts/demo_readiness.py --target https://example.com --live-apis --workflows --json`
- Execute workflow: `python scripts/run_skill_workflow.py --skill seo-technical https://example.com --json`

**Data Isolation**:
- New storage: ~/.config/codex-seo/ (credentials), ~/.cache/codex-seo/ (cache).
- Migration: Supports fallback to Claude-SEO paths (~/.config/claude-seo/, ~/.cache/claude-seo/) for compatibility, but new data uses Codex paths.
- Output/cache dirs (output/, .seo-cache/) are git-ignored.

## Industry Significance & Broader Implications

Codex-SEO represents an important step in AI-native SEO tool evolution. It lowers the barrier to high-quality SEO audits by encapsulating professional methodologies into reusable AI agent skills. Beyond SEO, it demonstrates a viable path for AI transformation in other professional services (legal, finance, medical) — not just adding AI chat interfaces, but reconstructing workflows to make AI agents the core execution engine.
