Verified AgentReady.md certificate
Issued sig: 684a794d88bb2670 Verify →

Analyzed URL

https://grapheneos.org

Measured 2 weeks ago

Analyze another URL

AI-Ready Score

Fair

out of 100

Token Savings

HTML tokens 1812
Markdown tokens 703
Savings 61%

Score Breakdown

Semantic HTML 85/100
Content Efficiency 92/100
AI Discoverability 35/100
Structured Data 70/100
Accessibility 93/100

Emerging protocols

0 of 6 detected

Well-known endpoints AI agents look for. Detected here means an agent can discover and connect to your service automatically.

  • OAuth Protected Resource RFC 9728
    /.well-known/oauth-protected-resource
  • OAuth Discovery RFC 8414
    /.well-known/oauth-authorization-server
  • MCP Server Card SEP-1649 draft
    /.well-known/mcp/server-card.json
  • A2A Agent Card A2A v1.0
    /.well-known/agent-card.json
  • API Catalog RFC 9727
    /.well-known/api-catalog
  • Agent Skills index Discovery RFC v0.2.0 draft
    /.well-known/agent-skills/index.json

Doesn't stay fixed by itself. Monitoring isn't built yet — join the list and we'll tell you when it is.

You're on the list! We'll notify you when it launches.

What we measured No llms.txt found

Your site doesn't have an llms.txt file. This is the emerging standard for helping AI agents understand your site structure.

How to implement

Create an /llms.txt file following the llmstxt.org specification. Include a site description and links to your key pages.

Paste into a coding agent to make the fix

What we measured No Markdown for Agents support detected

Your site doesn't support Markdown for Agents. This Cloudflare standard lets AI agents request content in markdown format, reducing token usage by ~80%.

How to implement

Implement one or more: (1) Respond to Accept: text/markdown with markdown content. (2) Serve .md URLs (e.g., /page.md). (3) Add <link rel="alternate" type="text/markdown"> tags. (4) Add Link HTTP headers for markdown discovery.

Paste into a coding agent to make the fix

What we measured No Content-Signal found (robots.txt or HTTP headers)

No Content-Signal directives found. These tell AI agents how they may use your content (search indexing, AI input, training data). The recommended location is robots.txt.

How to implement

Add Content-Signal to your robots.txt: User-agent: *\nContent-Signal: search=yes, ai-input=yes, ai-train=no. You can also add it as an HTTP header on markdown responses.

Paste into a coding agent to make the fix

What we measured 0/4 images with meaningful alt text

Some images lack descriptive alt text. Good alt text helps AI agents understand image content and context.

How to implement

Add descriptive alt attributes to all images. Describe what the image shows, not just 'image' or 'photo'. For decorative images, use alt="" (empty).

Paste into a coding agent to make the fix

What we measured No JSON-LD / Schema.org found

No Schema.org structured data found. JSON-LD helps AI agents extract factual, structured information from your pages.

How to implement

Add a <script type="application/ld+json"> block with Schema.org markup. Use appropriate types: Article for blog posts, Product for products, Organization for your company page.

Paste into a coding agent to make the fix
Markdown tokens: 703
The private and secure mobile operating system with Android app compatibility. Developed as a non-profit open source project.

[Install GrapheneOS](https://grapheneos.org/install/)

![](https://grapheneos.org/f979bf77.pixel-7-pro.svg)

## [About](https://grapheneos.org/#about)

GrapheneOS is a privacy and security focused mobile OS with Android app compatibility developed as a non-profit [open source](https://grapheneos.org/source) project. It's focused on the research and development of privacy and security technology including substantial improvements to sandboxing, exploit mitigations and the permission model. It was founded in 2014 and was [formerly known as CopperheadOS](https://grapheneos.org/history/copperheados).

GrapheneOS improves the privacy and security of the OS from the bottom up. It deploys technologies to mitigate whole classes of vulnerabilities and make exploiting the most common sources of vulnerabilities substantially more difficult. It improves the security of both the OS and the apps running on it. The app sandbox and other security boundaries are fortified. GrapheneOS tries to avoid impacting the user experience with the privacy and security features. Ideally, the features can be designed so that they're always enabled with no impact on the user experience and no additional complexity like configuration options. It's not always feasible, and GrapheneOS does add various toggles for features like the Network permission, Sensors permission, restrictions when the device is locked (USB-C and pogo pins, camera, quick tiles), etc. along with more complex user-facing privacy and security features with their own UX.

The [features page](https://grapheneos.org/features) provides an overview of the substantial privacy and security improvements added by GrapheneOS to the Android Open Source Project (AOSP). Many of our past features were [contributed to AOSP, Linux and other projects to improve privacy and security for billions of users](https://grapheneos.org/faq#upstream) so they're no longer listed on our features page.

Official releases are available on the [releases page](https://grapheneos.org/releases) and installation instructions are on the [install page](https://grapheneos.org/install/).

GrapheneOS also develops various apps and services with a focus on privacy and security. Vanadium is a hardened variant of the Chromium browser and WebView specifically built for GrapheneOS. GrapheneOS also includes our minimal security-focused PDF Viewer, our hardware-based Auditor app providing local and remote verification and attestation of devices, our modern privacy and security focused camera app, and the externally developed Seedvault encrypted backup which was initially developed for inclusion in GrapheneOS.

## [No Google apps or services](https://grapheneos.org/#never-google-services)

GrapheneOS will never include either Google Play services or another implementation of Google services like microG. It's possible to install Play services as a set of fully sandboxed apps without special privileges via our [sandboxed Google Play compatibility layer](https://grapheneos.org/usage#sandboxed-google-play). See [the FAQ section](https://grapheneos.org/faq#google-services) for more details on our plans for filling in the gaps from not shipping Play services and Google apps.

## [Device support](https://grapheneos.org/faq#device-support)

See [the FAQ section on device support](https://grapheneos.org/faq#device-support).
GrapheneOS: the private and secure mobile OS

# [GrapheneOS](https://grapheneos.org/#grapheneos)

The private and secure mobile operating system with Android app compatibility. Developed as a non-profit open source project.

[Install GrapheneOS](https://grapheneos.org/install/)

![](https://grapheneos.org/f979bf77.pixel-7-pro.svg)

Get to know GrapheneOS

## [About](https://grapheneos.org/#about)

GrapheneOS is a privacy and security focused mobile OS with Android app compatibility developed as a non-profit [open source](https://grapheneos.org/source) project. It's focused on the research and development of privacy and security technology including substantial improvements to sandboxing, exploit mitigations and the permission model. It was founded in 2014 and was [formerly known as CopperheadOS](https://grapheneos.org/history/copperheados).

GrapheneOS improves the privacy and security of the OS from the bottom up. It deploys technologies to mitigate whole classes of vulnerabilities and make exploiting the most common sources of vulnerabilities substantially more difficult. It improves the security of both the OS and the apps running on it. The app sandbox and other security boundaries are fortified. GrapheneOS tries to avoid impacting the user experience with the privacy and security features. Ideally, the features can be designed so that they're always enabled with no impact on the user experience and no additional complexity like configuration options. It's not always feasible, and GrapheneOS does add various toggles for features like the Network permission, Sensors permission, restrictions when the device is locked (USB-C and pogo pins, camera, quick tiles), etc. along with more complex user-facing privacy and security features with their own UX.

The [features page](https://grapheneos.org/features) provides an overview of the substantial privacy and security improvements added by GrapheneOS to the Android Open Source Project (AOSP). Many of our past features were [contributed to AOSP, Linux and other projects to improve privacy and security for billions of users](https://grapheneos.org/faq#upstream) so they're no longer listed on our features page.

Official releases are available on the [releases page](https://grapheneos.org/releases) and installation instructions are on the [install page](https://grapheneos.org/install/).

GrapheneOS also develops various apps and services with a focus on privacy and security. Vanadium is a hardened variant of the Chromium browser and WebView specifically built for GrapheneOS. GrapheneOS also includes our minimal security-focused PDF Viewer, our hardware-based Auditor app providing local and remote verification and attestation of devices, our modern privacy and security focused camera app, and the externally developed Seedvault encrypted backup which was initially developed for inclusion in GrapheneOS.

## [No Google apps or services](https://grapheneos.org/#never-google-services)

GrapheneOS will never include either Google Play services or another implementation of Google services like microG. It's possible to install Play services as a set of fully sandboxed apps without special privileges via our [sandboxed Google Play compatibility layer](https://grapheneos.org/usage#sandboxed-google-play). See [the FAQ section](https://grapheneos.org/faq#google-services) for more details on our plans for filling in the gaps from not shipping Play services and Google apps.

## [Device support](https://grapheneos.org/faq#device-support)

See [the FAQ section on device support](https://grapheneos.org/faq#device-support).

Upload this file as /index.md on your server so AI agents can access a clean version of your page. You can also configure Accept: text/markdown content negotiation to serve it automatically.

Generated llms.txt for this single page

Download llms.txt
# GrapheneOS

> GrapheneOS is a security and privacy focused mobile OS with Android app compatibility.

## Documentation
- [FAQ](https://grapheneos.org/faq)

## Main
- [GrapheneOS: the private and secure mobile OS](https://grapheneos.org): GrapheneOS is a security and privacy focused mobile OS with Android app compatibility.
- [Features](https://grapheneos.org/features)
- [GrapheneOS](https://grapheneos.org/)
- [Install](https://grapheneos.org/install/)
- [Build](https://grapheneos.org/build)
- [Usage](https://grapheneos.org/usage)
- [Releases](https://grapheneos.org/releases)
- [Source](https://grapheneos.org/source)
- [History](https://grapheneos.org/history/)
- [Donate](https://grapheneos.org/donate)

## Blog
- [Articles](https://grapheneos.org/articles/)

## Support
- [FAQ](https://grapheneos.org/faq)
- [Contact](https://grapheneos.org/contact)

Full llms.txt requires domain-wide analysis (coming soon)

Upload this file to https://grapheneos.org/llms.txt at the root of your domain. AI agents like ChatGPT, Claude, and Perplexity check this file to understand your site structure.

Semantic HTML

Uses article or main element (100/100)

Has <main>

Proper heading hierarchy (100/100)

Clean heading hierarchy

Uses semantic HTML elements (100/100)

8 semantic elements, 5 divs (ratio: 62%)

Meaningful image alt texts (0/100)

0/4 images with meaningful alt text

Low div nesting depth (100/100)

Avg div depth: 0.4, max: 1

Content Efficiency

Good token reduction ratio (80/100)

61% token reduction (HTML→Markdown)

Good content-to-noise ratio (100/100)

Content ratio: 41.1% (2876 content chars / 6997 HTML bytes)

Minimal inline styles (100/100)

0/124 elements with inline styles (0.0%)

Reasonable page weight (100/100)

HTML size: 7KB

AI Discoverability

Has llms.txt file (0/100)

No llms.txt found

Has robots.txt file (100/100)

robots.txt exists

Robots.txt allows AI bots (100/100)

All major AI bots allowed

Has sitemap.xml (100/100)

Sitemap found

Markdown for Agents support (0/100)
&#10007; Accept: text/markdown &#10007; .md URL &#10007; <link> tag &#10007; Link header
Has Content-Signal (robots.txt or HTTP headers) (0/100)
&#10003; robots.txt &#10003; HTTP header &#10007; Policy

Structured Data

Has Schema.org / JSON-LD (0/100)

No JSON-LD / Schema.org found

Has Open Graph tags (100/100)

All OG tags present

Has meta description (100/100)

Meta description: 86 chars

Has canonical URL (100/100)

Canonical URL present

Has lang attribute (100/100)

lang="en"

Accessibility

Content available without JavaScript (100/100)

Content available without JavaScript

Reasonable page size (100/100)

Page size: 7KB

Content appears early in HTML (75/100)

Main content starts at 33% of HTML

{
  "url": "https://grapheneos.org",
  "timestamp": 1783252037087,
  "fetch": {
    "mode": "simple",
    "timeMs": 94,
    "htmlSizeBytes": 6997,
    "supportsMarkdown": false,
    "markdownAgents": {
      "contentNegotiation": false,
      "mdUrl": {
        "found": false,
        "url": null
      },
      "linkTag": {
        "found": false,
        "url": null
      },
      "linkHeader": {
        "found": false,
        "url": null
      },
      "responseHeaders": {
        "contentSignal": null,
        "xMarkdownTokens": null,
        "vary": null
      },
      "frontmatter": {
        "present": false,
        "fields": [],
        "level": "none"
      },
      "level": "none"
    },
    "statusCode": 200
  },
  "extraction": {
    "title": "GrapheneOS: the private and secure mobile OS",
    "excerpt": "GrapheneOS is a security and privacy focused mobile OS with Android app compatibility.",
    "byline": null,
    "siteName": "GrapheneOS",
    "lang": "en",
    "contentLength": 2876,
    "metadata": {
      "description": "GrapheneOS is a security and privacy focused mobile OS with Android app compatibility.",
      "ogTitle": "GrapheneOS: the private and secure mobile OS",
      "ogDescription": "GrapheneOS is a security and privacy focused mobile OS with Android app compatibility.",
      "ogImage": "https://grapheneos.org/opengraph.png",
      "ogType": "website",
      "canonical": "https://grapheneos.org/",
      "lang": "en",
      "schemas": [],
      "robotsMeta": null,
      "author": null,
      "generator": null,
      "markdownAlternateHref": null
    }
  },
  "markdown": "The private and secure mobile operating system with Android app compatibility. Developed as a non-profit open source project.\n\n[Install GrapheneOS](https://grapheneos.org/install/)\n\n![](https://grapheneos.org/f979bf77.pixel-7-pro.svg)\n\n## [About](https://grapheneos.org/#about)\n\nGrapheneOS is a privacy and security focused mobile OS with Android app compatibility developed as a non-profit [open source](https://grapheneos.org/source) project. It's focused on the research and development of privacy and security technology including substantial improvements to sandboxing, exploit mitigations and the permission model. It was founded in 2014 and was [formerly known as CopperheadOS](https://grapheneos.org/history/copperheados).\n\nGrapheneOS improves the privacy and security of the OS from the bottom up. It deploys technologies to mitigate whole classes of vulnerabilities and make exploiting the most common sources of vulnerabilities substantially more difficult. It improves the security of both the OS and the apps running on it. The app sandbox and other security boundaries are fortified. GrapheneOS tries to avoid impacting the user experience with the privacy and security features. Ideally, the features can be designed so that they're always enabled with no impact on the user experience and no additional complexity like configuration options. It's not always feasible, and GrapheneOS does add various toggles for features like the Network permission, Sensors permission, restrictions when the device is locked (USB-C and pogo pins, camera, quick tiles), etc. along with more complex user-facing privacy and security features with their own UX.\n\nThe [features page](https://grapheneos.org/features) provides an overview of the substantial privacy and security improvements added by GrapheneOS to the Android Open Source Project (AOSP). Many of our past features were [contributed to AOSP, Linux and other projects to improve privacy and security for billions of users](https://grapheneos.org/faq#upstream) so they're no longer listed on our features page.\n\nOfficial releases are available on the [releases page](https://grapheneos.org/releases) and installation instructions are on the [install page](https://grapheneos.org/install/).\n\nGrapheneOS also develops various apps and services with a focus on privacy and security. Vanadium is a hardened variant of the Chromium browser and WebView specifically built for GrapheneOS. GrapheneOS also includes our minimal security-focused PDF Viewer, our hardware-based Auditor app providing local and remote verification and attestation of devices, our modern privacy and security focused camera app, and the externally developed Seedvault encrypted backup which was initially developed for inclusion in GrapheneOS.\n\n## [No Google apps or services](https://grapheneos.org/#never-google-services)\n\nGrapheneOS will never include either Google Play services or another implementation of Google services like microG. It's possible to install Play services as a set of fully sandboxed apps without special privileges via our [sandboxed Google Play compatibility layer](https://grapheneos.org/usage#sandboxed-google-play). See [the FAQ section](https://grapheneos.org/faq#google-services) for more details on our plans for filling in the gaps from not shipping Play services and Google apps.\n\n## [Device support](https://grapheneos.org/faq#device-support)\n\nSee [the FAQ section on device support](https://grapheneos.org/faq#device-support).\n",
  "fullPageMarkdown": "GrapheneOS: the private and secure mobile OS\n\n# [GrapheneOS](https://grapheneos.org/#grapheneos)\n\nThe private and secure mobile operating system with Android app compatibility. Developed as a non-profit open source project.\n\n[Install GrapheneOS](https://grapheneos.org/install/)\n\n![](https://grapheneos.org/f979bf77.pixel-7-pro.svg)\n\nGet to know GrapheneOS\n\n## [About](https://grapheneos.org/#about)\n\nGrapheneOS is a privacy and security focused mobile OS with Android app compatibility developed as a non-profit [open source](https://grapheneos.org/source) project. It's focused on the research and development of privacy and security technology including substantial improvements to sandboxing, exploit mitigations and the permission model. It was founded in 2014 and was [formerly known as CopperheadOS](https://grapheneos.org/history/copperheados).\n\nGrapheneOS improves the privacy and security of the OS from the bottom up. It deploys technologies to mitigate whole classes of vulnerabilities and make exploiting the most common sources of vulnerabilities substantially more difficult. It improves the security of both the OS and the apps running on it. The app sandbox and other security boundaries are fortified. GrapheneOS tries to avoid impacting the user experience with the privacy and security features. Ideally, the features can be designed so that they're always enabled with no impact on the user experience and no additional complexity like configuration options. It's not always feasible, and GrapheneOS does add various toggles for features like the Network permission, Sensors permission, restrictions when the device is locked (USB-C and pogo pins, camera, quick tiles), etc. along with more complex user-facing privacy and security features with their own UX.\n\nThe [features page](https://grapheneos.org/features) provides an overview of the substantial privacy and security improvements added by GrapheneOS to the Android Open Source Project (AOSP). Many of our past features were [contributed to AOSP, Linux and other projects to improve privacy and security for billions of users](https://grapheneos.org/faq#upstream) so they're no longer listed on our features page.\n\nOfficial releases are available on the [releases page](https://grapheneos.org/releases) and installation instructions are on the [install page](https://grapheneos.org/install/).\n\nGrapheneOS also develops various apps and services with a focus on privacy and security. Vanadium is a hardened variant of the Chromium browser and WebView specifically built for GrapheneOS. GrapheneOS also includes our minimal security-focused PDF Viewer, our hardware-based Auditor app providing local and remote verification and attestation of devices, our modern privacy and security focused camera app, and the externally developed Seedvault encrypted backup which was initially developed for inclusion in GrapheneOS.\n\n## [No Google apps or services](https://grapheneos.org/#never-google-services)\n\nGrapheneOS will never include either Google Play services or another implementation of Google services like microG. It's possible to install Play services as a set of fully sandboxed apps without special privileges via our [sandboxed Google Play compatibility layer](https://grapheneos.org/usage#sandboxed-google-play). See [the FAQ section](https://grapheneos.org/faq#google-services) for more details on our plans for filling in the gaps from not shipping Play services and Google apps.\n\n## [Device support](https://grapheneos.org/faq#device-support)\n\nSee [the FAQ section on device support](https://grapheneos.org/faq#device-support).\n",
  "markdownStats": {
    "images": 1,
    "links": 13,
    "tables": 0,
    "codeBlocks": 0,
    "headings": 3
  },
  "tokens": {
    "htmlTokens": 1812,
    "markdownTokens": 703,
    "reduction": 1109,
    "reductionPercent": 61
  },
  "score": {
    "score": 73,
    "grade": "C",
    "dimensions": {
      "semanticHtml": {
        "score": 85,
        "weight": 20,
        "grade": "B",
        "checks": {
          "uses_article_or_main": {
            "score": 100,
            "weight": 20,
            "details": "Has <main>"
          },
          "proper_heading_hierarchy": {
            "score": 100,
            "weight": 25,
            "details": "Clean heading hierarchy"
          },
          "semantic_elements": {
            "score": 100,
            "weight": 20,
            "details": "8 semantic elements, 5 divs (ratio: 62%)"
          },
          "meaningful_alt_texts": {
            "score": 0,
            "weight": 15,
            "details": "0/4 images with meaningful alt text"
          },
          "low_div_nesting": {
            "score": 100,
            "weight": 20,
            "details": "Avg div depth: 0.4, max: 1"
          }
        }
      },
      "contentEfficiency": {
        "score": 92,
        "weight": 25,
        "grade": "A",
        "checks": {
          "token_reduction_ratio": {
            "score": 80,
            "weight": 40,
            "details": "61% token reduction (HTML→Markdown)"
          },
          "content_to_noise_ratio": {
            "score": 100,
            "weight": 30,
            "details": "Content ratio: 41.1% (2876 content chars / 6997 HTML bytes)"
          },
          "minimal_inline_styles": {
            "score": 100,
            "weight": 15,
            "details": "0/124 elements with inline styles (0.0%)"
          },
          "reasonable_page_weight": {
            "score": 100,
            "weight": 15,
            "details": "HTML size: 7KB"
          }
        }
      },
      "aiDiscoverability": {
        "score": 35,
        "weight": 25,
        "grade": "F",
        "checks": {
          "has_llms_txt": {
            "score": 0,
            "weight": 20,
            "details": "No llms.txt found"
          },
          "has_robots_txt": {
            "score": 100,
            "weight": 10,
            "details": "robots.txt exists"
          },
          "robots_allows_ai_bots": {
            "score": 100,
            "weight": 15,
            "details": "All major AI bots allowed"
          },
          "has_sitemap": {
            "score": 100,
            "weight": 10,
            "details": "Sitemap found"
          },
          "supports_markdown_negotiation": {
            "score": 0,
            "weight": 25,
            "details": "No Markdown for Agents support detected"
          },
          "has_content_signals": {
            "score": 0,
            "weight": 20,
            "details": "No Content-Signal found (robots.txt or HTTP headers)"
          }
        }
      },
      "structuredData": {
        "score": 70,
        "weight": 15,
        "grade": "C",
        "checks": {
          "has_schema_org": {
            "score": 0,
            "weight": 30,
            "details": "No JSON-LD / Schema.org found"
          },
          "has_open_graph": {
            "score": 100,
            "weight": 25,
            "details": "All OG tags present"
          },
          "has_meta_description": {
            "score": 100,
            "weight": 20,
            "details": "Meta description: 86 chars"
          },
          "has_canonical_url": {
            "score": 100,
            "weight": 15,
            "details": "Canonical URL present"
          },
          "has_lang_attribute": {
            "score": 100,
            "weight": 10,
            "details": "lang=\"en\""
          }
        }
      },
      "accessibility": {
        "score": 93,
        "weight": 15,
        "grade": "A",
        "checks": {
          "content_without_js": {
            "score": 100,
            "weight": 40,
            "details": "Content available without JavaScript"
          },
          "reasonable_page_size": {
            "score": 100,
            "weight": 30,
            "details": "Page size: 7KB"
          },
          "fast_content_position": {
            "score": 75,
            "weight": 30,
            "details": "Main content starts at 33% of HTML"
          }
        }
      }
    }
  },
  "recommendations": [
    {
      "id": "add_llms_txt",
      "priority": "critical",
      "category": "aiDiscoverability",
      "titleKey": "rec.add_llms_txt.title",
      "descriptionKey": "rec.add_llms_txt.description",
      "howToKey": "rec.add_llms_txt.howto",
      "effort": "quick-win",
      "estimatedImpact": 10,
      "checkScore": 0,
      "checkDetails": "No llms.txt found"
    },
    {
      "id": "add_markdown_negotiation",
      "priority": "critical",
      "category": "aiDiscoverability",
      "titleKey": "rec.add_markdown_negotiation.title",
      "descriptionKey": "rec.add_markdown_negotiation.description",
      "howToKey": "rec.add_markdown_negotiation.howto",
      "effort": "significant",
      "estimatedImpact": 6,
      "checkScore": 0,
      "checkDetails": "No Markdown for Agents support detected"
    },
    {
      "id": "add_content_signals",
      "priority": "critical",
      "category": "aiDiscoverability",
      "titleKey": "rec.add_content_signals.title",
      "descriptionKey": "rec.add_content_signals.description",
      "howToKey": "rec.add_content_signals.howto",
      "effort": "quick-win",
      "estimatedImpact": 5,
      "checkScore": 0,
      "checkDetails": "No Content-Signal found (robots.txt or HTTP headers)"
    },
    {
      "id": "improve_alt_texts",
      "priority": "critical",
      "category": "semanticHtml",
      "titleKey": "rec.improve_alt_texts.title",
      "descriptionKey": "rec.improve_alt_texts.description",
      "howToKey": "rec.improve_alt_texts.howto",
      "effort": "moderate",
      "estimatedImpact": 4,
      "checkScore": 0,
      "checkDetails": "0/4 images with meaningful alt text"
    },
    {
      "id": "add_schema_org",
      "priority": "high",
      "category": "structuredData",
      "titleKey": "rec.add_schema_org.title",
      "descriptionKey": "rec.add_schema_org.description",
      "howToKey": "rec.add_schema_org.howto",
      "effort": "moderate",
      "estimatedImpact": 6,
      "checkScore": 0,
      "checkDetails": "No JSON-LD / Schema.org found"
    }
  ],
  "llmsTxtPreview": "# GrapheneOS\n\n> GrapheneOS is a security and privacy focused mobile OS with Android app compatibility.\n\n## Documentation\n- [FAQ](https://grapheneos.org/faq)\n\n## Main\n- [GrapheneOS: the private and secure mobile OS](https://grapheneos.org): GrapheneOS is a security and privacy focused mobile OS with Android app compatibility.\n- [Features](https://grapheneos.org/features)\n- [GrapheneOS](https://grapheneos.org/)\n- [Install](https://grapheneos.org/install/)\n- [Build](https://grapheneos.org/build)\n- [Usage](https://grapheneos.org/usage)\n- [Releases](https://grapheneos.org/releases)\n- [Source](https://grapheneos.org/source)\n- [History](https://grapheneos.org/history/)\n- [Donate](https://grapheneos.org/donate)\n\n## Blog\n- [Articles](https://grapheneos.org/articles/)\n\n## Support\n- [FAQ](https://grapheneos.org/faq)\n- [Contact](https://grapheneos.org/contact)\n\n",
  "llmsTxtExisting": null,
  "emergingProtocols": {
    "oauthDiscovery": {
      "exists": false,
      "url": "https://grapheneos.org/.well-known/oauth-authorization-server"
    },
    "mcpServerCard": {
      "exists": false,
      "url": "https://grapheneos.org/.well-known/mcp.json"
    },
    "a2aAgentCard": {
      "exists": false,
      "url": "https://grapheneos.org/.well-known/agent.json"
    },
    "count": 0
  },
  "snippets": [
    {
      "id": "add_llms_txt",
      "title": "Create /llms.txt",
      "description": "Upload this file to your web root. It tells AI agents what your site is about and which pages matter.",
      "language": "markdown",
      "code": "# GrapheneOS\n\n> GrapheneOS is a security and privacy focused mobile OS with Android app compatibility.\n\n## Documentation\n- [FAQ](https://grapheneos.org/faq)\n\n## Main\n- [GrapheneOS: the private and secure mobile OS](https://grapheneos.org): GrapheneOS is a security and privacy focused mobile OS with Android app compatibility.\n- [Features](https://grapheneos.org/features)\n- [GrapheneOS](https://grapheneos.org/)\n- [Install](https://grapheneos.org/install/)\n- [Build](https://grapheneos.org/build)\n- [Usage](https://grapheneos.org/usage)\n- [Releases](https://grapheneos.org/releases)\n- [Source](https://grapheneos.org/source)\n- [History](https://grapheneos.org/history/)\n- [Donate](https://grapheneos.org/donate)\n\n## Blog\n- [Articles](https://grapheneos.org/articles/)\n\n## Support\n- [FAQ](https://grapheneos.org/faq)\n- [Contact](https://grapheneos.org/contact)\n\n",
      "filename": "/llms.txt"
    },
    {
      "id": "add_schema_org",
      "title": "Add Schema.org JSON-LD",
      "description": "Structured data helps AI agents understand the type, author, and purpose of your content.",
      "language": "html",
      "code": "<script type=\"application/ld+json\">\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"WebPage\",\n  \"name\": \"GrapheneOS: the private and secure mobile OS\",\n  \"description\": \"GrapheneOS is a security and privacy focused mobile OS with Android app compatibility.\",\n  \"url\": \"https://grapheneos.org\",\n  \"inLanguage\": \"en\",\n  \"isPartOf\": {\n    \"@type\": \"WebSite\",\n    \"name\": \"GrapheneOS\"\n  }\n}\n</script>",
      "filename": "<head>"
    },
    {
      "id": "add_content_signals",
      "title": "Add Content-Signal directives",
      "description": "Content-Signal tells AI agents how they may use your content. The canonical location is robots.txt, but you can also expose it as an HTTP header from any stack.",
      "language": "txt",
      "code": "User-agent: *\nContent-Signal: search=yes, ai-input=yes, ai-train=no",
      "filename": "/robots.txt",
      "stacks": [
        {
          "id": "robots",
          "label": "robots.txt",
          "language": "txt",
          "filename": "/robots.txt",
          "code": "User-agent: *\nContent-Signal: search=yes, ai-input=yes, ai-train=no"
        },
        {
          "id": "nginx",
          "label": "Nginx",
          "language": "nginx",
          "filename": "server block",
          "code": "# Inside your server { } block:\nadd_header Content-Signal \"search=yes, ai-input=yes, ai-train=no\" always;"
        },
        {
          "id": "apache",
          "label": "Apache",
          "language": "apache",
          "filename": ".htaccess",
          "code": "# In .htaccess (or VirtualHost):\nHeader set Content-Signal \"search=yes, ai-input=yes, ai-train=no\""
        },
        {
          "id": "wordpress",
          "label": "WordPress",
          "language": "php",
          "filename": "functions.php",
          "code": "<?php\n// In your theme's functions.php or a small mu-plugin\nadd_action('send_headers', function () {\n    header('Content-Signal: search=yes, ai-input=yes, ai-train=no');\n});\n\n// Optional: also append the directive to the dynamic robots.txt\nadd_filter('robots_txt', function ($output) {\n    return $output . \"\\nContent-Signal: search=yes, ai-input=yes, ai-train=no\\n\";\n}, 10, 1);"
        },
        {
          "id": "nextjs",
          "label": "Next.js",
          "language": "typescript",
          "filename": "middleware.ts",
          "code": "// middleware.ts (Next.js 13+ App Router or Pages Router)\nimport { NextResponse } from 'next/server';\nexport function middleware() {\n  const res = NextResponse.next();\n  res.headers.set(\n    'Content-Signal',\n    'search=yes, ai-input=yes, ai-train=no'\n  );\n  return res;\n}\nexport const config = { matcher: '/:path*' };"
        },
        {
          "id": "cloudflare",
          "label": "Cloudflare Workers",
          "language": "javascript",
          "filename": "worker.js",
          "code": "// Cloudflare Worker that proxies your origin and adds the header\nexport default {\n  async fetch(request, env, ctx) {\n    const res = await fetch(request);\n    const newRes = new Response(res.body, res);\n    newRes.headers.set(\n      'Content-Signal',\n      'search=yes, ai-input=yes, ai-train=no'\n    );\n    return newRes;\n  },\n};"
        },
        {
          "id": "express",
          "label": "Express / Fastify",
          "language": "javascript",
          "filename": "server.js",
          "code": "// Express\napp.use((req, res, next) => {\n  res.setHeader('Content-Signal', 'search=yes, ai-input=yes, ai-train=no');\n  next();\n});\n\n// Fastify\nfastify.addHook('onSend', (request, reply, payload, done) => {\n  reply.header('Content-Signal', 'search=yes, ai-input=yes, ai-train=no');\n  done();\n});"
        }
      ]
    },
    {
      "id": "add_markdown_negotiation",
      "title": "Support Markdown for Agents",
      "description": "Let AI agents request a clean Markdown version of any page via content negotiation, .md alternate URLs, link tags or Link headers.",
      "language": "html",
      "code": "<!-- Mechanism 3: link tag advertising the .md alternate -->\n<link rel=\"alternate\" type=\"text/markdown\" href=\"/page.md\">",
      "filename": "<head>",
      "stacks": [
        {
          "id": "html",
          "label": "HTML <head>",
          "language": "html",
          "filename": "<head>",
          "code": "<!-- Mechanism 3: link tag advertising the .md alternate -->\n<link rel=\"alternate\" type=\"text/markdown\" href=\"/page.md\">"
        },
        {
          "id": "express",
          "label": "Express",
          "language": "javascript",
          "filename": "server.js",
          "code": "// Mechanisms 1 + 4: content negotiation + Link header\napp.get('/page', (req, res) => {\n  res.setHeader('Vary', 'Accept');\n  res.setHeader('Link', '</page.md>; rel=\"alternate\"; type=\"text/markdown\"');\n  if ((req.headers.accept || '').includes('text/markdown')) {\n    res.type('text/markdown; charset=utf-8');\n    return res.send(renderMarkdown('page'));\n  }\n  res.render('page');\n});"
        },
        {
          "id": "fastify",
          "label": "Fastify",
          "language": "javascript",
          "filename": "server.js",
          "code": "// Mechanisms 1 + 4: content negotiation + Link header\nfastify.get('/page', async (req, reply) => {\n  reply.header('Vary', 'Accept');\n  reply.header('Link', '</page.md>; rel=\"alternate\"; type=\"text/markdown\"');\n  if ((req.headers.accept || '').includes('text/markdown')) {\n    return reply.type('text/markdown; charset=utf-8').send(renderMarkdown('page'));\n  }\n  return reply.view('/page.ejs');\n});"
        },
        {
          "id": "nextjs",
          "label": "Next.js",
          "language": "typescript",
          "filename": "app/page/route.ts",
          "code": "// Next.js App Router — Route Handler returning Markdown\nimport { NextRequest } from 'next/server';\nimport { renderMarkdown } from '@/lib/md';\nexport async function GET(req: NextRequest) {\n  const accept = req.headers.get('accept') || '';\n  if (accept.includes('text/markdown')) {\n    return new Response(await renderMarkdown('page'), {\n      headers: {\n        'Content-Type': 'text/markdown; charset=utf-8',\n        'Vary': 'Accept',\n      },\n    });\n  }\n  // Fall through to the page component\n  return new Response(null, { status: 404 });\n}"
        },
        {
          "id": "wordpress",
          "label": "WordPress",
          "language": "php",
          "filename": "functions.php",
          "code": "<?php\n// Mechanism 1: respond to Accept: text/markdown on the same URL\nadd_action('template_redirect', function () {\n    if (!is_singular()) return;\n    $accept = $_SERVER['HTTP_ACCEPT'] ?? '';\n    if (strpos($accept, 'text/markdown') === false) return;\n    header('Content-Type: text/markdown; charset=utf-8');\n    header('Vary: Accept');\n    $post = get_queried_object();\n    echo \"# \" . get_the_title($post) . \"\\n\\n\";\n    echo wp_strip_all_tags(apply_filters('the_content', $post->post_content));\n    exit;\n});"
        },
        {
          "id": "static",
          "label": "Hugo / Jekyll / Astro",
          "language": "txt",
          "filename": "static/page.md",
          "code": "# Mechanism 2: serve .md alongside .html\n# Hugo: place page.md in /static/ — built unchanged\n# Jekyll: drop page.md in /assets/ — copied as-is\n# Astro: src/pages/page.md.ts that exports a GET returning markdown\n\n# Then advertise with mechanism 3 in <head>:\n#   <link rel=\"alternate\" type=\"text/markdown\" href=\"/page.md\">"
        }
      ]
    }
  ]
}

Use our API to get this programmatically (coming soon)

This JSON is for internal use — unlike the Markdown and llms.txt files, it's not meant to be uploaded to your site. Save it as a baseline to track your score over time, share it with your dev team, or integrate it into your CI/CD pipeline.

Want a second opinion?

Cloudflare runs a free scanner too, and it asks a different question. It scores what your site publishes for agents to call — MCP server cards, Agent Skills, API catalogs, DNS records. We score whether an agent can reach, read and understand your content. A site can do well on one and poorly on the other, so expect two different numbers: they are answers to two different questions, and both are worth knowing.

Scan grapheneos.org with Cloudflare

Embed your badge

Add this badge to your site. It updates automatically as your AI-readiness score changes.

AgentReady.md score for grapheneos.org
Script Recommended
<script src="https://agentready.md/badge.js" data-id="c9c6ac68-8fbc-4b47-84ac-00778dafbb81" data-domain="grapheneos.org"></script>
Markdown
[![AgentReady.md score for grapheneos.org](https://agentready.md/badge/grapheneos.org.svg)](https://agentready.md/r/c9c6ac68-8fbc-4b47-84ac-00778dafbb81)

Coming soon: Full Domain Analysis

Crawl your entire domain, generate llms.txt, and monitor your AI-readiness score over time. Join the waitlist to be notified.

You're on the list! We'll notify you when it launches.