# AI readiness of notion.so

> Measured on the home page. Overall grade: Fair.

Score 61/100, grade Fair. Measured 2026-09-04T15:04:40.146+00:00, engine ax-audit@3.6.0.

## Checks

### LLMs.txt — 85/100

- **PASS** /llms.txt exists
- **PASS** /llms.txt Content-Type OK (text/plain)
- **WARN** Missing H1 heading (first line should start with "# ")
  Add an H1 heading as the first line of your llms.txt file, e.g.: # Your Site Name
  https://lucioduran.com/projects/ax-audit/guides/llms-txt#missing-h1
- **PASS** Blockquote description present
- **PASS** 7 section heading(s) found
- **PASS** 48 link(s) found
- **WARN** /llms-full.txt not found (optional but recommended)
  Create a /llms-full.txt with expanded content — full documentation, API details, and comprehensive site information for AI agents.
  https://lucioduran.com/projects/ax-audit/guides/llms-txt#missing-full

### Robots.txt — 57/100

- **PASS** /robots.txt exists
- **FAIL** No core AI crawlers explicitly configured
  Expected: GPTBot, ClaudeBot, ChatGPT-User, Claude-SearchBot, Google-Extended, PerplexityBot, OAI-SearchBot, CCBot
  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.
  https://lucioduran.com/projects/ax-audit/guides/robots-txt#no-core-crawlers
- **WARN** 1 AI crawler(s) explicitly blocked
  Amazonbot
  These crawlers have "Disallow: /" rules. If you want AI agents to access your site, change to "Allow: /" for each blocked crawler.
  https://lucioduran.com/projects/ax-audit/guides/robots-txt#explicitly-blocked
- **PASS** Sitemap directive present
- **WARN** 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.
  https://lucioduran.com/projects/ax-audit/guides/robots-txt#missing-content-signals
- **WARN** 1/48 known AI crawlers have explicit rules
  Add explicit User-agent entries for more AI crawlers to maximize discoverability.
  https://lucioduran.com/projects/ax-audit/guides/robots-txt#low-coverage

### Agent Card (A2A) — 0/100

- **FAIL** /.well-known/agent.json not found
  HTTP 404
  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.
  https://lucioduran.com/projects/ax-audit/guides/agent-json#not-found

### Security.txt — 100/100

- **PASS** /.well-known/security.txt exists
- **PASS** Required field "Contact" present
- **PASS** Required field "Expires" present
- **PASS** Expires date is in the future (2030-01-01)
- **PASS** 2/5 optional fields present

### Meta Tags — 54/100

- **WARN** 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">.
  https://lucioduran.com/projects/ax-audit/guides/meta-tags#no-ai-meta
- **WARN** 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">
  https://lucioduran.com/projects/ax-audit/guides/meta-tags#no-llms-alternate
- **WARN** 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">
  https://lucioduran.com/projects/ax-audit/guides/meta-tags#no-agent-alternate
- **WARN** 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">.
  https://lucioduran.com/projects/ax-audit/guides/meta-tags#no-rel-me
- **PASS** OpenGraph required tags present (og:title, og:description, og:url, og:type)
- **PASS** Twitter Card required tags present (twitter:card, twitter:title, twitter:description)

### OpenAPI Spec — 0/100

- **FAIL** /.well-known/openapi.json not found
  HTTP 404
  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.
  https://lucioduran.com/projects/ax-audit/guides/openapi#not-found

### MCP (Model Context Protocol) — 75/100

- **PASS** /.well-known/mcp.json exists
- **PASS** Valid JSON
- **PASS** Server name: "Notion"
- **PASS** Server description present
- **WARN** No tools array defined
  Add a "tools" array to your mcp.json. Each tool should have name, description, and inputSchema.
  https://lucioduran.com/projects/ax-audit/guides/mcp#no-tools
- **WARN** No resources defined
  Add a "resources" array listing the data resources your MCP server exposes to AI agents.
  https://lucioduran.com/projects/ax-audit/guides/mcp#no-resources
- **WARN** No protocol version specified
  Add a "protocolVersion" field (e.g., "2024-11-05") to declare MCP spec compatibility.
  https://lucioduran.com/projects/ax-audit/guides/mcp#no-version
- **PASS** CORS enabled on MCP endpoint

### Sitemap — 100/100

- **PASS** Sitemap located: https://www.notion.com/sitemap.xml
- **PASS** Content-Type is XML (application/xml)
- **PASS** Sitemap-index references 169 child sitemap(s)
- **PASS** 3/3 sample child sitemap(s) reachable
- **PASS** Sample yielded 274 URL(s) across 3 child(ren)
- **PASS** Newest <lastmod> is recent (17 day(s) ago)

### TLS / HTTPS — 100/100

- **PASS** Site is served over HTTPS
- **PASS** HTTP requests redirect to HTTPS
- **PASS** HSTS max-age=31536000
- **PASS** HSTS includes subdomains
- **PASS** HSTS preload-eligible

### AI Well-Known — 0/100

- **WARN** 0/5 emerging AI discovery files published
- **WARN** ai.txt not found
  Tried: /.well-known/ai.txt
  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.
  https://lucioduran.com/projects/ax-audit/guides/well-known-ai#ai-txt
- **WARN** genai.txt not found
  Tried: /.well-known/genai.txt
  Publish /.well-known/genai.txt declaring your generative-AI usage policy.
  https://lucioduran.com/projects/ax-audit/guides/well-known-ai#genai-txt
- **WARN** ai-plugin.json not found
  Tried: /.well-known/ai-plugin.json, /ai-plugin.json
  Publish /ai-plugin.json (legacy ChatGPT plugin manifest). Schema: name_for_model, description_for_model, api.url. Still consumed by some agents.
  https://lucioduran.com/projects/ax-audit/guides/well-known-ai#ai-plugin
- **WARN** agents.json not found
  Tried: /agents.json, /.well-known/agents.json
  Publish /agents.json describing your site as a callable agent (OpenAgents / Wildcard emerging spec). Includes name, description, and operations[].
  https://lucioduran.com/projects/ax-audit/guides/well-known-ai#agents-json
- **WARN** nlweb.json not found
  Tried: /.well-known/nlweb.json, /nlweb.json
  Publish /.well-known/nlweb.json (Microsoft NLWeb) so agents can interact with the site through a natural-language interface.
  https://lucioduran.com/projects/ax-audit/guides/well-known-ai#nlweb

### Content Negotiation — 0/100 (reports, does not score)

- **FAIL** Homepage does not serve Markdown via content negotiation
  Got text/html (HTTP 200) for "Accept: text/markdown"
  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.
  https://lucioduran.com/projects/ax-audit/guides/content-negotiation#not-supported
- **WARN** 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.
  https://lucioduran.com/projects/ax-audit/guides/content-negotiation#no-alternate

### RSL License — 0/100 (reports, does not score)

- **FAIL** No RSL license discovery found
  Checked robots.txt License directive, Link header, and <link rel="license" type="application/rsl+xml">
  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.
  https://lucioduran.com/projects/ax-audit/guides/rsl#not-found

### Agent Access — 100/100 (reports, does not score)

- **PASS** All 8 core AI crawler user-agents receive equivalent responses

### Structured Data — 0/100

- **FAIL** No JSON-LD structured data found
  Add a <script type="application/ld+json"> block in your HTML <head> with schema.org structured data describing your site, organization, or person.
  https://lucioduran.com/projects/ax-audit/guides/structured-data#not-found

### HTTP Headers — 70/100

- **FAIL** Missing critical header: X-Content-Type-Options
  Add the X-Content-Type-Options response header to your server configuration. This is a critical security header.
  https://lucioduran.com/projects/ax-audit/guides/http-headers#missing-critical-header
- **WARN** Only 3/7 security headers present
  Add security headers like Strict-Transport-Security, X-Content-Type-Options, X-Frame-Options, and Referrer-Policy to your server response.
  https://lucioduran.com/projects/ax-audit/guides/http-headers#low-security-headers
- **WARN** 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"
  https://lucioduran.com/projects/ax-audit/guides/http-headers#no-link-header

### HTML Rendering — 90/100

- **PASS** Server-rendered content detected (404 words, 2588 chars of visible text)
- **WARN** Low text-to-markup ratio (1.1%)
  Recommended minimum: 5%
  A very low text-to-markup ratio is a typical SPA-shell symptom. Inline more content directly into the HTML response.
  https://lucioduran.com/projects/ax-audit/guides/html-rendering#low-ratio
- **PASS** Semantic landmarks present (main, article, section, header, footer, nav)
- **PASS** Single <h1> heading: "Where teams and agents Think together."
- **PASS** 58/58 <img> tags have alt attributes

### SEO Basics — 100/100

- **PASS** <title> length 45 chars: "The AI workspace that works for you. | Notion"
- **PASS** Meta description length 124 chars
- **PASS** Canonical URL: https://www.notion.com/
- **PASS** <html lang="en-us">
- **PASS** UTF-8 charset declared
- **PASS** Viewport meta present: "width=device-width, initial-scale=1"

### Crawl Efficiency — 70/100 (reports, does not score)

- **PASS** Response compressed with gzip
  Brotli (br) typically compresses text 10–20% smaller — consider enabling it.
- **WARN** 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.
  https://lucioduran.com/projects/ax-audit/guides/crawl-efficiency#no-validators
- **PASS** Homepage size is reasonable (235.4 KB decompressed)

---

Markdown representation of https://axrush.com/report/notion.so
