{"ok":true,"kind":"crawlcheck-rulebook","v":1,"generated_at":"2026-11-22T01:33:50.083Z","score_version":43,"schema":"https://crawlcheck.io/schemas/rulebook.json","counts":{"rules":111,"by_kind":{"scan":86,"answer_correlation":5,"capability_mismatch":6,"self_audit":12,"mcp_server":2},"by_family":{"site":18,"headers":4,"mostly_code":3,"machine_files":12,"other":9,"ard":4,"webmcp":2,"trust_path":2,"nap":3,"robots":17,"delivery":9,"jsonld":3,"answers":5,"capabilities":6,"self_audit":12,"mcp":1,"watch":1},"revised":10,"scored":82},"scans_counted":9304,"severity_scale":[{"level":"info"},{"level":"low"},{"level":"medium"},{"level":"high"},{"level":"critical"}],"method":{"revisions":"A rule that changes what it reports gets a new revision; a record keeps the revision that decided it, and a replay uses that revision, never today's.","share":"Share of counted scans that carried the code at least once, the same numbers /data publishes. Self-scans and opted-out sites are never counted.","grade":"Each finding has a level from info to critical. Every graded finding lowers the score of its section; an open finding at medium or above also caps the letter grade, so fix those first."},"rules":[{"code":"MACHINE_CHAIN_HEAVY","kind":"scan","family":{"id":"machine_files","label":"Machine files"},"title":"The machine files cost more than the page","meaning":"A crawler reads robots.txt, the sitemap, llms.txt and the agent files before the first page, and pays for every 404 that answers with a full page. Keep machine files as small as their job allows and serve absent paths with a short 404 body.","severity":{"level":"info"},"scored":true,"measured_on":"full scans only (the daily watch does not measure it)","revision":{"current":4,"revised_at":"2026-11-14"},"fix":{"advice":"Answer absent machine paths (/agents.md, /.well-known/...) with a short plain 404 body instead of a full HTML page: that is the part that is pure waste. Then keep robots.txt, llms.txt and the sitemap index as small as their job allows; a large sitemap index is normal on a large site.","effort":null,"endpoint":"https://crawlcheck.io/api/fix/chain?id={report_id}"},"share_of_scans":{"pct":22.7,"scans":2108,"of_scans":9304,"basis":"share of counted scans that carried it; the same numbers /data publishes"},"links":{"self":"https://crawlcheck.io/rules#MACHINE_CHAIN_HEAVY","api":"https://crawlcheck.io/api/rules?code=MACHINE_CHAIN_HEAVY","glossary":["https://crawlcheck.io/glossary/machine-layer"],"workflow":null,"lineage":"https://crawlcheck.io/docs/lineage-coverage","explain_template":"https://crawlcheck.io/api/explain?id={report_id}&code=MACHINE_CHAIN_HEAVY"}}],"filter":{"code":"MACHINE_CHAIN_HEAVY"}}