feat: v1.6.0 - local SEO skill, installer fixes, ecosystem cross-linking

- Add seo-local sub-skill (#13) and subagent (#8) for GBP, NAP citations,
  reviews, local schema, and multi-location analysis
- Fix install.ps1 Unicode encoding for Windows PowerShell 5.1 (fixes #20)
- Bump installer version pins from v1.4.0 to v1.6.0 (fixes #25)
- Add extension installation to both installers (dataforseo, banana)
- Add redirect_details with per-hop HTTP status codes to fetch_page.py
- Add ecosystem cross-links to banana-claude and claude-blog repos
- Register seo-local in plugin.json, SKILL.md, and seo-audit spawn list

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: AgriciDaniel

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-seo",
-  "version": "1.5.0",
-  "description": "Comprehensive SEO analysis skill for Claude Code. Covers technical SEO, content quality (E-E-A-T), schema markup, image optimization, sitemap architecture, AI search optimization (GEO), and strategic planning across all industries.",
+  "version": "1.6.0",
+  "description": "Comprehensive SEO analysis skill for Claude Code. Covers technical SEO, content quality (E-E-A-T), schema markup, image optimization, sitemap architecture, AI search optimization (GEO), local SEO (GBP, citations, reviews, map pack), and strategic planning across all industries.",
   "author": "AgriciDaniel",
   "license": "MIT",
   "homepage": "https://github.com/AgriciDaniel/claude-seo",
@@ -20,6 +20,7 @@
     "skills/seo-programmatic/SKILL.md",
     "skills/seo-competitor-pages/SKILL.md",
     "skills/seo-hreflang/SKILL.md",
+    "skills/seo-local/SKILL.md",
     "extensions/dataforseo/skills/seo-dataforseo/SKILL.md",
     "extensions/banana/skills/seo-image-gen/SKILL.md"
   ],
@@ -31,6 +32,7 @@
     "agents/seo-performance.md",
     "agents/seo-visual.md",
     "agents/seo-geo.md",
+    "agents/seo-local.md",
     "extensions/dataforseo/agents/seo-dataforseo.md",
     "extensions/banana/agents/seo-image-gen.md"
   ]

CLAUDE.md

@@ -4,9 +4,10 @@
 
 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). 13 sub-skills, 7 parallel
+3-layer architecture (directive, orchestration, execution). 13 sub-skills, 8 parallel
 subagents, and an extensible reference system cover technical SEO, content quality,
-schema markup, image optimization, sitemap architecture, and AI search optimization.
+schema markup, image optimization, sitemap architecture, AI search optimization,
+and local SEO (GBP, citations, reviews, map pack).
 
 ## Architecture
 
@@ -20,7 +21,7 @@ claude-seo/
   scripts/                           # Python execution scripts
   hooks/                             # Quality gate hooks
   schema/                            # Schema.org JSON-LD templates
-  skills/                            # 12 specialized sub-skills
+  skills/                            # 13 specialized sub-skills
     seo-audit/SKILL.md              # Full site audit with parallel agents
     seo-page/SKILL.md              # Deep single-page analysis
     seo-technical/SKILL.md         # Technical SEO (9 categories)
@@ -29,21 +30,23 @@ claude-seo/
     seo-sitemap/SKILL.md           # XML sitemap analysis/generation
     seo-images/SKILL.md            # Image optimization analysis
     seo-geo/SKILL.md               # AI search / GEO optimization
+    seo-local/SKILL.md             # Local SEO (GBP, citations, reviews, map pack)
     seo-plan/SKILL.md              # Strategic SEO planning
     seo-programmatic/SKILL.md      # Programmatic SEO at scale
     seo-competitor-pages/SKILL.md  # Competitor comparison pages
     seo-hreflang/SKILL.md         # International SEO / hreflang
-  agents/                            # 7 parallel subagents
+  agents/                            # 8 parallel subagents
     seo-technical.md               # Crawlability, indexability, security
     seo-content.md                 # E-E-A-T, readability, thin content
     seo-schema.md                  # Structured data validation
     seo-sitemap.md                 # Sitemap quality gates
     seo-performance.md             # Core Web Vitals, page speed
     seo-visual.md                  # Screenshots, mobile rendering
     seo-geo.md                     # AI crawler access, GEO, citability
+    seo-local.md                   # GBP, NAP, citations, reviews, local schema
   extensions/                          # Optional add-on capabilities
     dataforseo/                    # Live SEO data via DataForSEO MCP
-    banana/                        # AI image generation via Gemini MCP
+    banana/                        # AI image generation via Gemini MCP (see github.com/AgriciDaniel/banana-claude)
   docs/                              # Extended documentation
     ARCHITECTURE.md                # System design overview
     COMMANDS.md                    # Full command reference
@@ -56,7 +59,7 @@ claude-seo/
 
 | Command | Purpose |
 |---------|---------|
-| `/seo audit <url>` | Full site audit with 7 parallel subagents |
+| `/seo audit <url>` | Full site audit with 8 parallel subagents |
 | `/seo page <url>` | Deep single-page analysis |
 | `/seo technical <url>` | Technical SEO audit (9 categories) |
 | `/seo content <url>` | E-E-A-T and content quality analysis |
@@ -67,6 +70,7 @@ claude-seo/
 | `/seo plan <type>` | Strategic SEO planning by industry |
 | `/seo programmatic` | Programmatic SEO analysis and planning |
 | `/seo competitor-pages` | Competitor comparison page generation |
+| `/seo local <url>` | Local SEO analysis (GBP, citations, reviews, map pack) |
 | `/seo hreflang <url>` | International SEO / hreflang audit |
 | `/seo image-gen [use-case] <desc>` | AI image generation for SEO assets (extension) |
 
@@ -80,9 +84,15 @@ claude-seo/
 - Python dependencies install into `~/.claude/skills/seo/.venv/`
 - Test with `python -m pytest tests/` after changes (if applicable)
 
+## Ecosystem
+
+Part of the Claude Code skill family:
+- [Claude Banana](https://github.com/AgriciDaniel/banana-claude) -- standalone image gen (bundled as extension here)
+- [Claude Blog](https://github.com/AgriciDaniel/claude-blog) -- companion blog engine, consumes SEO findings
+
 ## Key Principles
 
 1. **Progressive Disclosure**: Metadata always loaded, instructions on activation, resources on demand
 2. **Industry Detection**: Auto-detect SaaS, e-commerce, local, publisher, agency
-3. **Parallel Execution**: Full audits spawn 7 subagents simultaneously
+3. **Parallel Execution**: Full audits spawn 8 subagents simultaneously
 4. **Extension System**: DataForSEO MCP for live data, Banana MCP for AI image generation

README.md

@@ -2,7 +2,7 @@
 
 ![Claude SEO](screenshots/cover-image.jpeg)
 
-# Claude SEO v1.5.0 -- SEO Audit Skill for Claude Code
+# Claude SEO v1.6.0 -- SEO Audit Skill for Claude Code
 
 Comprehensive SEO analysis skill for Claude Code. Covers technical SEO, on-page analysis, content quality (E-E-A-T), schema markup, image optimization, sitemap architecture, AI search optimization (GEO), and strategic planning.
 
@@ -21,6 +21,7 @@ Comprehensive SEO analysis skill for Claude Code. Covers technical SEO, on-page
 - [Features](#features)
 - [Architecture](#architecture)
 - [Extensions](#extensions)
+- [Ecosystem](#ecosystem)
 - [Documentation](#documentation)
 - [Requirements](#requirements)
 - [Uninstall](#uninstall)
@@ -263,6 +264,42 @@ Live SERP data, keyword research, backlinks, on-page analysis, content analysis,
 
 See [DataForSEO Extension](extensions/dataforseo/README.md) for full documentation.
 
+### Banana (AI Image Generation)
+
+Generate SEO images (OG previews, blog heroes, product photos, infographics) using the
+[Claude Banana](https://github.com/AgriciDaniel/banana-claude) Creative Director pipeline.
+
+```bash
+# Install extension
+./extensions/banana/install.sh
+```
+
+```bash
+# Example commands
+/seo image-gen og "Professional SaaS dashboard"
+/seo image-gen hero "AI-powered content creation"
+/seo image-gen batch "Product photography" 3
+```
+
+See [Banana Extension](extensions/banana/README.md) for full documentation.
+Already using standalone Claude Banana? The extension reuses your existing nanobanana-mcp setup.
+
+## Ecosystem
+
+Claude SEO is part of a family of Claude Code skills that work together:
+
+| Skill | What it does | How it connects |
+|-------|-------------|-----------------|
+| [Claude SEO](https://github.com/AgriciDaniel/claude-seo) | SEO analysis, audits, schema, GEO | Core -- analyzes sites, generates action plans |
+| [Claude Blog](https://github.com/AgriciDaniel/claude-blog) | Blog writing, optimization, scoring | Companion -- write content optimized by SEO findings |
+| [Claude Banana](https://github.com/AgriciDaniel/banana-claude) | AI image generation via Gemini | Shared -- generates images for SEO assets and blog posts |
+
+**Workflow example:**
+1. `/seo audit https://example.com` -- identify content gaps and image issues
+2. `/blog write "target keyword"` -- create SEO-optimized blog posts
+3. `/seo image-gen hero "blog topic"` -- generate hero images (banana extension)
+4. `/seo geo https://example.com/blog/post` -- optimize for AI citations
+
 ## Documentation
 
 - [Installation Guide](docs/INSTALLATION.md)

agents/seo-local.md

@@ -0,0 +1,76 @@
+---
+name: seo-local
+description: Local SEO specialist. Analyzes GBP signals, NAP consistency, citations, reviews, local schema, location page quality, and industry-specific local factors for brick-and-mortar, SAB, and multi-location businesses.
+tools: Read, Bash, WebFetch, Glob, Grep, Write
+---
+
+You are a Local SEO specialist. When given a URL:
+
+1. Fetch the page and detect business type (brick-and-mortar, SAB, or hybrid) from address visibility, service area language, and Maps embeds
+2. Detect industry vertical (restaurant, healthcare, legal, home services, real estate, automotive) from page content signals
+3. Extract NAP (Name, Address, Phone) from visible HTML, JSON-LD schema, and meta tags -- flag any discrepancies between sources
+4. Validate LocalBusiness schema: correct industry subtype, required properties (name, address), recommended properties (geo with 5 decimal precision, openingHoursSpecification, telephone, url)
+5. Check for GBP signals on page (Maps embed, place references, review widgets, posts indicators, photo evidence)
+6. Assess review health from visible data (rating, count, aggregateRating in schema, response patterns)
+7. Check citation presence on Tier 1 directories (Yelp, BBB via site: search patterns or direct fetch)
+8. Evaluate location page quality for multi-location sites (unique content %, doorway page swap test, internal linking depth)
+
+## Local SEO Score (0-100)
+
+| Dimension | Weight |
+|-----------|--------|
+| GBP Signals | 25% |
+| Reviews & Reputation | 20% |
+| Local On-Page SEO | 20% |
+| NAP Consistency & Citations | 15% |
+| Local Schema Markup | 10% |
+| Local Link & Authority Signals | 10% |
+
+## Key Detection Signals
+
+**Business type:**
+- Brick-and-mortar: visible street address, Maps embed, directions link
+- SAB: no visible address, "serving [area]", "we come to you"
+- Hybrid: both address and service area present
+
+**Industry vertical:**
+- Restaurant: /menu, cuisine types, reservations, food ordering
+- Healthcare: insurance, NPI, "Dr.", HIPAA notice, appointments
+- Legal: attorney, practice areas, bar admission, case results
+- Home Services: service area, emergency, estimates, licensed/insured
+- Real Estate: listings, MLS, agent bio, brokerage, open house
+- Automotive: inventory, VIN, dealership, service department
+
+## Critical Ranking Factors (Whitespark 2026)
+
+- Primary GBP category: **#1 factor** (score: 193). Wrong category = **#1 negative factor** (score: 176)
+- Review velocity: **18-day rule** -- rankings cliff if no reviews for 3 weeks (Sterling Sky)
+- Dedicated service pages: **#1 local organic factor, #2 AI visibility factor**
+- 3 of top 5 AI visibility factors are citation-related
+- Proximity accounts for 55.2% of ranking variance (Search Atlas ML study) -- outside our control, note in report
+
+## Industry-Specific Checks
+
+Load `seo/references/local-schema-types.md` for:
+- Correct schema subtype per vertical (e.g., `Restaurant` not `LocalBusiness`, `LegalService` not deprecated `Attorney`)
+- Industry-specific citation source recommendations
+- Schema pattern templates (Menu for restaurants, Physician for healthcare, etc.)
+
+## DataForSEO Integration (Optional)
+
+If DataForSEO MCP tools are available, use `local_business_data` for live GBP data and `google_local_pack_serp` for real-time local pack positions.
+
+## Output Format
+
+Provide a structured report with:
+- Local SEO Score (0-100) with dimension breakdown
+- Business type detected (brick-and-mortar / SAB / hybrid)
+- Industry vertical detected with industry-specific findings
+- NAP consistency audit (source comparison table)
+- GBP optimization checklist (detected vs missing)
+- Review health snapshot (rating, count, velocity, response rate)
+- Citation presence status (Tier 1 directories)
+- Local schema validation (correct subtype, property completeness)
+- Location page quality (if multi-location)
+- Top 10 prioritized actions (Critical > High > Medium > Low)
+- Limitations disclaimer (what could not be assessed without paid tools)

extensions/banana/README.md

@@ -6,6 +6,9 @@ banana Creative Director pipeline.
 
 ## Prerequisites
 
+> This extension wraps [Claude Banana](https://github.com/AgriciDaniel/banana-claude)
+> for SEO-specific use cases. Install the standalone skill for general-purpose image generation.
+
 - **Claude SEO** installed (`~/.claude/skills/seo/`)
 - **Node.js 18+** with npx
 - **Google AI API key** (free at [aistudio.google.com/apikey](https://aistudio.google.com/apikey))
@@ -83,7 +86,7 @@ The agent never auto-generates images. It produces a plan for your review.
 ./extensions/banana/uninstall.sh
 ```
 
-This removes the skill and agent. If you also use the standalone banana skill,
+This removes the skill and agent. If you also use [Claude Banana](https://github.com/AgriciDaniel/banana-claude),
 the MCP server config is preserved.
 
 ## Troubleshooting

extensions/banana/skills/seo-image-gen/SKILL.md

@@ -20,6 +20,9 @@ aspect ratios, and resolution defaults.
 
 ## Architecture Note
 
+This extension is built on [Claude Banana](https://github.com/AgriciDaniel/banana-claude),
+the standalone AI image generation skill for Claude Code.
+
 This skill has two components with distinct roles:
 - **SKILL.md** (this file): Handles interactive `/seo image-gen` commands for generating images
 - **Agent** (`agents/seo-image-gen.md`): Audit-only analyst spawned during `/seo audit` to assess existing OG/social images and produce a generation plan (never auto-generates)