Codex SEO: 26 Workflow Audit SEO Cho Codex CLI 2026
Khi OpenAI ship Codex CLI tháng 2/2026, ecosystem skill cho nó vẫn rất mỏng so với Claude Code, chỉ có vài skill cơ bản. Codex SEO là skill suite đầu tiên cover full SEO audit qua Codex CLI: 1 orchestrator + 26 specialist workflow + 24 TOML agent profile, deterministic runner, premium HTML/PDF report. Repo này là Codex-native port của claude-seo, sync với upstream main tại commit a9cf338 và adapt cho Codex skills + Codex plugins + shared cache artifacts.
Với 164 GitHub stars + 29 forks tính đến 22/05/2026 và phiên bản v1.9.6-codex.5 ship 28/04/2026, Codex SEO mang quality SEO audit của claude-seo (v1.9.9, 6.934 stars) sang Codex CLI runtime. Nghĩa là PPC + SEO consultant đã chọn Codex CLI thay cho Claude Code (vì pricing, vì OpenAI ecosystem, vì policy compliance) không phải đợi port hay rewrite, mà có sẵn 26 workflow SEO chạy được ngay sau khi cài install script.
TL;DR
- Codex SEO là Codex-native port của claude-seo (164 stars, v1.9.6-codex.5, ship 28/04/2026), audit SEO qua Codex CLI thay vì Claude Code.
- 26 specialist workflow + 24 TOML agent profile: technical SEO, content, schema, sitemap, GEO/AEO, CWV, backlinks, local, maps, e-commerce, drift, FLOW.
- Tích hợp DataForSEO + Firecrawl + Gemini + Google APIs (GSC, PageSpeed, CrUX, Indexing API, GA4) qua MCP/REST.
- Free MIT, output Markdown + JSON + HTML/PDF report, chạy local + deterministic.
- Phù hợp: dev đã chọn Codex CLI làm primary agent runtime, không muốn switch Claude Code chỉ để audit SEO.
Nguồn: Daniel Agrici phát hành Codex SEO ngày 27/04/2026, cập nhật lên v1.9.6-codex.5 ngày 28/04/2026 (164 GitHub stars + 29 forks, MIT license). 52 test passing local + full installed smoke suite passing, demo readiness verified. Sync upstream claude-seo tại commit a9cf338.
Codex SEO Là Gì Và Khác Claude SEO Ở Chỗ Nào?
Codex SEO là skill suite SEO audit cho OpenAI Codex CLI, port từ claude-seo nhưng adapt cho Codex runtime: TOML agent profile (Codex format), shared cache artifacts ở ~/.codex/skills/seo/.venv/, repeatable local/API execution. Khác Claude SEO ở 3 chỗ chính: (1) chạy trên Codex CLI thay vì Claude Code, (2) hỗ trợ natural language prompt mà không cần lệnh /seo (Codex routing layer tự dispatch), (3) install qua ~/.codex/ path standards thay vì ~/.claude/skills/.
Cùng feature set với claude-seo: technical SEO, on-page analysis, content quality, E-E-A-T scoring, schema markup detection + JSON-LD generation, image optimization, sitemap architecture validation, Core Web Vitals (INP/LCP/CLS/FCP/TTFB), GEO/AEO for AI search (AI Overviews + ChatGPT + Perplexity + llms.txt), backlinks, local SEO + GBP signals, maps intelligence, Google APIs (GSC + PageSpeed + CrUX + Indexing + GA4), semantic clustering, SXO (Search Experience Optimization), drift monitoring, e-commerce SEO, hreflang, FLOW prompts framework, DataForSEO integration, Firecrawl crawling, Gemini/nanobanana image generation.
Điểm khác biệt cốt lõi nằm ở “Codex-first routing”. Bạn không cần memorize lệnh, chỉ cần hỏi tự nhiên kiểu: “Do a full SEO check on ongboit.com following best practices” rồi Codex orchestrator (skills/seo/SKILL.md) tự pick đúng specialist workflow, deterministic runner sẽ write repeatable artifact thay vì invisible chat-only output. Output là Markdown + JSON file lưu vào folder output/, dùng được cho client deliverable hoặc commit vào repo audit.
26 Workflow Nào Được Cover Trong Codex SEO?
Codex SEO không chỉ là 1 lệnh /seo audit. Nó là suite 26 specialist workflow gọi qua command-style hoặc natural language. Đây là 14 lệnh chính mình dùng nhiều nhất:
# Full site audit với specialist routing
/seo audit https://ongboit.com
# Single-page deep dive
/seo page https://ongboit.com/claude-code-la-gi/
# Technical SEO (crawl, index, JS rendering, CWV)
/seo technical https://ongboit.com
# GEO/AEO cho AI search (AI Overview + ChatGPT + Perplexity + llms.txt)
/seo geo https://ongboit.com
# Core Web Vitals via PageSpeed + CrUX
/seo performance https://ongboit.com
# Backlink profile + source-tier detection
/seo backlinks https://ongboit.com
# Topic clustering SERP-based (hub-spoke planning)
/seo cluster "claude code skill"
# Search Experience Optimization (intent/page-type fit)
/seo sxo https://ongboit.com/claude-code-mcp-la-gi/
# Drift monitoring (baseline + compare)
/seo drift baseline https://ongboit.com/claude-code-la-gi/
/seo drift compare https://ongboit.com/claude-code-la-gi/
# Google APIs (GSC + PageSpeed + CrUX + Indexing + GA4)
/seo google gsc ongboit.com
# DataForSEO live (SERP + keyword + backlink + AI visibility)
/seo dataforseo serp "best seo tools"
# FLOW framework prompts (Find, Leverage, Optimize, Win)
/seo flow find12 workflow còn lại cover: content quality E-E-A-T (/seo content), schema validation (/seo schema), image SEO (/seo images), sitemap (/seo sitemap), visual rendering (/seo visual), strategic plan (/seo plan saas), programmatic SEO (/seo programmatic), competitor pages (/seo competitor-pages), hreflang international (/seo hreflang), local SEO (/seo local), maps intelligence (/seo maps), e-commerce (/seo ecommerce), Firecrawl JS-rendered crawling (/seo firecrawl), image generation (/seo image-gen).
Mỗi workflow là 1 SKILL.md file riêng trong skills/seo/, gọi 24 TOML agent profile khi cần parallel slice analysis (ví dụ technical SEO chạy 5-7 agent song song check robots.txt + sitemap + canonical + security headers + JS rendering + mobile).
💜 Quick Decision Guide
Bạn nên dùng Codex SEO thay Claude SEO nếu…
- 🛠️ Dev/team primary runtime là OpenAI Codex CLI: Khỏi switch sang Claude Code chỉ để audit. Cùng feature set, cùng upstream commit a9cf338, install vào ~/.codex/skills/ namespace riêng.
- 💰 SEO consultant tối ưu cost long-context: GPT-5 cheaper ~30-40% vs Sonnet 4.6 cho audit task dài (multi-page deep-dive cluster). Tiết kiệm rõ rệt với agency scale 50+ page/tuần.
- 🔒 Org policy chỉ approve OpenAI API (compliance): Codex SEO là path duy nhất giữ nguyên 26 workflow của claude-seo mà không gọi Anthropic API. GDPR/SOC2 audit dễ pass hơn.
- 📚 Đã dùng Codex ecosystem khác (codex-builder, codex-research): Skill nhất quán trong cùng namespace. Share Python virtualenv, share cache artifact, share TOML agent format.
- ❌ Đã quen Claude Code workflow: Stick với claude-seo (v1.9.9, 6.934 stars). Codex port có lag 2-7 ngày so với upstream, ít user/issue thread tham khảo hơn.
Cài Đặt Codex SEO Trong 3 Phút Như Thế Nào?
Codex SEO cần Codex CLI đã cài trước (xem hướng dẫn cài Codex CLI từ OpenAI). Sau đó chạy 1 trong 2 cách:
# Cách 1: One-line install (Unix/macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/codex-seo/v1.9.6-codex.5/install.sh | bash
# Cách 1b: Windows PowerShell
irm https://raw.githubusercontent.com/AgriciDaniel/codex-seo/v1.9.6-codex.5/install.ps1 | iex
# Cách 2: Clone + review trước khi cài
git clone https://github.com/AgriciDaniel/codex-seo.git
cd codex-seo
bash install.sh
# Override environment variables nếu cần custom path/ref
CODEX_HOME=~/.codex \
CODEX_SEO_REPO=https://github.com/AgriciDaniel/codex-seo \
CODEX_SEO_REF=v1.9.6-codex.5 \
bash install.shInstaller sẽ copy skill suite vào ~/.codex/skills/, install 24 TOML agent vào ~/.codex/agents/, tạo Python virtualenv tại ~/.codex/skills/seo/.venv/, cài core runtime dependency, attempt optional capability groups (Playwright cho visual SEO, Gemini cho image-gen, Firecrawl cho JS-rendered crawl), rồi verify runtime end-to-end. Process mất khoảng 2-4 phút tùy network.
Sau khi install xong, restart Codex CLI rồi hỏi tự nhiên: “Do a full SEO check on ongboit.com” hoặc chạy command-style /seo audit ongboit.com. Cả hai dispatch về cùng orchestrator. Credentials (DataForSEO key, Google API token, Firecrawl key) lưu ngoài repo trong ~/.codex/config/, không commit vào git.
Workflow Audit Một Trang Lần Đầu Trông Thế Nào?
Mình thử Codex SEO lần đầu trên trang claude-code-skills của ongboit. Đây là natural language prompt mình dùng:
# 1. Mở Codex CLI
codex
# 2. Hỏi tự nhiên (không cần nhớ lệnh)
Audit https://ongboit.com/claude-code-skills/ for:
- Technical SEO (CWV, crawl, JS rendering)
- Content E-E-A-T signals
- AI search readiness (AI Overview + ChatGPT)
- Schema markup completeness
Then generate a premium PDF report.
# 3. Codex orchestrator tự dispatch 4 specialist workflow song song
# /seo technical + /seo content + /seo geo + /seo schema
# Aggregate kết quả + generate FULL-AUDIT-REPORT.md + .pdfOutput trong folder output/[timestamp]/:
SUMMARY.json: aggregated score + grade + top findings.FULL-AUDIT-REPORT.md: detailed markdown report với section per specialist.ACTION-PLAN.md: prioritized action items với owner + ETA.premium/report.html+premium/report.pdf: client-ready PDF (Playwright-rendered, professional layout).
Audit này mất 4 phút 22 giây trên máy mình (M2 MacBook Pro). DataForSEO call: 12 (cost ~$0.008), Firecrawl: 1 (cost $0), Gemini: 0 (không generate ảnh trong audit này), Anthropic API: $0 (Codex dùng OpenAI primary), OpenAI API: ~$0.08 (Codex CLI cost cho audit logic). Tổng cost: ~$0.09 mỗi audit page deep-dive.
🛠️ Engineer’s Perspective
Sau 3 tuần test Codex SEO trên 12 page production ongboit, đây là 4 sharp edge load-bearing khi quyết định switch từ Claude SEO sang Codex port:
- Audit Vietnamese E-E-A-T scoring slightly thấp hơn Claude. Cùng 1 article ongboit tiếng Việt, Sonnet 4.6 rate E-E-A-T 87/100, GPT-5 rate 81/100 (delta ~5-8 điểm). Khác biệt do training data Vietnamese signal. Acceptable cho audit pipeline nhưng aware khi report cho client Việt.
- Playwright dependency conflict trên macOS Apple Silicon. Premium PDF report (Playwright-rendered) thường fail install lần đầu trên M1/M2 vì Chromium download bị block. Workaround: chạy `npx playwright install chromium –with-deps` riêng trước khi chạy install.sh, hoặc set `CODEX_SEO_SKIP_PLAYWRIGHT_BROWSER=1` rồi cài Playwright sau.
- Cache artifact ở .seo-cache/ không invalidate khi đổi DataForSEO location_code. Lần đầu audit Vietnamese page với location_code=2840 (USA accidentally), cache rồi. Lần 2 đổi sang 2704 (Vietnam) thì vẫn dùng US SERP cache, không re-fetch. Workaround: xóa thủ công `~/.codex/skills/seo/.seo-cache/` khi đổi location.
- TOML agent format chưa support nested context như Claude Markdown. Claude SEO agent có thể đọc nested context (parent project + grandparent CLAUDE.md). Codex TOML format hiện chỉ flat top-level context. Khi audit cluster pillar/spoke, phải pass context thủ công qua CLI flag thay vì auto-inherit. Minor friction cho large-cluster workflow.
Codex SEO So Với Claude SEO Thì Khác Gì?
Cả 2 skill cùng tác giả Daniel Agrici, cùng feature set, nhưng chạy trên 2 runtime khác nhau. Đây là so sánh dựa trên trải nghiệm production của mình:
| Tiêu chí | Codex SEO | Claude SEO |
|---|---|---|
| Runtime | Codex CLI (OpenAI) | Claude Code (Anthropic) |
| Version hiện tại | v1.9.6-codex.5 | v1.9.9 |
| GitHub stars | 164 | 6.934 |
| Số workflow | 26 | 26 (cùng base) |
| Agent format | 24 TOML profile | 24 Markdown subagent |
| Natural language prompt | ✓ (Codex routing layer) | ✓ (Claude routing) |
| Slash command | ✓ /seo audit |
✓ /seo audit |
| Install path | ~/.codex/skills/ |
~/.claude/skills/ |
| Cost per audit page | ~$0.08-0.10 (GPT-5) | ~$0.05-0.15 (Sonnet 4.6) |
| Eval test | 52 passing | 68 passing |
| License | MIT | MIT |
Khi nào nên chọn Codex SEO:
- Team primary dev runtime là Codex CLI (OpenAI), không muốn switch sang Claude Code chỉ để audit SEO.
- Cost optimization: GPT-5 cheaper hơn Claude Sonnet 4.6 cho long-context audit task (cụ thể ~30-40% savings).
- Compliance: org cấm Anthropic API, chỉ approve OpenAI (hoặc ngược lại).
- Đã dùng Codex skills khác (codex-builder, codex-research) và muốn ecosystem nhất quán.
Khi nào nên chọn Claude SEO:
- Đã quen Claude Code workflow, có Claude Pro subscription.
- Cần feature mới nhất ngay khi ship (Claude SEO upstream, Codex SEO port có lag 2-7 ngày).
- Audit Vietnamese content quality tốt hơn với Sonnet 4.6 (mình test trên ongboit, Claude rate slightly cao hơn cho diacritics + structure check).
- Cần Claude-specific feature như Artifacts hoặc nội bộ Anthropic tooling.
Codex SEO Tích Hợp Với Codex CLI Ecosystem Như Thế Nào?
Codex SEO không hoạt động đơn lẻ. Trong workflow ongboit hàng tuần, mình combine nó với các skill khác của AgriciDaniel + community:
- GWS CLI (Google Workspace CLI) đẩy SUMMARY.json từ audit vào Google Drive folder client, share link auto. Không cần copy-paste.
- Autoresearch skill (port Codex sắp ra) bridge SEO audit + content research, output
FULL-AUDIT-REPORT.md+ recommended H2 outline cho bài cải thiện ranking. - Claude Blog skill rewrite landing page intro/CTA/meta dựa trên
ACTION-PLAN.mdrecommendations từ/seo content+/seo geo. - Banana Claude generate OG image + hero infographic theo
/seo image-genrecommendations (4K, brand color compatible). - Claude Search Console pull GSC actual ranking data, cross-reference với baseline drift để confirm fix đã work hay chưa.
Hai workflow mình chạy nhất:
- Weekly audit cluster: chạy
/seo auditcho 5 trang quan trọng nhất, drift compare với baseline tuần trước, output Markdown vào folderaudits/2026-W21/. Mất khoảng 25 phút cho 5 page. - Pre-publish check: trước khi publish bài mới, chạy
/seo page [draft-url]+/seo geo [draft-url]để verify GEO + AI citation readiness ≥ 75 score. Mất 2-3 phút.
📈 Cluster SEO của ongboit chạy chính nhờ community này
Mình đã join AI Marketing Hub Pro với Daniel Agrici từ rất sớm. Skill claude-seo và codex-seo + Search Console workflow ongboit đang dùng đa số học được trong group. Trong tất cả các community SEO marketing với Claude Code / Codex CLI / n8n mình từng tham gia, đây là chỗ active và contribute nhiều nhất, peer review từ pro member chỉ ra gap mình tự miss.
Skill SEO ship liên tục, pro member access trước public. Nếu serious về AI-search SEO 2026 trên Codex CLI hoặc Claude Code, đây là community nên đầu tư.
Câu Hỏi Thường Gặp Về Codex SEO
Mình đã dùng Claude SEO, có nên cài thêm Codex SEO không?
Không cần, trừ khi bạn primary dev trên Codex CLI thay vì Claude Code. Cả 2 skill có cùng feature set + cùng upstream commit (a9cf338). Cài cả 2 chỉ tốn disk space + Python virtualenv mà không cho thêm capability mới. Nếu bạn dùng cả Claude Code và Codex CLI cho project khác nhau, cài skill tương ứng cho từng runtime.
Codex SEO có hỗ trợ Vietnamese content tốt không?
Có, qua GPT-5 (Codex CLI default model). Test trên 5 bài ongboit tiếng Việt, output audit phân biệt được diacritics, hiểu cấu trúc câu Việt, gợi ý keyword Vietnamese-only chuẩn. Tuy nhiên với content E-E-A-T scoring trên Vietnamese, mình thấy Claude Sonnet 4.6 (qua claude-seo) rate slightly chính xác hơn vì training data Sonnet có nhiều Vietnamese content quality signal hơn. Khác biệt khoảng 5-8% trên thang 100, không lớn.
DataForSEO API key có bắt buộc không?
Không bắt buộc, nhưng recommended. Nếu không có DataForSEO key, các workflow /seo dataforseo, /seo cluster, /seo backlinks, một phần /seo audit sẽ skip với warning. Bạn vẫn dùng được technical SEO + content + schema + sitemap + CWV + GEO (qua public web fetch + Google PageSpeed free tier). DataForSEO trial $1 credit đủ cho 1.500-2.000 API call, audit khoảng 100 page deep-dive.
Phiên bản v1.9.6-codex.5 có ổn định không?
Ổn định cho production. 52 test passing + full installed smoke suite passing + demo readiness verified. Mình đã chạy trên 12 page ongboit production trong 3 tuần, không crash lần nào. Codex SEO follow nguyên tắc deterministic runner: cùng input ra cùng output, không random hallucination. Updates ship lag claude-seo upstream khoảng 2-7 ngày, không phải real-time sync.
Output có dùng làm client deliverable được không?
Được. Phiên bản v1.9.6-codex.5 có premium HTML/PDF report (Playwright-rendered, professional layout) tại output/[timestamp]/premium/. Mình deliver PDF report này cho 2 client SEO consulting trong tháng 4-5/2026, feedback positive. Lưu ý PDF có watermark “Generated by Codex SEO” nhỏ ở footer, có thể remove qua post-processing nếu bạn cần white-label cho enterprise client.
Có tương thích với Claude Code skills khác không?
Không trực tiếp. Codex SEO chạy trong ~/.codex/ namespace, Claude Code skill chạy trong ~/.claude/skills/ namespace, 2 hệ thống file riêng. Tuy nhiên cùng pattern Agent Skills standard, nên skill mới ship sau này có thể support cả 2 runtime qua --target=codex flag (như cách claude-ads v1.7 làm).
Codex SEO Có Đáng Setup Nếu Dev Việt Mới Bắt Đầu Codex CLI?
Codex SEO phù hợp với 3 nhóm: dev Việt đã chọn Codex CLI làm primary agent runtime (không muốn switch Claude Code chỉ để audit SEO), marketing team với org policy chỉ approve OpenAI (compliance, không được dùng Anthropic API), và SEO consultant tối ưu cost (GPT-5 cheaper hơn Sonnet cho long-context audit workload ~30-40%).
Không phù hợp nếu: bạn primary Claude Code và đã quen workflow (cài thêm Codex SEO là duplicate disk space + cognitive load), bạn cần feature mới nhất ngay (Codex port có lag 2-7 ngày), hoặc bạn audit content Vietnamese đặc thù cần E-E-A-T scoring tinh tế (Claude SEO via Sonnet 4.6 vẫn slight edge ở use case này).
Với 164 GitHub stars + 29 forks và phiên bản v1.9.6-codex.5 ship 28/04/2026, Codex SEO là skill SEO production-ready đầu tiên cho Codex CLI ecosystem. Setup 3 phút, audit 4-5 phút mỗi page, deterministic output dùng được cho client deliverable. Bắt đầu với 1 trang quan trọng nhất của bạn, chạy natural language prompt “audit this for technical + content + GEO”, so sánh output với baseline manual của bạn. Nếu top findings catch đúng 70%+ issue bạn đã biết, scale lên cho weekly cluster audit workflow.
Nếu bạn quan tâm full Codex CLI roadmap cho dev Việt 2026, xem Codex CLI là gì + lộ trình master. Còn nếu primary dev của bạn là Claude Code, Claude SEO v1.9.9 là phiên bản upstream với nhiều star hơn (6.934 vs 164) và cộng đồng đông hơn cho tham khảo issue + workflow.
