codex-seo — Claude Code plugin: SEO audits and installation
The codex-seo plugin for Claude Code and Codex runs site-wide or focused SEO checks on pages, technical issues, content, and backlinks.
MIT ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-seo@awesome-codex-pluginsWhat codex-seo does
codex-seo runs specialist agents for full-site audits and page-level analysis. Its checks cover technical SEO, content, schema, sitemaps, images, GEO, local SEO, maps, hreflang, and backlinks. Use the /seo entrypoint with a subcommand such as technical or backlinks to focus a request.
Google-related workflows include PageSpeed, CrUX, Search Console, Indexing, and GA4. Python utilities handle tasks such as generating PDF and HTML reports with scripts/google_report.py. Optional extensions add DataForSEO, Firecrawl, and image generation; without an extension, local scripts and static analysis are used where possible. In Claude Code, install the plugin through its marketplace.
What it helps with
- Run a full SEO audit of a website
- Find technical SEO issues on a page
- Check a site's schema markup
- Review a site's backlinks
- Create a report from Google API workflows
Example prompts for the agent
- Run a full SEO audit for https://example.com with
/seo audit. - Check this page's technical SEO with
/seo technical. - Analyze the site's backlinks with
/seo backlinks.
How to install codex-seo
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install codex-seo@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about codex-seo
How do I install codex-seo in Claude Code?
Run these commands in order: /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install codex-seo@awesome-codex-plugins.
What does codex-seo do?
It audits websites and pages across areas such as technical SEO, content, schema, and backlinks. It also includes Google API workflows and PDF and HTML report generation.
Which extensions can I add to codex-seo?
Optional installers configure DataForSEO, Firecrawl, and image-generation extensions. When no extension is configured, the plugin uses local scripts and static analysis where possible.
Source text
codex-seo · MIT
# Codex SEO [中文说明](./README.zh-CN.md) Codex SEO is a Codex-native SEO analysis plugin with slash-friendly entrypoints, specialist agents, Python execution utilities, and optional MCP-backed extensions. This public repository is a standalone Codex adaptation of the original [AgriciDaniel/claude-seo](https://github.com/AgriciDaniel/claude-seo). The goal is to preserve the original SEO capability set while shipping it in a cleaner Codex-first layout for local installation, testing, and public distribution. ## Features - Full-site audits with parallel specialist agents - Deep analysis for pages, technical SEO, content, schema, sitemaps, images, GEO, local SEO, maps, hreflang, and backlinks - Google API workflows for PageSpeed, CrUX, Search Console, Indexing, and GA4 - Optional MCP-backed extensions for DataForSEO, Firecrawl, and image generation - PDF and HTML report generation through `scripts/google_report.py` ## Invocation The main skill name is `seo`. Use whichever Codex entrypoint is available: - Slash command: `/seo audit https://example.com` - Explicit skill call: `$seo audit https://example.com` - Natural language: `Run a full SEO audit for https://example.com` Core subcommands: - `audit` - `page` - `technical` - `content` - `schema` - `sitemap` - `images` - `geo` - `local` - `maps` - `hreflang` - `google` - `backlinks` - `dataforseo` - `firecrawl` - `image-gen` ## Repository Layout ```text codex-seo/ .codex-plugin/plugin.json .agents/plugins/marketplace.json .mcp.json skills/ agents/ scripts/ extensions/ docs/ schema/ hooks/ ``` ## Install ```bash git clone https://github.com/BestLemoon/codex-seo.git cd codex-seo ./install.sh ``` Windows: ```powershell git clone https://github.com/BestLemoon/codex-seo.git cd codex-seo .\install.ps1 ``` The installer copies the plugin into `~/plugins/codex-seo`, updates `~/.agents/plugins/marketplace.json`, and creates a local virtual environment for the Python utilities. More detail: [docs/INSTALLATION.md](./docs/INSTALLATION.md) ## Extensions Optional extension installers configure the plugin-local `.mcp.json` instead of writing to a global assistant configuration: - `./extensions/dataforseo/install.sh` - `./extensions/firecrawl/install.sh` - `./extensions/banana/install.sh` If no extension is configured, Codex SEO falls back to local scripts and static analysis where possible. ## Verification Useful smoke checks: ```bash python3 scripts/install_plugin.py --help python3 scripts/configure_mcp.py --help python3 scripts/google_auth.py --help python3 scripts/backlinks_auth.py --help python3 scripts/google_report.py --help ``` ## Credits - Adapted from [AgriciDaniel/claude-seo](https://github.com/AgriciDaniel/claude-seo) - Original concepts and much of the SEO methodology come from the upstream project - Repo-specific attribution details live in [NOTICE.md](./NOTICE.md)
© BestLemoon · MIT · hashgraph-online/awesome-codex-plugins