Check gate
The checker reads every page of a built site before anything moves. One failure stops the job. Zero is the only passing score.
Run it
Check a draft
python spidercaster.py check sites/my-site --expect-noindex
Check the words too
Add --project projects/my-site so the checker can compare every visible line with your copy.
Read the result
The last line counts pass, fail, warn, and skip. A skip means the check did not run, and not run is never a pass.
What it reads
Words
Every visible line on the page must come from your copy. Filler text fails the job.
Links
Internal links must lead somewhere, with crawlable addresses and named anchors.
Photos
Local files only, with alt text and set dimensions. Brightness must sit between 90 and 200.
The small print
Title, description, canonical link, one h1 per page, heading order, page language, and the noindex line.
Phones
Body text at 18px and nothing under 16px, text contrast of at least 4.5:1, tap targets of at least 44px, and no sideways scroll at 360, 390, or 412px wide.
The ledger
Each build writes report.json with its token count. An offline build must total zero.
Pass, fail, warn, and skip
Each check prints one row. The last line adds them up, and only the fail count decides.
pass
The check ran and the page met it.
fail
The page broke a rule. The job stops, and the check command exits with code 1.
warn
Worth a look, but not a stop. A short page earns a thin_content warning.
skip
The check could not run, for example because it needs a browser. Not run is never a pass.
A pass and a failure
The end of a passing run, then the same site with its icon deleted on purpose. The check command exits with code 1.
$ python spidercaster.py check sites/my-site --expect-noindex --project projects/my-site
[pass] ask_after_proof - offer->proof->ask holds
[pass] single_primary_cta - 1 page(s), one visible primary per viewport
[pass] mobile_block - 0 mobile block(s), 360-first
[pass] token_ledger - mode=offline in=0 out=0 est=$0.0000
[pass] cited_text - 1 page(s), every visible string cited
result: 59 pass / 0 fail / 2 warn / 3 skipExit code: 0
$ python spidercaster.py check sites/broken --expect-noindex
[FAIL] internal_links - index.html: favicon.svg; index.html: favicon.svg
[FAIL] favicon_svg - missing favicon.svg beside index.html
result: 56 pass / 2 fail / 2 warn / 4 skipExit code: 1
Why one failure stops the job
A page with a broken link, a photo with no alt text, or an invented line should not reach the public. The gate stops the job and names the page and the check, so the fix is one edit and one rebuild.