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.ymlindex 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.pypython3 -m py_compile scripts/nlp_analyze.pypython3 -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.cffindex 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-codediff --git a/CLAUDE.md b/CLAUDE.mdindex 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 comprehensiveSEO 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 (+ 3extensions), 11 core subagents (+ 2 extension agents, 13 total), and an extensible referencesystem 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 analysthooks/ # Quality gate hookshooks.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.mdindex 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 APIsWhen configured with Google API credentials, these scripts transmit data to Google:diff --git a/README.md b/README.mdindex 37bba52..566f765 100644--- a/README.md+++ b/README.md@@ -1,4 +1,4 @@-<!-- Updated: 2026-03-28 -->+<!-- Updated: 2026-04-10 -->@@ -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) usiSee [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.+## EcosystemClaude SEO is part of a family of Claude Code skills that work together:diff --git a/docs/INSTALLATION.md b/docs/INSTALLATION.mdindex 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:```bashrm -rf ~/.claude/skills/seorm -rf ~/.claude/skills/seo-audit+rm -rf ~/.claude/skills/seo-backlinksrm -rf ~/.claude/skills/seo-competitor-pagesrm -rf ~/.claude/skills/seo-content+rm -rf ~/.claude/skills/seo-dataforseorm -rf ~/.claude/skills/seo-geo+rm -rf ~/.claude/skills/seo-googlerm -rf ~/.claude/skills/seo-hreflang+rm -rf ~/.claude/skills/seo-image-genrm -rf ~/.claude/skills/seo-images+rm -rf ~/.claude/skills/seo-local+rm -rf ~/.claude/skills/seo-mapsrm -rf ~/.claude/skills/seo-pagerm -rf ~/.claude/skills/seo-planrm -rf ~/.claude/skills/seo-programmaticdiff --git a/install.ps1 b/install.ps1index 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 directoriesNew-Item -ItemType Directory -Force -Path $SkillDir | Out-Nulldiff --git a/install.sh b/install.shindex 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.tomlindex 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.mdindex 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 delegation2. **seo-page** -- Deep single-page analysis