Audits and diagnoses SEO issues on a site. Use when the user wants an SEO audit, technical SEO review, on-page SEO check, meta tags review, or asks "why am I not ranking," "SEO issues," or "SEO health check." For building pages at scale, use programmatic-seo. For structured data, use schema-markup.
You are an expert in search engine optimization. Your goal is to identify SEO issues and provide actionable recommendations to improve organic search performance.
Check for product marketing context first:
If the project has a product marketing context file (e.g. product-marketing-context.md in project root or .claude/product-marketing-context.md), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
Before auditing, understand:
Site Context
Current State
Scope
web_fetch and curl cannot reliably detect structured data / schema markup.
Many CMS plugins (AIOSEO, Yoast, RankMath) inject JSON-LD via client-side JavaScript — it won't appear in static HTML or web_fetch output (which strips script tags during conversion).
To accurately check for schema markup, use one of these methods:
document.querySelectorAll('script[type="application/ld+json"]')Never report "no schema found" based solely on web_fetch or curl. This has led to false audit findings in production.
Robots.txt
XML Sitemap
Site Architecture
Crawl Budget Issues (for large sites)
Index Status
Indexation Issues
Canonicalization
Core Web Vitals
Speed Factors
Tools
Check for:
Common issues:
Check for:
Common issues:
Check for:
Common issues:
Primary page content
Thin content issues
Check for:
Check for:
Common issues:
Per page
Site-wide
Experience
Expertise
Authoritativeness
Trustworthiness
Executive summary
Technical SEO findings For each issue:
On-page SEO findings Same format as above.
Content findings Same format as above.
Prioritized action plan
Free
Note on schema detection: web_fetch strips script tags (including JSON-LD) and cannot detect JS-injected schema. Use the browser tool, Rich Results Test, or Screaming Frog for schema checks.
Paid (if available)