Skip to main content
plugin CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-seo@awesome-codex-plugins
Open on GitHub

What 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-plugins

Step 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

Similar plugins

All plugins for SEO and GEO →

From the same set391

The whole set →
cometchat-skills Adds CometChat text chat, voice, and video calling skills to React, Angular, React Native, iOS, Android, and Flutter projects using the live Docs MCP. CX Codex ★ 1,596repo stars cohesivity Connect a coding agent to Cohesivity services for hosting, Postgres, email, and more through MCP or an API. CX Codex ★ 1,596repo stars codex-usage-tracker codex-usage-tracker is a Claude Code plugin that reads local Codex session logs for token summaries, session details, CSV exports, and dashboards. CX Codex ★ 1,596repo stars codex-tools-bridge codex-tools-bridge configures an experimental MCP bridge connecting ChatGPT Web to local Codex tools. It helps run local shell commands and edits directly from the web chat without a second model loop. CX Codex ★ 1,596repo stars codex-reset codex-reset is a Claude Code plugin that connects read-only MCP tools for Codex limits. It reports a 24- or 48-hour reset forecast, verified reset records, and service status. CX Codex ★ 1,596repo stars codex-obsidian codex-obsidian connects your agent to local Obsidian vaults via the official desktop CLI. Runs note queries, task rollups, and workspace controls. CX Codex ★ 1,596repo stars codex-mem codex-mem carries compressed project context into later sessions. Use it when you need to pick up work after a session ends or reconnects. CX Codex ★ 1,596repo stars codex-image-plugin codex-image-plugin is a Claude Code plugin for generating and editing raster images through an OpenAI-compatible image API. It supports models, references, and masks. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open