Store › site-audit CLI

site-audit CLI

A command-line checker for technical site issues. Point it at dozens of domains at once, get a CSV back. Python 3.8+, zero dependencies — unzip and run.

By purchasing you agree to the Terms of Sale. These terms cover this store's digital goods only.

Why you'd want it

The free web tool checks one domain at a time. When you need to screen 200 prospects for obvious technical problems, or run a monthly sweep across your own portfolio, pasting them in one by one doesn't scale.

This runs concurrently — 200 sites in about 3 minutes.

What it checks

Check	What it tells you
Body text length	Plain text inside <main>. Under 800 chars usually means client-side rendering
H1 structure	Count and content — zero or several are both problems
title / description	Length, to catch truncation
Structured data	Number of JSON-LD blocks plus every @type
Image alt	Missing count and percentage
canonical	Present or absent
viewport	Mobile meta tag
sitemap	Type (single / index / missing), URL count, declared in robots.txt
AI crawler policy	Split into search crawlers and training crawlers — two different consequences
Stack	Next.js / Nuxt / WordPress / Shopify

Why the AI crawler split matters

Most tools don't do this. GPTBot handles model training; OAI-SearchBot handles ChatGPT search citations. Blocking the first protects your content; blocking the second silently removes you from AI answers. The robots.txt syntax for both looks nearly identical.

Usage

python audit.py example.com

python audit.py --file sites.txt --out report.csv --workers 10

CSV is UTF-8 with BOM — opens cleanly in Excel and Sheets.

What you get

• audit.py — main script, ~400 lines, commented
• README.md — usage, field definitions, scoring rules, known limits
• sites.example.txt — input format example

Known limitations

• No JavaScript execution. Pure CSR sites will read as thin content — which is usually the finding you want
• Sites behind aggressive Cloudflare or WAF challenges return 403
• Homepage only, no crawling
• sitemap index is detected but not recursively counted
• TLS certificates are not verified (so you can audit expired-cert sites)

FAQ

How many sites can it handle?

No hard limit. 200 sites at 10 concurrent with ~2s average response takes roughly a minute.

Can I add my own checks?

Yes. Each block in audit() is independent — copy one and modify it. The CSV field list is in main(); keep them in sync when you add a field.

Does a low score mean no traffic?

No. The score reflects technical configuration only, not content quality or market demand. It answers "what's technically fixable", not "is it worth fixing".

Can I use it for client work?

Yes — auditing client sites and charging for it is the most common use. Resale and redistribution are not permitted.

Licence

One-time licence for your own use and your client projects. No resale, no redistribution, no offering it as a service. Full terms: Terms of Sale.

Want to try before buying? Check a single domain free.