{"ok":true,"kind":"crawlcheck-rulebook","v":1,"generated_at":"2026-11-22T01:33:47.999Z","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":"ARD_MANIFEST_WARNINGS","kind":"scan","family":{"id":"ard","label":"Agentic resource discovery (ARD)"},"title":"The ARD manifest is valid but its entries will not be found by search","meaning":"The ARD manifest validates, but entries are missing representativeQueries (or carry fewer than 2 or more than 5), use a renamed media type, or carry non-standard parameters. The semantic index a registry builds comes from representativeQueries: an entry without them is a valid catalogue row that search never returns.","severity":{"level":"info"},"scored":true,"measured_on":"every scan","revision":{"current":1,"revised_at":null},"fix":{"advice":"Add 2 to 5 representativeQueries to every entry: the natural-language questions a person would ask that this resource answers. Rename application/mcp-server+json to application/mcp-server-card+json. Use the standard media types without extra parameters.","effort":"content","endpoint":null},"share_of_scans":{"pct":0.4,"scans":41,"of_scans":9304,"basis":"share of counted scans that carried it; the same numbers /data publishes"},"links":{"self":"https://crawlcheck.io/rules#ARD_MANIFEST_WARNINGS","api":"https://crawlcheck.io/api/rules?code=ARD_MANIFEST_WARNINGS","glossary":[],"workflow":null,"lineage":"https://crawlcheck.io/docs/lineage-coverage","explain_template":"https://crawlcheck.io/api/explain?id={report_id}&code=ARD_MANIFEST_WARNINGS"}}],"filter":{"code":"ARD_MANIFEST_WARNINGS"}}