Skip to content

Universal SEO skill for Claude Code. 26 sub-skills + 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.

fix: repo audit — version sync, doc drift, CI coverage, privacy disclosures

Danielfe1d0628847f
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 072776a..45a263e 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -35,4 +35,10 @@ jobs:
python3 -m py_compile scripts/youtube_search.py
python3 -m py_compile scripts/nlp_analyze.py
python3 -m py_compile scripts/keyword_planner.py
- echo "All 15 scripts passed syntax check"
+ python3 -m py_compile scripts/backlinks_auth.py
+ python3 -m py_compile scripts/moz_api.py
+ python3 -m py_compile scripts/bing_webmaster.py
+ python3 -m py_compile scripts/commoncrawl_graph.py
+ python3 -m py_compile scripts/verify_backlinks.py
+ python3 -m py_compile scripts/validate_backlink_report.py
+ echo "All 21 scripts passed syntax check"
diff --git a/CITATION.cff b/CITATION.cff
index 7a99523..9fb7724 100644
--- a/CITATION.cff
+++ b/CITATION.cff
@@ -8,8 +8,8 @@ authors:
repository-code: 'https://github.com/AgriciDaniel/claude-seo'
url: 'https://github.com/AgriciDaniel/claude-seo'
license: MIT
-version: 1.7.2
-date-released: '2026-03-30'
+version: 1.8.1
+date-released: '2026-04-06'
keywords:
- seo
- claude-code
diff --git a/CLAUDE.md b/CLAUDE.md
index 63054bd..2b804be 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -4,7 +4,7 @@
This repository contains **Claude SEO**, a Tier 4 Claude Code skill for comprehensive
SEO analysis across all industries. It follows the Agent Skills open standard and the
-3-layer architecture (directive, orchestration, execution). 17 core sub-skills (+ 3
+3-layer architecture (directive, orchestration, execution). 16 core sub-skills (+ 3
extensions), 11 core subagents (+ 2 extension agents, 13 total), and an extensible reference
system cover technical SEO, content quality,
schema markup, image optimization, sitemap architecture, AI search optimization,
@@ -61,7 +61,7 @@ claude-seo/
seo-image-gen.md # SEO image audit analyst
hooks/ # Quality gate hooks
hooks.json # PostToolUse schema validation
- scripts/ # Python execution scripts (20 tracked + 2 dev-only)
+ scripts/ # Python execution scripts (21 tracked + 2 dev-only)
google_auth.py # Credential management (OAuth, SA, API key, 4-tier detection)
backlinks_auth.py # Backlink API credential management (Moz, Bing)
moz_api.py # Moz Link Explorer API (DA/PA, spam, domains, anchors)
diff --git a/PRIVACY.md b/PRIVACY.md
index 29bf28d..8b409e3 100644
--- a/PRIVACY.md
+++ b/PRIVACY.md
@@ -21,6 +21,17 @@ Optional extensions make API calls to third-party services when you invoke their
| **Firecrawl** | api.firecrawl.dev | URLs you crawl or scrape | [Firecrawl Privacy](https://www.firecrawl.dev/privacy) |
| **Banana (Gemini)** | generativelanguage.googleapis.com | Image generation prompts | [Google AI Privacy](https://ai.google.dev/terms) |
+## Backlink APIs
+
+When configured with backlink API credentials, these scripts transmit data to third-party services:
+
+| Script | Service | Data Sent | Privacy Policy |
+|--------|---------|-----------|---------------|
+| `moz_api.py` | Moz Link Explorer API | Domains you analyze | [Moz Privacy](https://moz.com/privacy-policy) |
+| `bing_webmaster.py` | Bing Webmaster Tools API | Domains you analyze | [Microsoft Privacy](https://privacy.microsoft.com/) |
+| `commoncrawl_graph.py` | Common Crawl | Domains (public dataset query) | [Common Crawl Terms](https://commoncrawl.org/terms-of-use) |
+| `verify_backlinks.py` | Target URLs directly | URLs to verify backlink existence | N/A (direct HTTP requests) |
+
## Google SEO APIs
When configured with Google API credentials, these scripts transmit data to Google:
diff --git a/README.md b/README.md
index 37bba52..566f765 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-<!-- Updated: 2026-03-28 -->
+<!-- Updated: 2026-04-10 -->
![Claude SEO](screenshots/cover-image.jpeg)
@@ -130,6 +130,10 @@ claude
| `/seo hreflang <url>` | Hreflang/i18n SEO audit and generation |
| `/seo google [command] [url]` | Google SEO APIs (GSC, PageSpeed, CrUX, Indexing, GA4) |
| `/seo google report [type]` | Generate PDF/HTML report with charts (cwv-audit, gsc-performance, full) |
+| `/seo backlinks <url>` | Backlink profile analysis (free: Moz, Bing, Common Crawl) |
+| `/seo firecrawl [command] <url>` | Full-site crawling and site mapping (extension) |
+| `/seo dataforseo [command]` | Live SEO data via DataForSEO (extension) |
+| `/seo image-gen [use-case] <desc>` | AI image generation for SEO assets (extension) |
### `/seo programmatic [url|plan]`
**Programmatic SEO Analysis & Planning**
@@ -231,8 +235,8 @@ Direct integration with Google's SEO data:
```
~/.claude/skills/seo/ # Main orchestrator skill
-~/.claude/skills/seo-*/ # Sub-skills (16 + 2 extensions)
-~/.claude/agents/seo-*.md # Subagents (10 + 2 extensions)
+~/.claude/skills/seo-*/ # Sub-skills (16 + 3 extensions)
+~/.claude/agents/seo-*.md # Subagents (11 + 2 extensions)
```
### Video & Live Schema (New)
@@ -323,6 +327,23 @@ Generate SEO images (OG previews, blog heroes, product photos, infographics) usi
See [Banana Extension](extensions/banana/README.md) for full documentation.
Already using standalone Claude Banana? The extension reuses your existing nanobanana-mcp setup.
+### Firecrawl (Site Crawling)
+
+Full-site crawling and URL discovery using the [Firecrawl](https://www.firecrawl.dev/) MCP server.
+
+```bash
+# Install extension
+./extensions/firecrawl/install.sh
+```
+
+```bash
+# Example commands
+/seo firecrawl crawl https://example.com
+/seo firecrawl map https://example.com
+```
+
+See [Firecrawl Extension](extensions/firecrawl/README.md) for full documentation.
+
## Ecosystem
Claude SEO is part of a family of Claude Code skills that work together:
diff --git a/docs/INSTALLATION.md b/docs/INSTALLATION.md
index 248a9ba..deb67e4 100644
--- a/docs/INSTALLATION.md
+++ b/docs/INSTALLATION.md
@@ -20,7 +20,9 @@ curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/instal
### Windows (PowerShell)
```powershell
-irm https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.ps1 | iex
+git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
+cd claude-seo
+powershell -ExecutionPolicy Bypass -File install.ps1
```
## Manual Installation
@@ -96,11 +98,17 @@ Or manually:
```bash
rm -rf ~/.claude/skills/seo
rm -rf ~/.claude/skills/seo-audit
+rm -rf ~/.claude/skills/seo-backlinks
rm -rf ~/.claude/skills/seo-competitor-pages
rm -rf ~/.claude/skills/seo-content
+rm -rf ~/.claude/skills/seo-dataforseo
rm -rf ~/.claude/skills/seo-geo
+rm -rf ~/.claude/skills/seo-google
rm -rf ~/.claude/skills/seo-hreflang
+rm -rf ~/.claude/skills/seo-image-gen
rm -rf ~/.claude/skills/seo-images
+rm -rf ~/.claude/skills/seo-local
+rm -rf ~/.claude/skills/seo-maps
rm -rf ~/.claude/skills/seo-page
rm -rf ~/.claude/skills/seo-plan
rm -rf ~/.claude/skills/seo-programmatic
diff --git a/install.ps1 b/install.ps1
index df1dac8..d55b973 100644
--- a/install.ps1
+++ b/install.ps1
@@ -87,7 +87,7 @@ $AgentDir = "$env:USERPROFILE\.claude\agents"
$RepoUrl = "https://github.com/AgriciDaniel/claude-seo"
# Pin to a specific release tag to prevent silent updates from main.
# Override: $env:CLAUDE_SEO_TAG = 'main'; .\install.ps1
-$RepoTag = if ($env:CLAUDE_SEO_TAG) { $env:CLAUDE_SEO_TAG } else { 'v1.7.2' }
+$RepoTag = if ($env:CLAUDE_SEO_TAG) { $env:CLAUDE_SEO_TAG } else { 'v1.8.1' }
# Create directories
New-Item -ItemType Directory -Force -Path $SkillDir | Out-Null
diff --git a/install.sh b/install.sh
index 438f7bb..10cdfcf 100755
--- a/install.sh
+++ b/install.sh
@@ -10,7 +10,7 @@ main() {
REPO_URL="https://github.com/AgriciDaniel/claude-seo"
# Pin to a specific release tag to prevent silent updates from main.
# Override: CLAUDE_SEO_TAG=main bash install.sh
- REPO_TAG="${CLAUDE_SEO_TAG:-v1.7.2}"
+ REPO_TAG="${CLAUDE_SEO_TAG:-v1.8.1}"
echo "════════════════════════════════════════"
echo "║ Claude SEO - Installer ║"
diff --git a/pyproject.toml b/pyproject.toml
index 694e6c4..f0b7ce2 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,8 +1,8 @@
[project]
name = "claude-seo"
-version = "1.7.2"
+version = "1.8.1"
description = "Comprehensive SEO analysis skill for Claude Code"
-requires-python = ">=3.11"
+requires-python = ">=3.10"
license = "MIT"
readme = "README.md"
diff --git a/skills/seo/SKILL.md b/skills/seo/SKILL.md
index 7af794a..318acfa 100644
--- a/skills/seo/SKILL.md
+++ b/skills/seo/SKILL.md
@@ -116,7 +116,7 @@ Weighted aggregate of all categories:
## Sub-Skills
-This skill orchestrates 15 specialized sub-skills (+ 2 extensions):
+This skill orchestrates 16 specialized sub-skills (+ 3 extensions):
1. **seo-audit** -- Full website audit with parallel delegation
2. **seo-page** -- Deep single-page analysis