{
  "markdown": "# Local SEO Audit System\n\n> The most comprehensive local business SEO audit plugin for Claude Code — 21 phases, 27 skills, 40 commands, proprietary scoring frameworks, and professional PDF reports.\n\n[![Claude Code Plugin](https://img.shields.io/badge/Claude_Code-Plugin-5A67D8)](https://claude.com/claude-code)\n[![skills.sh](https://img.shields.io/badge/skills.sh-27_Skills-000000)](https://skills.sh)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![LOCAL-IMPACT Framework](https://img.shields.io/badge/LOCAL--IMPACT-60_Items-1E3A5F)](references/local-impact-benchmark.md)\n[![SERP-TRUST Framework](https://img.shields.io/badge/SERP--TRUST-50_Items-059669)](references/serp-trust-benchmark.md)\n\n---\n\n## What Makes This Different\n\n| Feature | This Plugin | Typical SEO Tools |\n|---------|------------|-------------------|\n| Audit depth | 21 phases, 500+ checkpoints | 5-10 surface checks |\n| Scoring | Proprietary LOCAL-IMPACT (60 items) + SERP-TRUST (50 items) | Generic scores |\n| AI visibility | Checks ChatGPT, Perplexity, Gemini, AI Overviews | Not covered |\n| Output | Professional PDF with SVG gauges + action roadmaps | Basic reports |\n| Competitor analysis | 9-dimension deep analysis per competitor | Basic comparison |\n| Cost | Free & open source | $100-500/month |\n\n---\n\n## Features\n\n- **21 Audit Phases** covering every dimension of local SEO\n- **27 Skills** that activate automatically based on context\n- **40 Slash Commands** for targeted audit phases and utility tools\n- **6 Sub-Agents** for parallel audit execution\n- **Proprietary Scoring Frameworks**:\n  - **LOCAL-IMPACT** — 60-item local presence assessment (0-100)\n  - **SERP-TRUST** — 50-item search trust assessment (0-100)\n  - **SEO Health Index** — Combined weighted score\n- **Competitor Analysis** across 9 dimensions with scoring\n- **AI Visibility Auditing** — AI Overviews, ChatGPT, Perplexity, Gemini, Claude, Copilot\n- **Content, Keyword & Topical Gap Analysis** with prioritized roadmaps\n- **Professional PDF Reports** — SVG score gauges, color-coded issue cards, competitor charts, timeline roadmaps (zero dependencies)\n- **Inter-Skill Handoff** — Skills produce/consume structured data for seamless multi-phase audits\n- **Quality Gates** ensuring every recommendation is specific, actionable, and prioritized\n- **Tool-Agnostic Connectors** — Works standalone, enhances with MCP integrations\n\n---\n\n## Quick Start\n\n### 1. Install\n\n```bash\n# Claude Code — from Marketplace\nclaude plugin install local-seo-audit\n\n# Claude Code — from GitHub (self-hosted)\nclaude plugin install local-seo-audit@mshahiddigital-seo-tools\n\n# Claude Code — Manual / Local\ngit clone https://github.com/mshahiddigital/local-seo-audit.git\nclaude --plugin-dir ./local-seo-audit\n\n# Claude Cowork — .plugin file (drag-and-drop)\n# Build the .plugin package first:\nzip -r local-seo-audit.plugin . \\\n  -x '*.DS_Store' -x '__pycache__/*' -x 'projects/*' -x '.git/*' \\\n  -x 'plugin-audit-report/*' -x 'auto-research-plan.md'\n# Then drag local-seo-audit.plugin into Claude Cowork to install\n\n# skills.sh (Vercel) — install all 27 skills\nnpx skills add mshahiddigital/local-seo-audit\n\n# skills.sh — install a single skill\nnpx skills add mshahiddigital/local-seo-audit --skill technical-seo\n\n# skills.sh — list all available skills\nnpx skills add mshahiddigital/local-seo-audit --list\n```\n\n### 2. Run Your First Audit\n\n```\n/local-seo-audit:seo-audit https://example.com\n```\n\n### 3. Get Your Score\n\n```\n/local-seo-audit:score-local-impact\n/local-seo-audit:score-serp-trust\n```\n\n### 4. Generate PDF Report\n\n```\n/local-seo-audit:generate-pdf\n```\n\n### Scope Options\n\n```bash\nclaude plugin install local-seo-audit --scope user      # Available everywhere\nclaude plugin install local-seo-audit --scope project   # Shared via git\nclaude plugin install local-seo-audit --scope local     # Local only\n```\n\n---\n\n## Audit Methodology\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                    AUDIT WORKFLOW                            │\n├─────────────────────────────────────────────────────────────┤\n│                                                             │\n│  Wave 1: Foundation                                         │\n│  ┌──────────┐  ┌──────────────────┐  ┌──────────────┐      │\n│  │ Intake   │→ │ Competitor       │→ │ Penalty      │      │\n│  │ Form     │  │ Analysis (×3-5)  │  │ Check        │      │\n│  └──────────┘  └──────────────────┘  └──────────────┘      │\n│                                                             │\n│  Wave 2: Technical + Content (parallel)                     │\n│  ┌────────────┐ ┌──────────┐ ┌─────────┐ ┌──────────┐     │\n│  │ Technical  │ │ On-Page  │ │ Content │ │ Speed    │     │\n│  │ SEO       │ │ SEO      │ │ Audit   │ │ Optimize │     │\n│  └────────────┘ └──────────┘ └─────────┘ └──────────┘     │\n│                                                             │\n│  Wave 3: Gap Analysis                                       │\n│  ┌──────────┐  ┌──────────┐  ┌──────────┐                  │\n│  │ Keyword  │  │ Content  │  │ Topical  │                  │\n│  │ Gaps     │  │ Gaps     │  │ Gaps     │                  │\n│  └──────────┘  └──────────┘  └──────────┘                  │\n│                                                             │\n│  Wave 4: Local + Authority (parallel)                       │\n│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐     │\n│  │ Local    │ │ Entity   │ │ Backlink │ │ Social   │     │\n│  │ SEO      │ │ Audit    │ │ Audit    │ │ Media    │     │\n│  └──────────┘ └──────────┘ └──────────┘ └──────────┘     │\n│                                                             │\n│  Wave 5: Advanced                                           │\n│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐     │\n│  │ Topical  │ │ AI SEO   │ │ Brand    │ │ Voice    │     │\n│  │ Auth     │ │ + AIO    │ │ SERP     │ │ Search   │     │\n│  └──────────┘ └──────────┘ └──────────┘ └──────────┘     │\n│                                                             │\n│  Wave 6: Scoring + Output                                   │\n│  ┌──────────────┐ ┌──────────────┐                          │\n│  │ LOCAL-IMPACT │ │ SERP-TRUST   │                          │\n│  │ Score (60)   │ │ Score (50)   │                          │\n│  └──────┬───────┘ └──────┬───────┘                          │\n│         └───────┬────────┘                                  │\n│          ┌──────┴──────┐                                    │\n│          │ SEO Health  │                                    │\n│          │ Index       │                                    │\n│          └──────┬──────┘                                    │\n│          ┌──────┴──────┐                                    │\n│          │ PDF Report  │                                    │\n│          │ Generation  │                                    │\n│          └─────────────┘                                    │\n└─────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Proprietary Scoring Frameworks\n\n### LOCAL-IMPACT Score (0-100)\n\n*Local Optimization, Consistency, Authority & Listing — Impact Performance Assessment & Competitive Tracking*\n\n60 items across 8 dimensions, scored 0-3 each:\n\n| Dimension | Items | What It Measures |\n|-----------|-------|-----------------|\n| L — Listing Quality | 10 | GBP completeness, categories, photos, posts |\n| O — Online Reviews | 10 | Count, rating, velocity, responses |\n| C — Citation Consistency | 10 | NAP accuracy across directories |\n| A — Authority Signals | 10 | Local links, associations, trust |\n| L2 — Local Content | 5 | Location pages, community content |\n| I — Integrated Visibility | 5 | Multi-platform presence |\n| P — Performance | 5 | Speed, mobile, CWV |\n| T — Tracking | 5 | Analytics, conversion tracking |\n\n### SERP-TRUST Score (0-100)\n\n*Search Engine Results Page — Technical Reliability, User Signals & Search Trust*\n\n50 items across 5 dimensions, scored 0-4 each:\n\n| Dimension | Items | What It Measures |\n|-----------|-------|-----------------|\n| T — Technical Foundation | 10 | Crawlability, indexation, schema, security |\n| R — Ranking Signals | 10 | On-page optimization, content, E-E-A-T |\n| U — User Experience | 10 | CWV, mobile, accessibility, CRO |\n| S — Search Authority | 10 | Backlinks, citations, topical authority |\n| T2 — Trust & AI Readiness | 10 | AI visibility, entity recognition, brand SERP |\n\n### SEO Health Index (Combined)\n\n```\nSEO Health Index = (LOCAL-IMPACT × 0.55) + (SERP-TRUST × 0.45)\n```\n\nBoth frameworks include **veto checks** — critical conditions that cap the maximum score regardless of other factors.\n\n---\n\n## Command Quick Reference\n\n### Core Workflow\n\n| Command | What It Does |\n|---------|-------------|\n| `/seo-audit [url]` | Full 21-phase audit |\n| `/quick-audit [url]` | Fast 5-phase health check |\n| `/score-local-impact` | Run LOCAL-IMPACT framework |\n| `/score-serp-trust` | Run SERP-TRUST framework |\n| `/audit-report` | Compile master report |\n| `/generate-pdf` | Create PDF report |\n| `/export-html` | Export HTML report |\n\n### Individual Phases\n\n| Command | Phase |\n|---------|-------|\n| `/audit-intake` | Information gathering |\n| `/audit-competitors [urls]` | Competitor analysis |\n| `/audit-technical [url]` | Technical SEO |\n| `/audit-onpage [url]` | On-page SEO |\n| `/audit-content [url]` | Content audit |\n| `/audit-content-gaps [url]` | Content gaps |\n| `/audit-keywords [url]` | Keyword gaps |\n| `/audit-topical-gaps [url]` | Topical gaps |\n| `/audit-authority [url]` | Topical authority |\n| `/audit-entities [url]` | Entity audit |\n| `/audit-speed [url]` | Speed & CWV |\n| `/audit-local [url]` | Local SEO & GBP |\n| `/audit-backlinks [url]` | Backlink profile |\n| `/audit-social [url]` | Social media |\n| `/audit-ai-seo [url]` | AI visibility |\n| `/audit-reputation [url]` | Reputation |\n| `/audit-brand-serp [url]` | Brand SERP |\n| `/audit-cro [url]` | UX & CRO |\n| `/audit-voice [url]` | Voice search |\n| `/audit-accessibility [url]` | Accessibility |\n| `/audit-penalty [url]` | Penalty check |\n| `/audit-multi-location [url]` | Multi-location |\n\n### Utilities\n\n| Command | What It Does |\n|---------|-------------|\n| `/audit-quick-wins` | Extract all quick wins |\n| `/audit-action-plan [timeframe]` | Prioritized action plan |\n| `/audit-compare [url]` | Side-by-side comparison |\n| `/audit-status` | Show audit progress |\n| `/topical-map [niche]` | Build topical authority map |\n| `/keyword-map` | Keyword-to-page mapping |\n| `/schema-generator [url] [type]` | Generate JSON-LD schema |\n| `/content-brief [keyword]` | SEO content brief |\n| `/gbp-optimize [business]` | GBP optimization toolkit |\n| `/citation-list [cat] [loc]` | Citation building list |\n| `/ai-visibility-check [biz]` | AI platform visibility |\n\n---\n\n## Architecture\n\n```\nlocal-seo-audit/\n├── .claude-plugin/\n│   └── plugin.json              # Plugin manifest\n├── commands/                     # 40 slash commands\n│   ├── seo-audit.md\n│   ├── score-local-impact.md\n│   ├── score-serp-trust.md\n│   ├── generate-pdf.md\n│   └── ...\n├── research/                     # Research phase skills\n│   ├── audit-intake/\n│   ├── competitor-analysis/\n│   ├── keyword-gaps/\n│   ├── content-gaps/\n│   └── topical-gaps/\n├── audit/                        # Audit phase skills\n│   ├── technical-seo/\n│   ├── onpage-seo/\n│   ├── content-audit/\n│   ├── speed-optimization/\n│   ├── penalty-check/\n│   └── accessibility-audit/\n├── local/                        # Local SEO skills\n│   ├── local-seo/\n│   ├── entity-audit/\n│   ├── multi-location-seo/\n│   ├── reputation-audit/\n│   └── brand-serp/\n├── ai-visibility/                # AI optimization skills\n│   ├── ai-seo/\n│   └── voice-search/\n├── strategy/                     # Strategy skills\n│   ├── topical-authority/\n│   ├── backlink-audit/\n│   ├── social-media-audit/\n│   └── ux-cro-audit/\n├── output/                       # Output skills\n│   ├── report-generation/\n│   └── pdf-report/\n├── cross-cutting/                # Cross-cutting skills\n│   ├── seo-audit-identity/\n│   ├── local-impact-auditor/\n│   └── serp-trust-auditor/\n├── agents/                       # 6 sub-agents\n├── references/                   # Scoring frameworks\n│   ├── local-impact-benchmark.md\n│   ├── serp-trust-benchmark.md\n│   └── scoring-methodology.md\n├── scripts/                      # 8 Python automation scripts\n├── hooks/                        # Quality gate hooks\n├── CLAUDE.md                     # Master audit framework\n├── AGENTS.md                     # Sub-agent architecture\n├── CONNECTORS.md                 # MCP connector patterns\n├── skills.sh.json                # skills.sh distribution config (Vercel)\n├── auto-improve.md               # Autonomous skill improvement loop\n└── marketplace.json              # Marketplace distribution\n```\n\n---\n\n## Skills (Auto-Activated)\n\nSkills activate automatically when Claude detects relevant context:\n\n| Skill | Phase Directory | Activates For |\n|-------|----------------|---------------|\n| `seo-audit-identity` | cross-cutting/ | Any SEO audit discussion |\n| `audit-intake` | research/ | Starting an audit, providing URLs |\n| `competitor-analysis` | research/ | Competitive research |\n| `technical-seo` | audit/ | Crawlability, indexation, schema |\n| `onpage-seo` | audit/ | Title tags, meta descriptions, headers |\n| `content-audit` | audit/ | Content quality, thin content |\n| `content-gaps` | research/ | Missing content opportunities |\n| `keyword-gaps` | research/ | Keyword research, rankings |\n| `topical-gaps` | research/ | Topic mapping, cluster gaps |\n| `topical-authority` | strategy/ | Authority building |\n| `entity-audit` | local/ | Knowledge Graph, entities |\n| `speed-optimization` | audit/ | CWV, LCP, INP, CLS |\n| `local-seo` | local/ | GBP, citations, NAP, reviews |\n| `backlink-audit` | strategy/ | Link profile, link building |\n| `social-media-audit` | strategy/ | Social profiles, engagement |\n| `ai-seo` | ai-visibility/ | AI Overviews, AEO, GEO, LLM |\n| `reputation-audit` | local/ | Reviews, sentiment, reputation |\n| `brand-serp` | local/ | Branded search, Knowledge Panel |\n| `ux-cro-audit` | strategy/ | Conversion paths, analytics |\n| `voice-search` | ai-visibility/ | Voice queries, conversational |\n| `accessibility-audit` | audit/ | WCAG, ADA, heading hierarchy |\n| `penalty-check` | audit/ | Manual actions, penalties |\n| `multi-location-seo` | local/ | Multi-location GBP |\n| `report-generation` | output/ | Compiling audit reports |\n| `pdf-report` | output/ | PDF report generation |\n| `local-impact-auditor` | cross-cutting/ | LOCAL-IMPACT scoring |\n| `serp-trust-auditor` | cross-cutting/ | SERP-TRUST scoring |\n\n---\n\n## Sub-Agents\n\nClaude spawns specialized agents for parallel audit execution:\n\n| Agent | Model | Handles | Phases |\n|-------|-------|---------|--------|\n| `technical-analyst` | sonnet | Technical + Speed + Accessibility | 2, 10, 19 |\n| `content-analyst` | sonnet | Content + Gaps + Authority | 4, 5, 7, 8 |\n| `keyword-analyst` | sonnet | Keywords + On-Page + Entities | 3, 6, 9 |\n| `local-seo-analyst` | sonnet | Local + Reviews + Multi-location | 11, 15, 21 |\n| `ai-visibility-analyst` | sonnet | AI SEO + Brand SERP + Voice | 14, 16, 18 |\n| `offpage-analyst` | sonnet | Backlinks + Social + CRO | 12, 13, 17 |\n\n---\n\n## PDF Report\n\nAfter completing an audit, generate a professionally designed PDF:\n\n```\n/local-seo-audit:generate-pdf\n```\n\nThe PDF includes:\n- Cover page with overall health score gauge\n- **LOCAL-IMPACT & SERP-TRUST score dashboard** with dimension breakdowns\n- SEO Health Index combined score\n- Color-coded issue severity cards (critical/high/medium/low)\n- Priority matrix (impact vs effort quadrant)\n- Quick wins checklist\n- Competitor comparison bar charts + framework score comparison\n- Veto check status indicators\n- Timeline roadmap visualization (30d/90d/6m/12m)\n- KPI tracking framework\n- Full phase-by-phase details with per-phase score gauges\n\n**Zero dependencies** — uses Chrome headless (already on your Mac). HTML file is also kept for customization.\n\n---\n\n## MCP Connectors\n\nThe plugin works standalone but enhances with MCP integrations. See [CONNECTORS.md](CONNECTORS.md) for the tool-agnostic connector pattern.\n\n**3-Tier Progressive Enhancement:**\n- **Tier 1 (No tools):** Web search + fetch only — full audit capability\n- **Tier 2 (Basic MCP):** PageSpeed API, search APIs — enhanced data\n- **Tier 3 (Full integration):** GSC, GA4, GBP APIs — real-time analytics\n\n---\n\n## Requirements\n\n- Claude Code v1.0.33 or later\n- Web search and web fetch permissions enabled\n- Google Chrome (for PDF generation — already installed on most systems)\n\n## Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/new-audit-phase`)\n3. Commit your changes\n4. Push and open a Pull Request\n\n## License\n\nMIT — see [LICENSE](LICENSE) for details.\n\n## Support\n\n- Issues: [GitHub Issues](https://github.com/mshahiddigital/local-seo-audit/issues)\n- Discussions: [GitHub Discussions](https://github.com/mshahiddigital/local-seo-audit/discussions)\n",
  "bytes": 17056,
  "sha": "cd964b59f02fced73d0e525934c60247645304bcf3ed936c5237bbce257d57b2",
  "repo_slug": "mshahiddigital/local-seo-audit",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_mshahiddigital_local_seo_audit_local_seo_f77f63b6/readme"
}