SEO Analyzer Skill

Quick Start

Auto Mode (Recommended)

python scripts/seo_analyzer.py --auto <url>

1. Check if agent-browser is installed
2. Use agent-browser to fetch page HTML
3. Perform a full SEO check
4. Generate a detailed test report

Manual Mode

# Analyze from file
python scripts/seo_analyzer.py <html_file> <url>

# Read from stdin
agent-browser get source | python scripts/seo_analyzer.py - <url>

# JSON output format
python scripts/seo_analyzer.py <html_file> <url> --json

Workflow

1. Fetch Page Content - Use agent-browser to open the page and get HTML
2. Execute SEO Check - Run

   seo_analyzer.py

   to analyze the page
3. Generate Report - Output issues and recommendations categorized by severity

Complete Workflow Examples

# Method 1: Auto Mode (Recommended)
python scripts/seo_analyzer.py --auto https://example.com

# Method 2: Step-by-step execution
agent-browser open <url> --timeout 30000
agent-browser get source | python scripts/seo_analyzer.py - <url>

# Method 3: Use file
agent-browser get source > /tmp/page.html
python scripts/seo_analyzer.py /tmp/page.html <url>

Check Categories

1. Technical Requirements - HTTP status code, Googlebot accessibility, HTTPS, noindex directive
2. Title Tags - Existence, uniqueness, descriptiveness, avoiding keyword stuffing
3. Meta Descriptions - Existence, uniqueness, descriptiveness, appropriate length
4. Heading Structure - Existence and uniqueness of H1, logical hierarchy
5. Link Accessibility - Standard link format, descriptive anchor text, rel attributes
6. Image Optimization - Alt attributes, descriptive text
7. Structured Data - Existence and validity of JSON-LD/Microdata/RDFa
8. URL Structure - Descriptiveness, readability, use of hyphens
9. Canonical URL - Existence, absolute path, HTTPS priority
10. Content Quality - Uniqueness, readability, substantial content
11. Mobile Friendliness - Viewport tag, responsive design
12. Core Web Vitals - LCP, INP, CLS (requires JavaScript runtime measurement)

references/seo-check-rules.md

Report Format

• Critical - Must be fixed, will prevent indexing/ranking
• Warning - Should be fixed, affects performance
• Info - Optimization recommendations to improve performance

• Issue summary (total count, count by severity level)
• Detailed issue list (category, current status, recommendation, reference documentation)
• Passed check items

--json

Reference Resources

• Check Rules:

  references/seo-check-rules.md

  - Detailed check rules and implementation logic
• Google SEO Documentation: seo-docs - Complete reference based on official Google documentation

Limitations

• Cannot measure Core Web Vitals (requires JavaScript runtime)
• Cannot verify if pages have been indexed by Google
• Cannot access server configurations (SSL, redirects, etc.)
• Content quality assessment is based on heuristic methods
• Mobile friendliness checks are approximate, not actual device simulation