seo-audit
Run a comprehensive SEO audit — technical health, on-page, content gaps, E-E-A-T, link profile, and competitor benchmarking
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/indranilbanerjee/digital-marketing-pro/HEAD/commands/seo-audit.md -o ~/.claude/commands/seo-audit.mdseo-audit.md
# SEO Audit > If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../CONNECTORS.md). Audit a website's SEO health across all major ranking dimensions: technical infrastructure, on-page optimization, content quality, E-E-A-T signals, local SEO, link profile, and AI answer engine visibility. Produces a prioritized action plan with impact-to-effort scoring. ## Trigger User runs `/seo-audit` or asks for an SEO audit, keyword research, content gap analysis, technical SEO check, or competitor SEO comparison. ## Inputs Gather the following from the user. If not provided, ask before proceeding: 1. **URL or domain** — the site to audit, or a topic/keyword if running in keyword research mode 2. **Audit scope** — one of: - **Full site audit** — end-to-end SEO review covering all dimensions below (default) - **Technical only** — crawlability, Core Web Vitals, structured data, infrastructure - **Content only** — thin content, gaps, freshness, E-E-A-T, keyword opportunities - **Local SEO** — Google Business Profile, NAP consistency, local schema, reviews - **Competitor comparison** — head-to-head benchmarking against specific competitors 3. **Target keywords** (optional) — specific keywords the site is targeting or wants to rank for 4. **Competitors** (optional) — 2-3 domains to benchmark against. If not provided and comparison is needed, identify likely competitors from the keyword space. ## Process ### 1. Keyword Research **If ~~SEO tools are connected (Ahrefs, Similarweb):** - Pull keyword data, search volume, difficulty scores, and current ranking positions automatically - Identify keywords gaining or losing ground **If tools are not connected:** - Use web search to research the keyword landscape - Note: "For precise volume and difficulty data, connect an SEO tool via `/connect ahrefs` or `/connect similarweb`." For each keyword opportunity, assess: - **Search volume signals** — relative demand (high, medium, low) - **Keyword difficulty** — how competitive (easy, moderate, hard) - **Intent classification** — informational, navigational, commercial, or transactional - **Long-tail opportunities** — specific, lower-competition phrases with clear intent - **Question-based keywords** — "how to", "what is" queries for People Also Ask ### 2. Technical SEO Audit Evaluate infrastructure that affects crawlability and rankings: - **Page speed** — slow-loading pages, likely causes (large images, render-blocking scripts, redirects) - **Mobile-friendliness** — responsive design, tap targets, viewport configuration - **Structured data** — schema markup opportunities (FAQ, HowTo, Product, Article, Organization, Breadcrumb) - **Crawlability** — robots.txt, XML sitemap, canonical tags, noindex/nofollow usage - **Broken links** — internal and external 404s, redirect chains - **HTTPS** — secure connection, mixed content - **Core Web Vitals** — LCP, INP, CLS indicators - **Indexation** — pages that should be indexed but aren't, duplicate content risks ### 3. On-Page SEO Audit For each key page (homepage, top landing pages, recent content): - **Title tags** — present, unique, 50-60 characters, includes target keyword - **Meta descriptions** — present, compelling, 150-160 characters, includes CTA - **Heading hierarchy** — one H1, logical H2/H3 structure, keywords in subheadings - **Keyword usage** — primary keyword in first 100 words, natural distribution, no stuffing - **Internal linking** — pages link to related content, orphan pages identified, descriptive anchor text - **Image optimization** — alt text on all images, compressed files, proper sizing - **URL structure** — clean, readable, keyword-inclusive ### 4. Content Quality & E-E-A-T Assessment - **Experience** — first-hand experience signals, original research, case studies - **Expertise** — author credentials, depth of coverage, technical accuracy - **Authoritativeness** — citation quality, industry recognition, backlink authority - **Trustworthiness** — accuracy, transparency, editorial standards, secure site - **Content freshness** — pages not updated in 12+ months, outdated statistics - **Thin content** — pages with insufficient depth to rank - **Content gaps** — topics competitors cover that the site doesn't ### 5. AI Answer Engine Visibility (AEO/GEO) - **AI Overview presence** — does the site appear in Google AI Overviews? - **Citation-worthiness** — are there "citeable moments" (definitions, data, structured answers)? - **Snippet structuring** — content formatted for direct answer extraction - **Entity consistency** — brand name, facts, and claims consistent across the web ### 6. Link Profile Analysis - **Domain authority signals** — overall site strength based on backlink profile - **Backlink quality** — proportion of high-quality vs. low-quality referring domains - **Anchor text distribution** — natural vs. over-optimized - **Link velocity** — trend in new links acquired - **Competitor link gap** — sites linking to competitors but not to this domain - **Toxic links** — potentially harmful backlinks to disavow ### 7. Local SEO (if applicable) - **Google Business Profile** — completeness, accuracy, categories, photos, posts - **NAP consistency** — name, address, phone matching across directories - **Local schema markup** — LocalBusiness, opening hours, service area - **Review profile** — volume, recency, rating, response rate - **Local content** — city/service pages, local landing pages ## Output Format ### Executive Summary - Overall SEO health score (1-10 per dimension) - Top 3 strengths - Top 3 priorities with estimated impact ### Keyword Opportunity Table | Keyword | Volume Signal | Difficulty | Current Rank | Intent | Recommended Action | |---------|--------------|------------|--------------|--------|--------------------| Include 15-25 opportunities sorted by opportunity score. ### Issue Table | Page/Area | Issue | Severity | Recommended Fix | Effort | |
Invoke when the user needs to manage multiple client brands, view portfolio-level dashboards, generate client reports, manage SOPs, switch credential profiles, assign team tasks, configure regions, or generate executive summaries. Triggers on requests involving multi-client management, agency workflows, client onboarding, or portfolio oversight.
Invoke when the user needs help with marketing measurement, KPI definition, dashboard design, attribution modeling, performance analysis, anomaly detection, competitive benchmarking, or translating data into marketing decisions. Triggers on requests involving metrics, reporting, analytics setup, or data interpretation.
Invoke when marketing content needs quality control review — brand voice consistency checks, regulatory compliance verification (GDPR, CAN-SPAM, CCPA, HIPAA, FTC, industry-specific), accessibility auditing (WCAG 2.1), inclusive language review, or brand safety assessment. Automatically invoked as a final review step before any content is published or delivered.
Invoke when the user needs competitor analysis — content strategy teardowns, SEO gap analysis, paid ad analysis from ad libraries, social media benchmarking, AI visibility comparisons, pricing and positioning research, or market landscape mapping. Triggers on requests mentioning competitors, competitive gaps, market analysis, or benchmarking.
Use when the task requires ongoing competitive monitoring, competitor change detection, share of voice tracking, competitive alerts, ad monitoring, price monitoring, win/loss analysis, or competitive narrative mapping.
Invoke when the user needs any form of marketing content created or refined — blog posts, ad copy, email campaigns, social media posts, landing page copy, press releases, video scripts, product descriptions, or newsletter content. Triggers on requests to write, draft, rewrite, or improve marketing copy.
Invoke when the user needs to manage CRM operations — creating contacts, importing leads, updating deals, syncing campaign data, segmenting audiences, managing pipelines, or connecting marketing data to Salesforce, HubSpot, Zoho, or Pipedrive. Triggers on requests involving CRM data, lead management, pipeline updates, or sales-marketing alignment.
Invoke when the user needs help with conversion rate optimization — landing page audits, A/B test design, form optimization, pricing page strategy, checkout flow improvement, personalization, statistical significance calculations, page speed impact analysis, or mobile conversion optimization. Triggers on requests involving conversions, landing pages, A/B testing, or optimization experiments.