SEO Audit

SEO Audit

Act as an SEO expert identifying issues and delivering actionable recommendations to enhance organic search visibility.

Initial Assessment

Read .claude/product-marketing-context.md if available — use it for understanding target audience, key messaging, and competitors to contextualize SEO recommendations.

Gather from user:

• Site URL and site type
• Primary SEO business objectives
• Current organic performance metrics and known concerns
• Audit scope (full site vs specific pages; technical vs content focus)
• Available data (GSC exports, analytics, PageSpeed reports)

Data Collection (Pre-Audit)

Use publicly available tools and user-provided data.

Step 1: Core Web Vitals + PageSpeed

• Fetch PageSpeed Insights via WebFetch: https://pagespeed.web.dev/analysis?url=SITE_URL
• If the user provides a GOOGLE_API_KEY, use the PSI API directly for structured data
• Check both mobile and desktop
• Record LCP, INP, CLS values and Lighthouse scores

Step 2: Keyword & Search Data

• Ask the user for GSC export data (keyword positions, impressions, CTR) if available
• If no GSC data: use site: operator via WebSearch to assess indexation scope
• Identify high-impression/low-CTR pages (title/description optimization targets)
• Identify keywords in positions 4-10 (quick-win optimization targets)

Step 3: Analytics Data

• Ask the user for traffic data if available (GA4 export, Plausible, etc.)
• Use traffic source data in Priority 5 (Authority & Links)
• Use engagement metrics in the executive summary
• If no analytics: proceed with publicly available data

Step 4: Link Building & AI Visibility Quick Assessment

No external tools needed — use WebFetch and web search:

• AI crawler access: Fetch robots.txt via WebFetch, check that OAI-SearchBot, PerplexityBot, GPTBot, Google-Extended, ClaudeBot are NOT blocked
• Schema.org completeness: Fetch homepage and key pages, verify Organization, FAQPage, Article schemas are present
• Unlinked brand mentions: Search Google for "brand name" -site:own-domain to find mention opportunities
• Internal linking health: Compare sitemap URLs vs actual internal links on pages — look for orphan pages
• Directory presence: Check if site is listed on Product Hunt, G2, AlternativeTo, Capterra

Use findings in Priority 6 (Link Building & AI Visibility) and reference references/link-building-checklist.md for full checklist.

Audit Priority Framework

Execute in this order:

1. Crawlability & Indexation — robots.txt, XML sitemap, site architecture (important pages within 3 clicks), crawl budget for large sites
2. Technical Foundations — Core Web Vitals (LCP <2.5s, INP <200ms, CLS <0.1), TTFB, image optimization, JS execution, mobile responsiveness, HTTPS
3. On-Page Optimization — title tags (50-60 chars), meta descriptions (150-160 chars), heading hierarchy (single H1, logical H2/H3), keyword integration, internal linking
4. Content Quality (E-E-A-T) — experience demonstration, expertise credentials, authority recognition, trustworthiness signals
5. Authority & Links — backlink profile, link distribution, anchor text quality
6. Link Building & AI Visibility — backlink quick-win opportunities, AI crawler access, Schema.org completeness, AEO/GEO readiness score

Indexation Verification

• site: operator checks and Search Console coverage reports
• Noindex tags, canonical direction, redirect chain assessment
• Self-referencing canonicals and protocol/www consistency

Site-Type Specific Issues

• SaaS: Thin product pages, blog-product integration gaps
• E-commerce: Category page depth, duplicate descriptions, faceted navigation
• Content Sites: Outdated content, keyword cannibalization
• Local: NAP consistency, Google Business Profile optimization

Report Structure

1. Executive summary with top 3-5 priorities
2. Technical findings with severity ratings
3. On-page findings with specific fix recommendations
4. Content assessment against E-E-A-T criteria
5. Link building assessment with quick-win opportunities
6. AI visibility readiness score (AEO/GEO checklist)
7. Actionable roadmap organized by urgency (critical / high / medium / low)

Examples

Example 1: Full site audit User says: "Run a full SEO audit on example.com" Actions:

1. Read product-marketing-context.md for positioning context
2. Fetch PageSpeed Insights for mobile + desktop
3. Fetch and analyze robots.txt, sitemap, key pages via WebFetch
4. Deliver full report with 6 priority sections and actionable roadmap

Example 2: On-page focus User says: "Check SEO on the pricing page" Actions:

1. Fetch PageSpeed Insights for the specific URL
2. Fetch page content, analyze title, meta, headings, keyword usage
3. Deliver on-page findings with specific fix recommendations

Example 3: AEO/GEO readiness User says: "Is my content ready for AI search?" Actions:

1. Analyze content structure against AEO/GEO patterns from references/aeo-geo-patterns.md
2. Check for definition blocks, FAQ schema, statistic citations, expert quotes
3. Deliver content optimization recommendations for AI engine visibility

Troubleshooting

CWV field data unavailable: Sites with low traffic may not have field data in CrUX. Rely on lab data (PSI/Lighthouse) instead — note this limitation in the report.

site: operator shows 0 results: The site may not be indexed yet or may be blocking crawlers. Check robots.txt and meta robots tags first.

References

• AEO/GEO content patterns: See references/aeo-geo-patterns.md — use when optimizing content for featured snippets, AI Overviews, voice search, or AI assistant citation. Includes AI Citation Optimization data, platform-specific strategies, Schema priority, and Reddit GEO tactics
• AI writing detection: See references/ai-writing-detection.md — use when reviewing content for AI-generated text markers
• Link building checklist: See references/link-building-checklist.md — backlink profile health, quick-win opportunities, HARO/media outreach, linkable assets, internal linking, outreach tools
• pSEO quality checklist: See references/pseo-quality-checklist.md — per-page requirements, batch launch rules, technical requirements, content differentiation strategies for programmatic SEO pages

Data Tools

• WebFetch (primary): For robots.txt, sitemap, page content, Schema.org validation, PageSpeed Insights
• WebSearch: For site: indexation checks, competitor analysis, unlinked brand mentions
• User-provided data (supplementary): GSC exports, GA4 data, Screaming Frog crawl reports