seo-audit-bot

# SEO Audit Bot A comprehensive SEO auditing skill that analyzes any website and produces a detailed, actionable report. ## What It Does When a user provides a URL, this skill performs a full SEO audit covering: 1. **Technical SEO** — robots.txt, sitemap, HTTPS, mobile-friendliness, page speed signals 2. **On-Page SEO** — title tags, meta descriptions, headings, URL structure, internal linking 3. **Content Analysis** — word count, keyword density, readability, duplicate content signals 4. **Performance** — page load indicators, Core Web Vitals signals 5. **Social & Sharing** — Open Graph tags, Twitter Cards, structured data 6. **Competitor Comparison** (optional) — compare against a competitor URL ## How to Use ### Basic Audit User says: `"Audit the SEO of https://example.com"` Agent should: 1. Fetch the target URL using `web_fetch` 2. Fetch the robots.txt (`/robots.txt`) 3. Fetch the sitemap (`/sitemap.xml` or from robots.txt) 4. Analyze the HTML content for all SEO factors 5. Generate a structured report ### Competitor Comparison User says: `"Compare SEO of https://example.com vs https://competitor.com"` Agent should: 1. Audit both URLs 2. Generate a side-by-side comparison 3. Highlight advantages and gaps ## Audit Process ### Step 1: Fetch the Page ``` web_fetch(url="<target_url>", maxChars=50000, extractMode="text") ``` ### Step 2: Check Technical Signals - Fetch `robots.txt` → check if exists, what's blocked - Fetch `sitemap.xml` → check if exists, last modified - Check HTTPS redirect - Check canonical tag presence ### Step 3: Analyze On-Page Elements Extract and evaluate: - `<title>` — length (50-60 chars ideal), keyword presence - `<meta name="description">` — length (150-160 chars ideal), keyword presence - `<h1>` — single h1, contains primary keyword - `<h2>`–`<h6>` — proper hierarchy - URL structure — short, descriptive, keyword-rich - Image alt tags — descriptive, not keyword-stuffed - Internal links — count, quality, anchor text - External links — count, quality, nofollow usage ### Step 4: Content Analysis - Word count (minimum 300 for pages, 1000+ for blog posts) - Keyword density (1-3% for primary keyword) - Heading structure (logical hierarchy) - Readability (sentence length, paragraph size) - Duplicate content risk ### Step 5: Performance Indicators - Check for `<meta name="viewport">` (mobile-friendly) - Check for lazy loading on images - Check for minified CSS/JS references - Check for CDN usage - Check for excessive inline styles ### Step 6: Social & Schema - Open Graph tags (og:title, og:description, og:image) - Twitter Card tags - JSON-LD structured data - Schema.org markup ### Step 7: Generate Report ## Report Format ``` # SEO Audit Report: [URL] Date: [date] ## Overall Score: XX/100 ### 🔧 Technical SEO: XX/100 - ✅ HTTPS enabled - ✅ robots.txt found - ❌ No sitemap.xml found - ✅ Mobile viewport configured - ⚠️ Missing canonical tag Recommendations: 1. Create and submit a sitemap.xml 2. Add canonical tags to prevent duplicate content ### 📄 On-Page SEO: XX/100 - ✅ Title tag (52 chars) — Good - ⚠️ Meta description (180 chars) — Too long, aim for 150-160 - ❌ No H1 tag found - ✅ URL structure is clean - ⚠️ 3 images missing alt tags Recommendations: 1. Add a clear H1 tag with primary keyword 2. Shorten meta description to 150-160 characters 3. Add alt tags to all images ### 📝 Content: XX/100 - Word count: 450 words - Primary keyword density: 1.2% - Heading structure: Proper H2/H3 hierarchy - Readability: Good (avg 15 words/sentence) Recommendations: 1. Expand content to 800+ words for better ranking potential ### ⚡ Performance: XX/100 - Viewport meta: ✅ - Lazy loading: ⚠️ Partial - Minified assets: ✅ - CDN: ❌ Not detected ### 📱 Social & Schema: XX/100 - Open Graph: ✅ Complete - Twitter Cards: ⚠️ Missing - JSON-LD: ❌ Not found Recommendations: 1. Add Twitter Card meta tags 2. Implement JSON-LD structured data for rich snippets ## 🎯 Priority Actions (Do These First) 1. [HIGH] Add H1 tag with primary keyword 2. [HIGH] Create sitemap.xml 3. [MEDIUM] Implement JSON-LD structured data 4. [LOW] Add Twitter Card tags ``` ## Scoring Rubric Each section is scored 0-100: ### Technical SEO (25% weight) - HTTPS: 15 points - robots.txt: 10 points - sitemap.xml: 15 points - Mobile viewport: 15 points - Canonical tag: 10 points - Clean URL structure: 10 points - Page speed indicators: 15 points - No broken links: 10 points ### On-Page SEO (30% weight) - Title tag (exists, length, keyword): 20 points - Meta description (exists, length, keyword): 20 points - H1 tag (exists, unique, keyword): 20 points - Heading hierarchy: 10 points - Image alt tags: 15 points - Internal linking: 15 points ### Content (25% weight) - Word count: 25 points - Keyword presence & density: 25 points - Readability: 25 points - Content structure: 25 points ### Performance (10% weight) - Mobile-friendly: 30 points - Asset optimization: 30 points - Loading indicators: 40 points ### Social & Schema (10% weight) - Open Graph: 40 points - Twitter Cards: 30 points - Structured data: 30 points Overall Score = weighted average of all sections. ## Tips for the Agent 1. **Be specific** — don't just say "improve SEO", say exactly what to change 2. **Prioritize** — label recommendations as HIGH/MEDIUM/LOW 3. **Show before/after** — when suggesting changes, show the current state and the ideal state 4. **Be honest about limitations** — you can't check page speed directly, only indicators 5. **Offer follow-up** — suggest re-audit after changes are made