Claude SEO

Install

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup

This is third-party code. Review the repository files before installing.

What it does

The plugin runs 25 skills and 18 specialist agents to analyze a site: Core Web Vitals, content quality, Schema.org markup, local SEO, e-commerce, international SEO and AI search optimization. A full /seo audit fans out to parallel agents and produces markdown reports and a PDF with a prioritized plan. SPAs are rendered headlessly with Playwright. Google API data and services like Ahrefs are optional via credential tiers and MCP extensions.

Who it is for. SEO agencies, in-house SEO leads and freelance consultants working in Claude Code.

Example request

/seo audit https://example.com and build a prioritized fix plan

Limitations

Without Google credentials Core Web Vitals are lab estimates only. Pages with scroll-tied hydration give noisy findings. Requires Python 3.10+ and Claude Code, and Playwright Chromium is needed for SPAs and screenshots.

How to disable. Run uninstall.sh from a cloned repo: git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git and bash claude-seo/uninstall.sh.

Security check

• The installer sets up a Python env and the Chromium browser
• Stores Google API credentials in ~/.config/claude-seo
• Makes network requests to audited sites

README in short

Claude SEO is an open-source MIT plugin for SEO analysis in Claude Code. The README covers installation via the marketplace or a script, 32 /seo commands, and checks for Core Web Vitals, E-E-A-T, schema and AI search. The methodology requires a failure check and a leading indicator for each recommendation. Limitations, requirements and a frequent release history are listed too.

SKILL.md

---
name: seo-ahrefs
description: Ahrefs API analyst (extension). Reads referring domains, backlinks, organic keywords, and content explorer data via the tested @ahrefs/mcp@0.0.11 server. Pairs with seo-backlinks for multi-source confidence weighting.
metadata:
  version: "2.3.1"
compatibility: "Tested with @ahrefs/mcp@0.0.11 (installed by extensions/ahrefs/install.sh)."
---

# seo-ahrefs

Live Ahrefs data via the tested `@ahrefs/mcp@0.0.11` server.
Package check (2026-07-10): verify the current Ahrefs MCP package source before changing this tested version.

## Prerequisites

- Run `extensions/ahrefs/install.sh` (Linux/macOS) or `install.ps1` (Windows) before using this skill.
- An Ahrefs API token (https://ahrefs.com/api).
- Node 18+ on `$PATH` for the MCP server.

Before calling any Ahrefs tool, verify the MCP is connected by checking
that any Ahrefs MCP tool is available in this session. If tools are
not available, tell the user the extension is not installed and
provide the install command above.

## Routing

| Command | Action |
|---|---|
| `/seo ahrefs metrics <url>` | Domain / URL rating, referring domain count, organic traffic estimate |
| `/seo ahrefs backlinks <url>` | Top referring domains, anchor distribution, follow/nofollow ratio |
| `/seo ahrefs organic <url>` | Organic keywords, ranking distribution, traffic by country |
| `/seo ahrefs content <topic>` | Content Explorer top results, social shares, referring domains |

## Output conventions

- Cite the data source on every metric: "Ahrefs (live, confidence 1.00)".
- When Ahrefs and Moz disagree on the same metric, trust Ahrefs and note the discrepancy in the report.
- Toxic link assessment: combine Ahrefs backlink quality signals with the existing seo-backlinks Common Crawl + verify crawler signals.

## Cross-skill delegation

- For multi-source confidence weighting across Moz + Bing + Common Crawl + Ahrefs, hand back to `seo-backlinks`.
- For SERP-feature analysis where Ahrefs and DataForSEO overlap, prefer DataForSEO for live SERP data.

## Cost guardrails

Ahrefs API usage is metered per unit. Before running a batch (>= 50 URLs):

1. Estimate cost with `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py` (the cost-tracker module is generic and supports Ahrefs unit accounting).
2. Surface the estimate to the orchestrator.
3. Log actual cost after each call.

This is the same workflow the seo-dataforseo skill uses.

Related