AX Rush

AI readiness of whitehouse.gov

Measured on the home page. Overall grade: Poor.

whitehouse.gov

Poor · 30 passing checks, 20 warnings, 8 failures · 2.9s

ax-audit@3.6.0

LLMs.txt

  • /llms.txt not found

    Create a /llms.txt file at your site root following the llmstxt.org specification. It should be a Markdown file starting with "# Your Site Name" and include a description, sections, and links.

Agent Card (A2A)

  • /.well-known/agent.json not found

    Create a /.well-known/agent.json file following the A2A (Agent-to-Agent) protocol. It should include name, description, url, and skills fields describing your site's capabilities.

Security.txt

  • /.well-known/security.txt not found

    Create a /.well-known/security.txt file per RFC 9116. At minimum, include Contact: and Expires: fields. See https://securitytxt.org/ for a generator.

OpenAPI Spec

  • /.well-known/openapi.json not found

    Create a /.well-known/openapi.json file with your API specification following the OpenAPI 3.x standard. See https://swagger.io/specification/ for the spec.

MCP (Model Context Protocol)

  • /.well-known/mcp.json not found

    Create a /.well-known/mcp.json file describing your MCP server configuration. Include name, description, tools, and version fields. See https://modelcontextprotocol.io for the spec.

AI Well-Known

  • 0/5 emerging AI discovery files published

  • ai.txt not found

    Publish /.well-known/ai.txt declaring opt-in/opt-out signals for AI training. See https://site.spawning.ai/spawning-ai-txt for the format.

  • genai.txt not found

    Publish /.well-known/genai.txt declaring your generative-AI usage policy.

  • ai-plugin.json not found

    Publish /ai-plugin.json (legacy ChatGPT plugin manifest). Schema: name_for_model, description_for_model, api.url. Still consumed by some agents.

  • agents.json not found

    Publish /agents.json describing your site as a callable agent (OpenAgents / Wildcard emerging spec). Includes name, description, and operations[].

  • nlweb.json not found

    Publish /.well-known/nlweb.json (Microsoft NLWeb) so agents can interact with the site through a natural-language interface.

Content NegotiationInformational

  • Homepage does not serve Markdown via content negotiation

    Serve a Markdown representation of your pages when agents request "Accept: text/markdown". Agents like Claude Code and Cursor ask for it, and Markdown cuts token usage by ~80% vs HTML. Cloudflare ("Markdown for Agents") and Vercel can enable this without code changes.

  • No <link rel="alternate" type="text/markdown"> fallback found on the homepage

    If you cannot enable content negotiation, advertise a Markdown version with <link rel="alternate" type="text/markdown" href="/index.md"> so agents can discover it.

RSL LicenseInformational

  • No RSL license discovery found

    Declare machine-readable licensing terms for your content with Really Simple Licensing. Add to robots.txt: License: https://your-site.com/license.xml — then publish the RSL document. See https://rslstandard.org.

Meta Tags

  • No AI meta tags (ai:*) found

    Add AI meta tags to your HTML <head>: <meta name="ai:summary" content="Brief description">, <meta name="ai:content_type" content="website">, <meta name="ai:author" content="Your Name">.

  • No rel="alternate" link to llms.txt in HTML

    Add to your <head>: <link rel="alternate" type="text/plain" href="/llms.txt" title="LLM-optimized content">

  • No rel="alternate" link to agent.json in HTML

    Add to your <head>: <link rel="alternate" type="application/json" href="/.well-known/agent.json" title="Agent Card">

  • No rel="me" identity links found

    Add rel="me" links to verify your identity across platforms: <link rel="me" href="https://github.com/yourname">, <link rel="me" href="https://twitter.com/yourname">.

  • OpenGraph required tags present (og:title, og:description, og:url, og:type)

  • Twitter Card required tags present (twitter:card, twitter:title, twitter:description)

Robots.txt

  • /robots.txt exists

  • No core AI crawlers explicitly configured

    Add User-agent entries for core AI crawlers in your robots.txt. For each crawler, add: User-agent: <name> followed by Allow: / on the next line.

  • Sitemap directive present

  • No Content-Signal directive found (optional)

    Declare how crawlers may use your content after access with the Content Signals Policy, e.g.: Content-Signal: search=yes, ai-train=no. Known signals: search, ai-input, ai-train. Generate yours at contentsignals.org.

  • 0/48 known AI crawlers have explicit rules

    Add explicit User-agent entries for more AI crawlers to maximize discoverability.

Crawl EfficiencyInformational

  • Response compressed with Brotli (br)

  • No ETag or Last-Modified header — conditional requests unsupported

    Send an ETag or Last-Modified header so crawlers can revalidate with If-None-Match / If-Modified-Since and receive a cheap 304 Not Modified instead of the full body.

  • Homepage size is reasonable (292.9 KB decompressed)

HTTP Headers

  • 6/7 security headers present

  • No Link header for AI discovery (llms.txt, agent.json)

    Add a Link response header pointing to your AI discovery files: Link: </llms.txt>; rel="alternate"; type="text/plain", </.well-known/agent.json>; rel="alternate"; type="application/json"

HTML Rendering

  • Server-rendered content detected (710 words, 4869 chars of visible text)

  • Low text-to-markup ratio (1.6%)

    A very low text-to-markup ratio is a typical SPA-shell symptom. Inline more content directly into the HTML response.

  • Semantic landmarks present (main, header, footer, nav)

  • <h1> is empty

    Add meaningful text inside your <h1> element so agents can identify the page topic.

  • 23/23 <img> tags have alt attributes

SEO Basics

  • <title> is too short (15 chars): "The White House"

    Lengthen the title to 20-70 characters with a clear topic indicator.

  • Meta description is long (251 chars)

    Trim to 70-160 characters; longer descriptions get truncated.

  • Canonical URL: https://www.whitehouse.gov/

  • <html lang="en-US">

  • UTF-8 charset declared

  • Viewport meta present: "width=device-width, initial-scale=1"

Agent AccessInformational

  • ClaudeBot is allowed in robots.txt but its User-Agent is blocked

    Your WAF or bot management rejects this crawler token even though robots.txt permits it — the block is invisible to you but fatal for the agent. Check your firewall rules and AI-bot toggles (e.g., Cloudflare "Block AI Crawlers"). Note: if your WAF verifies bots cryptographically (Web Bot Auth / verified-bots lists), the real crawler may still pass while this unverified probe is rejected — verify against your WAF logs.

Sitemap

  • Sitemap located: https://www.whitehouse.gov/sitemap_index.xml

  • Content-Type is XML (text/xml)

  • Sitemap-index references 23 child sitemap(s)

  • 3/3 sample child sitemap(s) reachable

  • Sample yielded 2088 URL(s) across 3 child(ren)

  • Newest <lastmod> is recent (1 day(s) ago)

TLS / HTTPS

  • Site is served over HTTPS

  • HTTP requests redirect to HTTPS

  • HSTS max-age=31536000

  • HSTS includes subdomains

  • HSTS preload-eligible

Structured Data

  • 2 JSON-LD block(s) found

  • @context references schema.org

  • @graph array present (multi-entity structured data)

  • Key types found: Organization, WebSite, WebPage

  • BreadcrumbList present