https://www.heykleos.dev/

{
  "url": "https://www.heykleos.dev/",
  "timestamp": 1791657522925,
  "fetch": {
    "mode": "simple",
    "timeMs": 210,
    "htmlSizeBytes": 61668,
    "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": "Kleos — Seen by search. Cited by AI.",
    "excerpt": "Kleos is the SEO & AEO scanner for vibe coders — see how Google ranks you and whether ChatGPT, Claude & Perplexity cite you. 87 checks in one scan.",
    "byline": null,
    "siteName": "Kleos",
    "lang": "en",
    "contentLength": 3136,
    "metadata": {
      "description": "Kleos is the SEO & AEO scanner for vibe coders — see how Google ranks you and whether ChatGPT, Claude & Perplexity cite you. 87 checks in one scan.",
      "ogTitle": "Kleos — Seen by search. Cited by AI.",
      "ogDescription": "Kleos is the SEO & AEO scanner for vibe coders — see how Google ranks you and whether ChatGPT, Claude & Perplexity cite you. 87 checks in one scan.",
      "ogImage": "https://heykleos.dev/opengraph-image?023a13153e69b0f6",
      "ogType": "website",
      "canonical": "https://heykleos.dev",
      "lang": "en",
      "schemas": [
        {
          "@context": "https://schema.org",
          "@type": "Organization",
          "@id": "https://heykleos.dev/#organization",
          "name": "Kleos",
          "url": "https://heykleos.dev",
          "logo": "https://heykleos.dev/logo.png",
          "description": "The SEO & AEO scanner for vibe coders. Seen by search, cited by AI.",
          "contactPoint": {
            "@type": "ContactPoint",
            "contactType": "customer support",
            "url": "https://heykleos.dev/contact"
          }
        },
        {
          "@context": "https://schema.org",
          "@type": "WebSite",
          "@id": "https://heykleos.dev/#website",
          "name": "Kleos",
          "url": "https://heykleos.dev",
          "dateModified": "2026-08-08",
          "publisher": {
            "@id": "https://heykleos.dev/#organization"
          }
        },
        {
          "@context": "https://schema.org",
          "@type": "SoftwareApplication",
          "name": "Kleos",
          "url": "https://heykleos.dev",
          "description": "Kleos is the SEO & AEO scanner for vibe coders — see how Google ranks you and whether ChatGPT, Claude & Perplexity cite you. 87 checks in one scan.",
          "applicationCategory": "DeveloperApplication",
          "operatingSystem": "Web",
          "offers": [
            {
              "@type": "Offer",
              "name": "Solo plan",
              "price": 9.99,
              "priceCurrency": "USD"
            },
            {
              "@type": "Offer",
              "name": "Pro plan",
              "price": 19.99,
              "priceCurrency": "USD"
            }
          ]
        }
      ],
      "robotsMeta": null,
      "author": null,
      "generator": null,
      "markdownAlternateHref": null
    }
  },
  "markdown": "SEO · AEO · One scan\n\nYou shipped fast. Now find out how Google ranks you — and whether ChatGPT, Claude & Perplexity ever mention you at all.\n\n87 checks · SEO + AEO · Results in ~30s\n\nBuilt for sites shipped onNext.jsAstroFramerWebflowLovablev0\n\nThe blind spot\n\n## You optimized for Google for fifteen years. Now half your traffic decides whether to visit you *before it ever loads your page* — inside an AI answer.\n\nVibe coders ship fast and skip the boring parts. Kleos is an SEO & AEO scanner that finds the gaps hurting your ranking and keeping you out of ChatGPT, Claude and Perplexity — in one scan.\n\nMeasured, not vibes: [Pew Research (2025)](https://www.pewresearch.org/short-reads/2025/07/22/google-users-are-less-likely-to-click-on-links-when-an-ai-summary-appears-in-the-results/) — clicks on regular results nearly halve when an AI summary appears.\n\n87\n\nchecks · Two engines\n\n## What does Kleos check?\n\n### Search Engine\nOptimization\n\nSEO\n\nHow Google crawls, ranks and renders you. 53 checks across six areas.\n\n-   ✓Meta & Open Graph tags\n-   ✓Core Web Vitals (LCP, CLS, INP)\n-   ✓Sitemap & robots.txt\n-   ✓Structured data / rich results\n-   ✓Mobile rendering\n-   ✓Indexability & canonicals\n\n### Answer Engine\nOptimization\n\nAEO\n\nWhether AI models can parse, trust and cite you. 34 checks across five areas.\n\n-   ○Cited-by-AI tracking (GPT, Claude, Perplexity)Soon\n-   ✓Schema markup for machines\n-   ✓llms.txt presence & quality\n-   ✓AI crawler access (GPTBot, ClaudeBot)\n-   ✓Content answerability\n-   ✓Brand entity clarity\n\nHow it works\n\n## From URL to shipped fix in one sitting.\n\n1.  01\n\n    ### Paste your URL\n\n    Drop in any live site. No install, no config — make an account and you're scanning.\n\n2.  02\n\n    ### Kleos scans 87 signals\n\n    We crawl your pages and run the same SEO checks Google uses — plus AEO checks the answer engines use.\n\n3.  03\n\n    ### Ship the fixes\n\n    Every finding ships with a copy-paste prompt your AI agent can act on. Re-scan on every deploy.\n\nThe Kleos difference\n\n## We don't just tell you what's broken. We hand your agent the fix.\n\nEvery finding ships with a copy-paste prompt written for Cursor, Claude Code and v0. Paste it, review the diff, ship. No SEO PhD required.\n\nfix-prompt · llms.txt.md\n\n\\# Fix: no llms.txt found\n\nCreate /public/llms.txt\n\ndescribing this\n\nsite for AI crawlers. Include the product\n\none-liner, primary pages, pricing URL, and\n\ncanonical docs links. Use the\n\n<h1>\n\nand meta\n\ndescription already on the homepage.\n\n✓ copied to clipboard\n\nPricing\n\n## Scan it. Then keep every page seen.\n\n### Solo\n\n$8 /mo$9.99\n\nBilled $96/yr · save $23.88\n\nFor the one site you actually ship.\n\n-   ✓1 site\n-   ✓10 scans/mo\n-   ✓All 87 SEO + AEO checks\n-   ✓Every finding unlocked\n-   ✓AI fix prompt for every issue\n-   Not included: Re-scan on every deploy\n-   Not included: Cited-by-AI tracking\n\n[Choose Solo](https://www.heykleos.dev/signup?next=%2Fbilling%2Fcheckout%3Fplan%3Dsolo%26period%3Dannual)\n\nMost popular\n\n### Pro\n\n$16 /mo$19.99\n\nBilled $192/yr · save $47.88\n\nFor the builder shipping every day.\n\n-   ✓3 sites\n-   ✓60 scans/mo\n-   ✓Re-scan on every deploy\n-   ✓Everything unlocked, forever\n-   ✓AI fix prompt for every issue\n-   ✓Cited-by-AI tracking over time\n-   ✓Weekly visibility digest\n-   ✓PDF export\n\n[Choose Pro →](https://www.heykleos.dev/signup?next=%2Fbilling%2Fcheckout%3Fplan%3Dpro%26period%3Dannual)\n\nComing soon\n\n### Studio\n\n$40 /mo$49.99\n\nBilled $480/yr · save $119.88\n\nFor the studio shipping client work.\n\n-   ✓25 sites\n-   ✓200 scans/mo\n-   ✓Everything in Pro\n-   ✓Shared workspace & scan history\n-   ✓Slack & GitHub issue export\n-   ✓White-label PDF reports\n-   ✓Priority support\n\nRunning more sites than Pro covers, or scanning on a client's behalf? [Talk to us →](https://www.heykleos.dev/contact)\n\nSEO · AEO · One scan\n\n## Find out what\nthe machines see.\n\n87 checks · SEO + AEO · Results in ~30s\n",
  "fullPageMarkdown": "Kleos — Seen by search. Cited by AI.\n\n[Kleos](https://www.heykleos.dev/)\n\n[Product](https://www.heykleos.dev/#product)[Checks](https://www.heykleos.dev/#checks)[Pricing](https://www.heykleos.dev/pricing)[Projects](https://www.heykleos.dev/dashboard)\n\n[Log in](https://www.heykleos.dev/login)[Sign up →](https://www.heykleos.dev/signup)\n\nSEO · AEO · One scan\n\n# Seen by search.\nCited by AI.\n\nYou shipped fast. Now find out how Google ranks you — and whether ChatGPT, Claude & Perplexity ever mention you at all.\n\nScan site →\n\n87 checks · SEO + AEO · Results in ~30s\n\nBuilt for sites shipped onNext.jsAstroFramerWebflowLovablev0\n\nThe blind spot\n\n## You optimized for Google for fifteen years. Now half your traffic decides whether to visit you *before it ever loads your page* — inside an AI answer.\n\nVibe coders ship fast and skip the boring parts. Kleos is an SEO & AEO scanner that finds the gaps hurting your ranking and keeping you out of ChatGPT, Claude and Perplexity — in one scan.\n\nMeasured, not vibes: [Pew Research (2025)](https://www.pewresearch.org/short-reads/2025/07/22/google-users-are-less-likely-to-click-on-links-when-an-ai-summary-appears-in-the-results/) — clicks on regular results nearly halve when an AI summary appears.\n\n87 checks · Two engines\n\n## What does Kleos check?\n\n### Search Engine\nOptimizationSEO\n\nHow Google crawls, ranks and renders you. 53 checks across six areas.\n\n-   ✓Meta & Open Graph tags\n-   ✓Core Web Vitals (LCP, CLS, INP)\n-   ✓Sitemap & robots.txt\n-   ✓Structured data / rich results\n-   ✓Mobile rendering\n-   ✓Indexability & canonicals\n\n### Answer Engine\nOptimizationAEO\n\nWhether AI models can parse, trust and cite you. 34 checks across five areas.\n\n-   ○Cited-by-AI tracking (GPT, Claude, Perplexity)Soon\n-   ✓Schema markup for machines\n-   ✓llms.txt presence & quality\n-   ✓AI crawler access (GPTBot, ClaudeBot)\n-   ✓Content answerability\n-   ✓Brand entity clarity\n\nHow it works\n\n## From URL to shipped fix in one sitting.\n\n1.  01\n\n    ### Paste your URL\n\n    Drop in any live site. No install, no config — make an account and you're scanning.\n\n2.  02\n\n    ### Kleos scans 87 signals\n\n    We crawl your pages and run the same SEO checks Google uses — plus AEO checks the answer engines use.\n\n3.  03\n\n    ### Ship the fixes\n\n    Every finding ships with a copy-paste prompt your AI agent can act on. Re-scan on every deploy.\n\nThe Kleos difference\n\n## We don't just tell you what's broken. We hand your agent the fix.\n\nEvery finding ships with a copy-paste prompt written for Cursor, Claude Code and v0. Paste it, review the diff, ship. No SEO PhD required.\n\nfix-prompt · llms.txt.md\n\n\\# Fix: no llms.txt found\n\nCreate /public/llms.txt describing this\n\nsite for AI crawlers. Include the product\n\none-liner, primary pages, pricing URL, and\n\ncanonical docs links. Use the <h1> and meta\n\ndescription already on the homepage.\n\n✓ copied to clipboard\n\nPricing\n\n## Scan it. Then keep every page seen.\n\nMonthlyAnnualSave 20%\n\n### Solo\n\n$8 /mo$9.99\n\nBilled $96/yr · save $23.88\n\nFor the one site you actually ship.\n\n-   ✓1 site\n-   ✓10 scans/mo\n-   ✓All 87 SEO + AEO checks\n-   ✓Every finding unlocked\n-   ✓AI fix prompt for every issue\n-   —Not included: Re-scan on every deploy\n-   —Not included: Cited-by-AI tracking\n\n[Choose Solo](https://www.heykleos.dev/signup?next=%2Fbilling%2Fcheckout%3Fplan%3Dsolo%26period%3Dannual)\n\nMost popular### Pro\n\n$16 /mo$19.99\n\nBilled $192/yr · save $47.88\n\nFor the builder shipping every day.\n\n-   ✓3 sites\n-   ✓60 scans/mo\n-   ✓Re-scan on every deploy\n-   ✓Everything unlocked, forever\n-   ✓AI fix prompt for every issue\n-   ✓Cited-by-AI tracking over time\n-   ✓Weekly visibility digest\n-   ✓PDF export\n\n[Choose Pro →](https://www.heykleos.dev/signup?next=%2Fbilling%2Fcheckout%3Fplan%3Dpro%26period%3Dannual)\n\nComing soon### Studio\n\n$40 /mo$49.99\n\nBilled $480/yr · save $119.88\n\nFor the studio shipping client work.\n\n-   ✓25 sites\n-   ✓200 scans/mo\n-   ✓Everything in Pro\n-   ✓Shared workspace & scan history\n-   ✓Slack & GitHub issue export\n-   ✓White-label PDF reports\n-   ✓Priority support\n\nComing soon\n\nRunning more sites than Pro covers, or scanning on a client's behalf? [Talk to us →](https://www.heykleos.dev/contact)\n\nSEO · AEO · One scan\n\n## Find out what\nthe machines see.\n\nScan site →\n\n87 checks · SEO + AEO · Results in ~30s\n",
  "markdownStats": {
    "images": 0,
    "links": 4,
    "tables": 0,
    "codeBlocks": 0,
    "headings": 14
  },
  "tokens": {
    "htmlTokens": 19252,
    "markdownTokens": 1116,
    "reduction": 18136,
    "reductionPercent": 94
  },
  "score": {
    "score": 88,
    "grade": "B",
    "rubricVersion": 3,
    "dimensions": {
      "accessibility": {
        "score": 100,
        "weight": 30,
        "grade": "A",
        "checks": {
          "content_without_js": {
            "score": 100,
            "weight": 55,
            "evidence": "proven",
            "details": "Content available without JavaScript"
          },
          "fast_content_position": {
            "score": 100,
            "weight": 25,
            "evidence": "plausible",
            "details": "Main content starts at 6% of HTML"
          },
          "reasonable_page_size": {
            "score": 100,
            "weight": 20,
            "evidence": "plausible",
            "details": "Page size: 60KB"
          }
        }
      },
      "aiDiscoverability": {
        "score": 70,
        "weight": 25,
        "grade": "C",
        "checks": {
          "robots_allows_ai_bots": {
            "score": 100,
            "weight": 35,
            "evidence": "proven",
            "details": "All major AI search bots allowed"
          },
          "supports_markdown_negotiation": {
            "score": 0,
            "weight": 20,
            "evidence": "plausible",
            "details": "No Markdown for Agents support detected"
          },
          "has_sitemap": {
            "score": 100,
            "weight": 15,
            "evidence": "plausible",
            "details": "Sitemap found"
          },
          "has_robots_txt": {
            "score": 100,
            "weight": 10,
            "evidence": "plausible",
            "details": "robots.txt exists"
          },
          "has_llms_txt": {
            "score": 100,
            "weight": 10,
            "evidence": "speculative",
            "details": "llms.txt exists and is valid"
          },
          "has_content_signals": {
            "score": 0,
            "weight": 10,
            "evidence": "speculative",
            "details": "No Content-Signal found (robots.txt or HTTP headers)",
            "mechanisms": {
              "robotsTxt": false,
              "httpHeader": false,
              "policy": false
            }
          }
        }
      },
      "structuredData": {
        "score": 100,
        "weight": 20,
        "grade": "A",
        "checks": {
          "has_schema_org": {
            "score": 100,
            "weight": 35,
            "evidence": "proven",
            "details": "JSON-LD found: Organization, WebSite, SoftwareApplication"
          },
          "has_open_graph": {
            "score": 100,
            "weight": 20,
            "evidence": "plausible",
            "details": "All OG tags present"
          },
          "has_meta_description": {
            "score": 100,
            "weight": 20,
            "evidence": "plausible",
            "details": "Meta description: 147 chars"
          },
          "has_canonical_url": {
            "score": 100,
            "weight": 15,
            "evidence": "plausible",
            "details": "Canonical URL present"
          },
          "has_lang_attribute": {
            "score": 100,
            "weight": 10,
            "evidence": "plausible",
            "details": "lang=\"en\""
          }
        }
      },
      "semanticHtml": {
        "score": 86,
        "weight": 15,
        "grade": "B",
        "checks": {
          "proper_heading_hierarchy": {
            "score": 100,
            "weight": 30,
            "evidence": "plausible",
            "details": "Clean heading hierarchy"
          },
          "uses_article_or_main": {
            "score": 100,
            "weight": 25,
            "evidence": "plausible",
            "details": "Has <main>"
          },
          "semantic_elements": {
            "score": 32,
            "weight": 20,
            "evidence": "plausible",
            "details": "8 semantic elements, 74 divs (ratio: 10%)"
          },
          "meaningful_alt_texts": {
            "score": 100,
            "weight": 15,
            "evidence": "plausible",
            "details": "No images found"
          },
          "low_div_nesting": {
            "score": 100,
            "weight": 10,
            "evidence": "speculative",
            "details": "Avg div depth: 1.7, max: 3"
          }
        }
      },
      "contentEfficiency": {
        "score": 78,
        "weight": 10,
        "grade": "B",
        "checks": {
          "token_reduction_ratio": {
            "score": 100,
            "weight": 40,
            "evidence": "speculative",
            "details": "94% token reduction (HTML→Markdown)"
          },
          "content_to_noise_ratio": {
            "score": 25,
            "weight": 30,
            "evidence": "speculative",
            "details": "Content ratio: 5.1% (3136 content chars / 61668 HTML bytes)"
          },
          "reasonable_page_weight": {
            "score": 100,
            "weight": 20,
            "evidence": "speculative",
            "details": "HTML size: 60KB"
          },
          "minimal_inline_styles": {
            "score": 100,
            "weight": 10,
            "evidence": "speculative",
            "details": "0/349 elements with inline styles (0.0%)"
          }
        }
      }
    }
  },
  "recommendations": [
    {
      "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",
      "howToStepKeys": null,
      "effort": "significant",
      "estimatedImpact": 5,
      "maxImpact": 5,
      "evidence": "plausible",
      "checkScore": 0,
      "checkDetails": "No Markdown for Agents support detected"
    },
    {
      "id": "add_content_signals",
      "priority": "high",
      "category": "aiDiscoverability",
      "titleKey": "rec.add_content_signals.title",
      "descriptionKey": "rec.add_content_signals.description",
      "howToKey": "rec.add_content_signals.howto",
      "howToStepKeys": null,
      "effort": "quick-win",
      "estimatedImpact": 2.5,
      "maxImpact": 2.5,
      "evidence": "speculative",
      "checkScore": 0,
      "checkDetails": "No Content-Signal found (robots.txt or HTTP headers)"
    },
    {
      "id": "improve_content_ratio",
      "priority": "medium",
      "category": "contentEfficiency",
      "titleKey": "rec.improve_content_ratio.title",
      "descriptionKey": "rec.improve_content_ratio.description",
      "howToKey": "rec.improve_content_ratio.howto",
      "howToStepKeys": null,
      "effort": "moderate",
      "estimatedImpact": 2.3,
      "maxImpact": 3,
      "evidence": "speculative",
      "checkScore": 25,
      "checkDetails": "Content ratio: 5.1% (3136 content chars / 61668 HTML bytes)"
    },
    {
      "id": "add_semantic_elements",
      "priority": "medium",
      "category": "semanticHtml",
      "titleKey": "rec.add_semantic_elements.title",
      "descriptionKey": "rec.add_semantic_elements.description",
      "howToKey": "rec.add_semantic_elements.howto",
      "howToStepKeys": null,
      "effort": "moderate",
      "estimatedImpact": 2,
      "maxImpact": 3,
      "evidence": "plausible",
      "checkScore": 32,
      "checkDetails": "8 semantic elements, 74 divs (ratio: 10%)"
    }
  ],
  "llmsTxtPreview": "# Kleos\n\n> Kleos is the SEO & AEO scanner for vibe coders — see how Google ranks you and whether ChatGPT, Claude & Perplexity cite you. 87 checks in one scan.\n\n## Main\n- [Kleos — Seen by search. Cited by AI.](https://www.heykleos.dev/): Kleos is the SEO & AEO scanner for vibe coders — see how Google ranks you and whether ChatGPT, Claude & Perplexity cite…\n- [Pricing](https://www.heykleos.dev/pricing)\n- [About](https://www.heykleos.dev/about)\n- [Refunds](https://www.heykleos.dev/refunds)\n\n## Legal\n- [Privacy](https://www.heykleos.dev/privacy)\n- [Terms](https://www.heykleos.dev/terms)\n\n## Support\n- [Contact](https://www.heykleos.dev/contact)\n\n",
  "llmsTxtExisting": "# Kleos\n\n> Kleos is the SEO & AEO scanner for vibe coders — see how Google ranks you and whether ChatGPT, Claude & Perplexity cite you. 87 checks in one scan.\n\n## Pages\n\n- [Home](https://heykleos.dev/): What Kleos scans and why.\n- [Pricing](https://heykleos.dev/pricing): Plans, prices, and the FAQ.\n- [About](https://heykleos.dev/about): Who builds Kleos and the research behind it.\n- [Contact](https://heykleos.dev/contact): Message form for support, billing, and feedback.\n\n## Policies\n\n- [Privacy](https://heykleos.dev/privacy)\n- [Terms](https://heykleos.dev/terms)\n- [Refunds](https://heykleos.dev/refunds)",
  "emergingProtocols": {
    "oauthProtectedResource": {
      "exists": false,
      "url": "https://www.heykleos.dev/.well-known/oauth-protected-resource"
    },
    "oauthDiscovery": {
      "exists": false,
      "url": "https://www.heykleos.dev/.well-known/oauth-authorization-server"
    },
    "mcpServerCard": {
      "exists": false,
      "url": "https://www.heykleos.dev/.well-known/mcp/server-card.json",
      "draft": true
    },
    "a2aAgentCard": {
      "exists": false,
      "url": "https://www.heykleos.dev/.well-known/agent-card.json"
    },
    "apiCatalog": {
      "exists": false,
      "url": "https://www.heykleos.dev/.well-known/api-catalog"
    },
    "agentSkills": {
      "exists": false,
      "url": "https://www.heykleos.dev/.well-known/agent-skills/index.json",
      "draft": true
    },
    "count": 0,
    "total": 6
  },
  "botAccess": {
    "probed": true,
    "bot": "OAI-SearchBot",
    "controlStatus": 200,
    "botStatus": 200,
    "discriminates": false,
    "refusedAsBot": false,
    "edge": "Vercel",
    "verifiable": false,
    "detail": "This origin answers OAI-SearchBot exactly as it answers any other client (200). No edge-level filtering of AI crawlers observed."
  },
  "snippets": [
    {
      "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)