claude-seo-kit 🤖🔍

Claude SEO Skills — production Claude Agent Skills for SEO, powered by a standalone Python engine (no API keys, no paywalls, one dependency).

Install as a Claude Code plugin and audit any URL for technical SEO, content quality & E-E-A-T, Schema.org structured data, sitemaps, hreflang, and GEO (AI-search readiness) — with a 0-100 score, A-F grade, and prioritized fixes.

Credits: This is an original implementation — no code was copied — inspired by two pioneering open-source projects:

• AgriciDaniel/claude-seo (12.9K⭐, MIT) — the Claude Code SEO plugin that popularized SEO-as-an-agent-skill.

• seranking/seo-skills (108⭐, MIT) — production Claude Agent Skills for the SE Ranking MCP server.

Unlike both, claude-seo-kit needs no API account: every skill is backed by a dependency-light Python engine that fetches and analyzes pages directly. It also works as a standalone CLI and an MCP server.

Why claude-seo-kit?

Most SEO agent tools either require a paid API (SE Ranking, DataForSEO, Ahrefs), are locked to one CLI ecosystem, or ship no real engine at all. claude-seo-kit fixes all three:

Related MCP server: mcp-seo-auditor

Install

1. Claude Code plugin (recommended)

/plugin marketplace add FreeAutomation-Tech/claude-seo-kit
/plugin install claude-seo-kit@FreeAutomation-Tech

Skills load on your next session. Trigger by name — /seo-audit <url> — or just describe what you want ("audit example.com") and Claude picks the right skill.

2. Manual install (copy skills into Claude Code)

git clone https://github.com/FreeAutomation-Tech/claude-seo-kit.git
cd claude-seo-kit
bash install.sh          # copies skills/ to ~/.claude/skills/
pip install -r requirements.txt

3. As a Python package

pip install -e .
claude-seo-kit https://example.com --format json

Skills

Each skill is a single SKILL.md with YAML frontmatter (Anthropic's progressive disclosure pattern) that tells Claude when to use it and exactly how to run the engine.

The engine

A dependency-light Python package (seo_kit) with everything the skills call:

Technical SEO (seo_kit.technical)

• Title, meta description, canonical, H1, robots, viewport, alt text, links, thin content, lang, favicon

• robots.txt + XML sitemap health (seo_kit.crawler.sitemap)

• hreflang / international tag validation (seo_kit.technical.hreflang)

Content & E-E-A-T (seo_kit.content)

• Word count, heading hierarchy, Flesch readability, keyword density, E-E-A-T signals

• GEO / AI-search citability (seo_kit.content.geo)

Structured data (seo_kit.schema)

• JSON-LD extraction, type coverage (Organization, WebSite, Article, Product, FAQ...), required-field completeness

Interfaces

• CLI — python -m seo_kit.cli <url> --format json|markdown

• Python API — from seo_kit.cli import audit_url

• MCP server — python -m seo_kit.mcp.server exposes seo_audit, seo_audit_full, seo_technical_check, seo_content_check, seo_sitemap_check, seo_hreflang_check, seo_geo_check

• Skills — the Claude Code skills above

Quick start

pip install -r requirements.txt

# Full audit (markdown report)
python -m seo_kit.cli https://example.com --format markdown --output report.md

# Full audit (JSON for pipelines / agents)
python -m seo_kit.cli https://example.com --format json

# Standalone checks
python -m seo_kit.crawler.sitemap https://example.com
python -m seo_kit.technical.hreflang https://example.com
python -m seo_kit.content.geo https://example.com

# MCP server
pip install mcp && python -m seo_kit.mcp.server

Python API

from seo_kit.cli import audit_url
from seo_kit.reports.markdown import render_markdown

result = audit_url("https://example.com")
print(f"Score: {result.overall_score}/100 — Grade {result.grade}")
print(render_markdown(result, "https://example.com"))

Example report

# SEO Audit Report — https://example.com

**Overall Score: 72/100 — Grade 🟡 C**

| Category | Score |
|----------|-------|
| Technical | 68/100 |
| Content   | 75/100 |
| Schema    | 80/100 |

Every report ends with a prioritized recommendations list ordered error → warning → info, plus per-category details.

Roadmap

• Site-wide crawling (multi-page audit with weighted scoring)

• Core Web Vitals via Lighthouse API

• Optional data providers (SE Ranking / DataForSEO adapters)

• Schema.org generator (draft valid JSON-LD from the CLI)

• Image SEO audit (srcset, WebP/AVIF, lazy-loading)

Credits & Inspiration

This project is an original implementation — no code was copied — but the concept is heavily inspired by:

• AgriciDaniel/claude-seo (MIT) — the Claude Code SEO plugin with 25 sub-skills, 18 sub-agents, and 410+ tests. Star it: ⭐ github.com/AgriciDaniel/claude-seo

• seranking/seo-skills (MIT) — production Claude Agent Skills for the SE Ranking MCP server. Star it: ⭐ github.com/seranking/seo-skills

Ecosystem

Part of the FreeAutomation-Tech AI tooling family:

License

MIT

If you find this useful, please consider giving it a star ⭐ — it helps others discover free, open-source AI tooling and keeps us building more.

Made with ❤️ by FreeAutomation-Tech