{"score_name": "CheckWebsiteNow Agent Readability Score", "score_model": "cwn-ars-1", "official": false, "method_url": "/agents#score", "scale": "0-100", "schema_version": "2.0", "calculation": ["Each check: pass = full weight, partial = half, fail = 0.", "Unknown and not applicable checks are removed from both the points and the maximum; they never count as passed.", "Score = 100 x earned points / measured points, rounded down (never up).", "No number is shown when the homepage is not readable public HTML or fewer than 70 of 100 points could be measured.", "Caps: all five AI search bots blocked caps the score at 39; a JavaScript-only shell (B1 fail) caps it at 49."], "minimum_coverage_percent": 70, "caps": [{"id": "search_bots_blocked", "max_score": 39}, {"id": "javascript_shell", "max_score": 49}], "bands": [{"id": "hard", "label": "Low agent readiness", "symbol": "✕", "min": 0, "max": 39}, {"id": "partly", "label": "Partly agent-ready", "symbol": "!", "min": 40, "max": 69}, {"id": "good", "label": "Good", "symbol": "✓", "min": 70, "max": 89}, {"id": "excellent", "label": "Excellent", "symbol": "✓✓", "min": 90, "max": 100}, {"id": "not_available", "label": "Not enough evidence", "symbol": "?", "min": null, "max": null}], "groups": [{"id": "A", "label": "AI bot access", "weight": 25}, {"id": "B", "label": "Readable content", "weight": 32}, {"id": "C", "label": "Structure and metadata", "weight": 20}, {"id": "D", "label": "Agent help and actions: llms.txt, MCP and WebMCP", "weight": 23}], "checks": [{"id": "A1", "group": "A", "label": "Public page answers with HTML", "weight": 10, "rule": "Pass: complete 2xx text/html without login or bot-challenge hints. Partial: such a hint. Fail: 404, 410, 5xx or no HTML. Unknown: 401/403/429, timeouts or framing we do not read (may only affect our probe).", "fix_title": "Serve readable HTML on your homepage"}, {"id": "A2", "group": "A", "label": "Search and user agents may read the homepage", "weight": 10, "rule": "robots.txt rules for Googlebot, Bingbot, OAI-SearchBot, Claude-SearchBot, PerplexityBot, ChatGPT-User, Claude-User and Perplexity-User on the final homepage path. Pass: none blocked (also no robots.txt). Partial: some blocked. Fail: all five search bots blocked. Training bots are never scored here.", "fix_title": "Let AI search and assistants read your homepage"}, {"id": "A3", "group": "A", "label": "Explicit AI usage policy", "weight": 5, "rule": "Rewards clarity, not openness. Pass: a robots.txt group for an AI-specific bot or a Content-Signal line (allow and disallow count the same). Partial: only general rules. Fail: no robots.txt.", "fix_title": "State your AI usage policy explicitly"}, {"id": "B1", "group": "B", "label": "Text is in the HTML (no JavaScript-only shell)", "weight": 12, "rule": "Visible text characters outside script, style, template, noscript and hidden elements. Pass: 500 or more. Partial: 100 to 499. Fail: under 100 (score capped at 49). Thresholds are our product rule.", "fix_title": "Put your main text in the HTML"}, {"id": "B2", "group": "B", "label": "Clear heading structure", "weight": 8, "rule": "Pass: exactly one visible h1 and at least one h2. Partial: headings, but no h1, several h1 or no h2. Fail: no headings.", "fix_title": "Use one <h1> and <h2> section headings"}, {"id": "B3", "group": "B", "label": "Landmarks, language, labels and alt text", "weight": 8, "rule": "Three parts: html lang; main landmark; at least 80 % of form fields labelled and images with alt (not applicable without fields or images). Pass: all applicable parts. Partial: at least half. Fail: fewer.", "fix_title": "Add language, a main landmark, labels and alt text"}, {"id": "B4", "group": "B", "label": "Markdown version for agents", "weight": 4, "rule": "Pass: the homepage answers Accept: text/markdown with text/markdown. Partial: Markdown is only advertised (alternate link or .md links in llms.txt). Fail: neither.", "fix_title": "Offer a Markdown version for agents"}, {"id": "C1", "group": "C", "label": "Title and description", "weight": 5, "rule": "Pass: non-empty title and meta description. Partial: one of them. Fail: neither.", "fix_title": "Add a title and a description"}, {"id": "C2", "group": "C", "label": "Indexable, with a canonical address", "weight": 5, "rule": "Fail: noindex in meta robots or X-Robots-Tag. Partial: no canonical link to this HTTPS host, or nosnippet / max-snippet:0. Pass: indexable with a canonical link to this HTTPS host.", "fix_title": "Stay indexable and set a canonical address"}, {"id": "C3", "group": "C", "label": "Structured data (JSON-LD)", "weight": 5, "rule": "Pass: at least one application/ld+json block that parses and has @type (directly or in @graph). Partial: blocks, but none valid. Fail: none. External @context is never fetched.", "fix_title": "Describe the page with schema.org JSON-LD"}, {"id": "C4", "group": "C", "label": "Sitemap", "weight": 5, "rule": "Pass: a same-origin sitemap (robots.txt Sitemap line, else /sitemap.xml) starts with urlset or sitemapindex (first 64 KiB, no XML parser). Partial: declared but on another origin or not confirmed. Fail: not declared and /sitemap.xml missing.", "fix_title": "Publish an XML sitemap"}, {"id": "D1", "group": "D", "label": "llms.txt guide", "weight": 5, "rule": "Optional; Google Search ignores it. Pass: /llms.txt as plain text or Markdown, first line an H1 (# ), at least one Markdown link. Partial: present without H1 or link. Fail: 404/410.", "fix_title": "Add a short /llms.txt guide (optional)"}, {"id": "D2", "group": "D", "label": "MCP and API discovery", "weight": 10, "rule": "Pass: valid /.well-known/api-catalog (RFC 9727 linkset), /.well-known/ard.json (Agentic Resource Discovery, a proposal: entries with identifier, type and url or data) or the older /.well-known/ai-catalog.json with entries, an MCP Server Card at /.well-known/mcp/server-card.json (name plus remote endpoint), or a same-origin rel=\"api-catalog\" / rel=\"service-desc\" / rel=\"ard\" link. Partial: llms.txt only mentions OpenAPI or MCP. Fail: nothing found. Advertised, not tested: endpoints are never called.", "fix_title": "Let agents find your API and MCP server"}, {"id": "D3", "group": "D", "label": "WebMCP browser tools declared", "weight": 8, "rule": "Pass: a form with toolname and tooldescription where every named field has toolparamdescription. Partial: toolname without descriptions, or an inline script calling modelContext registerTool. Fail: no static hint. Declared, not verified in a browser; external scripts are not loaded.", "fix_title": "Declare WebMCP browser tools on your main form"}], "mcp": "MCP discovery (D2) reads /.well-known/api-catalog, /.well-known/ard.json (Agentic Resource Discovery, a proposal), the MCP Server Card at /.well-known/mcp/server-card.json, homepage links and, last, the older /.well-known/ai-catalog.json. Advertised, not tested: endpoints are never called.", "webmcp": "WebMCP (D3) reads declarative form attributes (toolname, tooldescription, toolparamdescription) and inline scripts. Declared, not verified in a browser: runtime registration is only visible in a supporting browser.", "headline": "Every result carries a plain headline built from the checks, not from the band: whether agents can read the text (A1, B1), whether robots.txt lets AI search and assistants in (A2), and which optional helpers are missing (structured data, sitemap, Markdown, llms.txt, MCP or API discovery, WebMCP). A low number with readable text means few helpers, not unreadable content.", "training_bots": "Training opt-outs (GPTBot, ClaudeBot, Google-Extended, Applebot-Extended, CCBot, Meta-ExternalAgent) are an owner choice and never lower the score.", "limitations": ["Static inspection only; no browser scripts, forms or actual provider bots were executed.", "At most 9 HTTPS requests within a shared 10-second budget: homepage, robots.txt, llms.txt, three discovery files (api-catalog, ard.json, MCP Server Card), sitemap prefix, one Markdown negotiation and, last, the older ai-catalog.json, all on the final homepage origin; their redirects are followed only on that host and count towards the nine, so the older file is the first to stay unknown.", "No proof of search ranking, AI citations, actual bot access through firewalls or CDNs, or working WebMCP tools.", "MCP and API endpoints are only read as announcements; they are never called.", "Bot rules: RFC 9309 matching (user-agent groups, longest match, * and $ wildcards) for the final homepage path only; a robots.txt that redirects to another host or is not a robots file stays unknown.", "Homepage HTML is read up to 1 MiB; a larger homepage is analysed from its first 1 MiB (homepage_truncated). 64 KiB per text file is an inspection cap; sitemap and Markdown use only the first 64 KiB.", "Only the final homepage is scored; subpages and the accuracy of llms.txt, JSON-LD or server cards are not checked.", "Plain chunked framing is supported; chunk extensions and other transfer codings remain unknown.", "Only the first validated public network address is contacted.", "Unknown checks are removed from the calculation and never count as passed."], "disclaimer": "CheckWebsiteNow Agent Readability Score: our own transparent score from static evidence (homepage HTML, robots.txt, llms.txt and discovery files). Not an official standard. It cannot see runtime WebMCP tools, firewall rules or whether a specific AI bot really gets through.", "source": "research/agent-check/AGENT-READABILITY-SCORE-2026-10.md"}