Analyzed URL
https://grapheneos.org
Measured 2 weeks ago
AI-Ready Score
Fair
out of 100
Token Savings
Score Breakdown
Emerging protocols
0 of 6 detectedWell-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.
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.
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.
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).
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.
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/)  ## [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/)  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
# 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
Has <main>
Clean heading hierarchy
8 semantic elements, 5 divs (ratio: 62%)
0/4 images with meaningful alt text
Avg div depth: 0.4, max: 1
Content Efficiency
61% token reduction (HTML→Markdown)
Content ratio: 41.1% (2876 content chars / 6997 HTML bytes)
0/124 elements with inline styles (0.0%)
HTML size: 7KB
AI Discoverability
No llms.txt found
robots.txt exists
All major AI bots allowed
Sitemap found
Structured Data
No JSON-LD / Schema.org found
All OG tags present
Meta description: 86 chars
Canonical URL present
lang="en"
Accessibility
Content available without JavaScript
Page size: 7KB
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\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\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.
Share your results
Or ask an AI to help you fix it
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 CloudflareEmbed your badge
Add this badge to your site. It updates automatically as your AI-readiness score changes.
<script src="https://agentready.md/badge.js" data-id="c9c6ac68-8fbc-4b47-84ac-00778dafbb81" data-domain="grapheneos.org"></script>
[](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.