Bulk Audit¶

The bulk audit tool runs audits across multiple sites from a JSON site list, producing a comparison table.

Usage¶

python scripts/bulk_audit.py --sites sites.json --output-dir /tmp/bulk --profile quick

Sites File Format¶

Create a JSON file listing the sites to audit:

[
  {
    "name": "Main Site",
    "url": "https://example.com"
  },
  {
    "name": "Blog",
    "url": "https://blog.example.com"
  },
  {
    "name": "Competitor",
    "url": "https://competitor.com"
  }
]

Options¶

Flag	Default	Description
`--sites`	Required	Path to JSON sites file
`--output-dir`	`/tmp/bulk`	Directory for results
`--profile`	`quick`	Audit profile to use
`--delay`	`2.0`	Delay between site audits

Output¶

The output directory contains:

/tmp/bulk/
  summary.json           # Comparison table with all scores
  main-site/
    analysis.json        # Full analysis report
    scores.json          # Scores and findings
  blog/
    analysis.json
    scores.json
  competitor/
    analysis.json
    scores.json

The summary.json provides a side-by-side comparison:

{
  "sites": [
    {"name": "Main Site", "overall": 82, "seo": 85, "security": 70, ...},
    {"name": "Blog", "overall": 76, "seo": 90, "security": 55, ...},
    {"name": "Competitor", "overall": 88, "seo": 92, "security": 85, ...}
  ]
}

Use Cases¶

Portfolio audit -- score all your client sites at once
Competitive analysis -- compare against competitors
Multi-site monitoring -- regular audits across a fleet of sites
Agency reporting -- batch generate reports for all clients