audit report

Usage

seo-ops audit report [--format=md|json|csv|html] [--output=<file>] [--from=<audit-file>] [--path=<path>]

Generate structured audit reports in multiple formats. Can run a fresh audit or format a previously saved audit JSON file.

Examples

Markdown Report (Default)

seo-ops audit report --path=/var/www/html

Output:

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

## Overall Score: 72/100 (GOOD)

| Category | Score | Weighted |
|----------|-------|----------|
| Meta Tags | 16/20 | 16.0 |
| Links | 12/15 | 12.0 |
| Images | 7/10 | 7.0 |
| PageSpeed | 11/15 | 11.0 |
| Schema | 8/10 | 8.0 |
| Redirects | 10/10 | 10.0 |

## Recommendations
1. Add meta descriptions to 5 posts
2. Fix 12 images missing alt text
3. Improve PageSpeed score (currently 68)

Report generated: 2024-12-15T10:30:00Z

HTML Report

seo-ops audit report --path=/var/www/html --format=html --output=report.html

Output:

Report saved: report.html

The HTML report is a self-contained styled document you can open in a browser.

Generate Report From Saved Audit Data

# First run a full audit and save raw JSON
seo-ops audit full --path=/var/www/html --format=json --output=raw-audit.json

# Then generate a CSV report from it without re-scanning
seo-ops audit report --from=raw-audit.json --format=csv --output=audit-report.csv

JSON Output

seo-ops audit report --path=/var/www/html --format=json

Output:

{
  "score": 72,
  "severity": "GOOD",
  "recommendations": [
    "Add meta descriptions to 5 posts",
    "Fix 12 images missing alt text",
    "Improve PageSpeed score"
  ],
  "generated": "2024-12-15T10:30:00Z"
}

Output Formats

Format	Best For
md	Human-readable, commit to repo
json	Automation, further processing
csv	Spreadsheets, data analysis
html	Beautiful web report, sharing