SEO Reporter#

Audit any URL for core SEO factors and get an actionable report with scores and recommendations.

When to Use#

✅ USE this skill when:

• "Audit the SEO of [URL]"
• "Check [URL] for SEO issues"
• "SEO report for [URL]"
• "Analyze page SEO"
• "What SEO improvements for [URL]?"

When NOT to Use#

❌ DON'T use this skill when:

• Full technical SEO crawl needed → use Screaming Frog, Ahrefs, or Semrush
• Page speed / Core Web Vitals → use PageSpeed Insights
• Backlink analysis → use Ahrefs/Moz
• Keyword research or content optimization → use dedicated SEO tools
• SSL/certificate checks → use sslscan or online checkers

Input#

A single URL (must include protocol: https://).

text

https://example.com

Output#

A markdown SEO audit report covering:

FactorWhat It ChecksTitle TagPresence, length (50-60 chars optimal), uniquenessMeta DescriptionPresence, length (150-160 chars optimal), relevanceH1 HeadingExactly one H1 present, content relevanceHeading StructureH1→H2→H3 hierarchy, no missing levels, no multiple H1sCanonical Tag<link rel="canonical"> present and points to correct URLRobots.txtFile exists, is accessible, and is not blocking important pagesSitemap.xmlFile exists, is accessible, and contains the audited URLOpen Graph TagsOG title, description, and image presentMobile ViewportViewport meta tag presentHTTPSPage served over secure connection

Each factor gets a score (Pass / Warning / Fail) and specific recommendations if issues are found.

Usage#

Run the audit#

bash

URL="https://example.com"
./audit.sh "$URL"

Inline from agent#

The agent should run audit.sh with the target URL and present the output as a formatted markdown report.

bash

cd /home/tim/.openclaw/workspace/skills/seo-reporter
./audit.sh "https://example.com"

Report Format#

markdown

# 🔍 SEO Audit Report: https://example.com

**Date:** YYYY-MM-DD
**URL:** https://example.com

---

## Scores

| Factor | Score | Status |
|---|---|---|
| Title Tag | 8/10 | ⚠️ Warning |
| Meta Description | 7/10 | ⚠️ Warning |
| H1 Heading | 10/10 | ✅ Pass |
| Heading Structure | 9/10 | ✅ Pass |
| Canonical Tag | 10/10 | ✅ Pass |
| Robots.txt | 8/10 | ⚠️ Warning |
| Sitemap.xml | 10/10 | ✅ Pass |
| Open Graph Tags | 5/10 | ❌ Fail |
| Mobile Viewport | 10/10 | ✅ Pass |
| HTTPS | 10/10 | ✅ Pass |

**Overall Score: 87/100**

---

## Detailed Findings

### ✅ Passed

- ...

### ⚠️ Warnings

- ...

### ❌ Issues Found

- ...

## Recommendations

1. ...
2. ...

---

*Report generated by seo-reporter skill*

Scoring Guide#

ScoreMeaning10/10Perfect — no issues7-9/10Good — minor improvements possible4-6/10Warning — meaningful issue that should be fixed0-3/10Fail — critical issue

Tips#

• Always validate the URL has a protocol prefix ( https://) before running
• The audit is non-destructive (read-only HTTP requests)
• Run from the skill directory so relative paths to helpers work
• For comparing two pages, run the audit on both and diff the scores