Analyzed URL
https://www.ibm.com/design/event/
Measured yesterday
This site answers AI crawlers differently
We requested this page twice. As an ordinary client we got HTTP 200; announcing ourselves as OAI-SearchBot — the crawler that puts pages in ChatGPT's search index — we got HTTP 403. Something in front of your site is filtering by who is asking.
Our probe comes from our own servers, and Akamai verifies crawlers by IP address, not by name. So this refusal may be aimed at clients impersonating the crawler while the real one is let through — we cannot tell from outside. Check your bot rules in Akamai to see which it is. Nothing else in this report matters if the crawler never reaches your pages.
AI-Ready Score
Poor
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 Main content starts at 95% of HTML
The main content appears late in the HTML document. AI agents may give more weight to content that appears early.
How to implement
Restructure your HTML so that <main> or <article> content appears before sidebars and supplementary content.
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.
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 0/3 OG tags present
Missing or incomplete Open Graph tags. OG tags help AI agents (and social platforms) understand your page title, description, and image.
How to implement
Add og:title, og:description, and og:image meta tags to your page's <head>.
What we measured No sitemap found
No sitemap found. A sitemap helps AI agents discover all pages on your site.
How to implement
Create a /sitemap.xml listing all your public pages. Most CMS platforms can generate this automatically.
What we measured Page size: 699KB
Your page is larger than recommended. Large pages are slower to process and more expensive for AI agents.
How to implement
Optimize page size by minifying HTML, deferring non-critical scripts, and removing unused CSS.
What we measured robots.txt allows AI search bots, but the edge does not: This origin answers 200 to an ordinary client but 403 to a client identifying as OAI-SearchBot, behind Akamai. Whether the verified crawler is also turned away cannot be determined from outside: check the bot rules in your Akamai dashboard.
Your robots.txt blocks some AI bots (GPTBot, ClaudeBot, PerplexityBot). This prevents AI agents from indexing your content.
How to implement
Update your robots.txt to allow AI bots. Add explicit Allow rules for GPTBot, ClaudeBot, and PerplexityBot.
What we measured No canonical URL
No canonical URL found. This helps AI agents identify the preferred version of a page and avoid duplicate content.
How to implement
Add a <link rel="canonical" href="..."> tag pointing to the canonical URL of the page.
What we measured Content ratio: 0.0% (266 content chars / 715988 HTML bytes)
Your page has a low ratio of actual content to total HTML. Much of the page weight is markup, scripts, or styles rather than content.
How to implement
Move CSS to external stylesheets, remove inline styles, minimize JavaScript, and ensure the HTML focuses on content structure.
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.
Welcome IBM Event and Experience Design supports agency partners and event marketers with executing event programs for all audience types, venues and geographic locations. It includes turnkey booth models, environmental graphics, signage and messaging. [  ](https://www.ibm.com/design/event/gallery)
IBM Event Design [Skip to main content](https://www.ibm.com/design/event/#main-content)[IBM Event Design](https://www.ibm.com/design/event/) Search Switch sites Collapse navigation items Your browser does not support the video tag. Welcome IBM Event and Experience Design supports agency partners and event marketers with executing event programs for all audience types, venues and geographic locations. It includes turnkey booth models, environmental graphics, signage and messaging. [#### Overview  ](https://www.ibm.com/design/event/overview) [#### Approach ](https://www.ibm.com/design/event/booths/approach) [#### Models  ](https://www.ibm.com/design/event/booths/models/summary) [#### Activations  ](https://www.ibm.com/design/event/activations) [#### Copy placement ](https://www.ibm.com/design/event/booths/copy-placement/) [#### Finishes ](https://www.ibm.com/design/event/booths/finishes) [#### Graphics  ](https://www.ibm.com/design/event/graphics) [  #### Gallery ](https://www.ibm.com/design/event/gallery) [ Previous Home ](https://www.ibm.com/design/event/) [ Next Gallery ](https://www.ibm.com/design/event/gallery)
Upload this file as /design/event.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
# ibm.com > Learn about how IBM event design invites clients to engage with our brand and people—in settings that stimulate, connect and inspire innovation. ## Main - [IBM Event Design](https://www.ibm.com/design/event/): Learn about how IBM event design invites clients to engage with our brand and people—in settings that stimulate, connec… - [Skip to main content](https://www.ibm.com/) - [Carbon for IBM.com](https://www.ibm.com/standards/carbon/) - [IBM Workplace Design](https://www.ibm.com/design/workplace/) - [Enterprise Design Thinking](https://www.ibm.com/design/thinking/) - [IBM Accessibility](https://www.ibm.com/able/) - [IBM Design for AI](https://www.ibm.com/design/ai) - [IBM Design Research](https://www.ibm.com/design/research/) - [Gallery](https://www.ibm.com/design/event/gallery) ## Legal - [Privacy](https://www.ibm.com/privacy) - [Terms of use](https://www.ibm.com/legal)
Full llms.txt requires domain-wide analysis (coming soon)
Upload this file to https://www.ibm.com/llms.txt at the root of your domain. AI agents like ChatGPT, Claude, and Perplexity check this file to understand your site structure.
Accessibility
Content available without JavaScript
Main content starts at 95% of HTML
Page size: 699KB
AI Discoverability
robots.txt allows AI search bots, but the edge does not: This origin answers 200 to an ordinary client but 403 to a client identifying as OAI-SearchBot, behind Akamai. Whether the verified crawler is also turned away cannot be determined from outside: check the bot rules in your Akamai dashboard.
No sitemap found
robots.txt exists
No llms.txt found
Structured Data
No JSON-LD / Schema.org found
0/3 OG tags present
Meta description: 144 chars
No canonical URL
lang="en"
Semantic HTML
no <h1>
Has <main>
5 semantic elements, 94 divs (ratio: 5%)
5/5 images with meaningful alt text
Avg div depth: 5.1, max: 10
Content Efficiency
100% token reduction (HTML→Markdown)
Content ratio: 0.0% (266 content chars / 715988 HTML bytes)
HTML size: 699KB
20/381 elements with inline styles (5.2%)
{
"url": "https://www.ibm.com/design/event/",
"timestamp": 1791384975250,
"fetch": {
"mode": "simple",
"timeMs": 639,
"htmlSizeBytes": 715988,
"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": "IBM Event Design",
"excerpt": "Learn about how IBM event design invites clients to engage with our brand and people—in settings that stimulate, connect and inspire innovation.",
"byline": null,
"siteName": null,
"lang": "en",
"contentLength": 266,
"metadata": {
"description": "Learn about how IBM event design invites clients to engage with our brand and people—in settings that stimulate, connect and inspire innovation.",
"ogTitle": null,
"ogDescription": null,
"ogImage": null,
"ogType": null,
"canonical": null,
"lang": "en",
"schemas": [],
"robotsMeta": null,
"author": null,
"generator": "Gatsby 3.14.6",
"markdownAlternateHref": null
}
},
"markdown": "Welcome\n\nIBM Event and Experience Design supports agency partners and event marketers with executing event programs for all audience types, venues and geographic locations. It includes turnkey booth models, environmental graphics, signage and messaging.\n\n[\n\n\n\n](https://www.ibm.com/design/event/gallery)\n",
"fullPageMarkdown": "IBM Event Design\n\n[Skip to main content](https://www.ibm.com/design/event/#main-content)[IBM Event Design](https://www.ibm.com/design/event/)\n\nSearch\n\nSwitch sites\n\nCollapse navigation items\n\nYour browser does not support the video tag.\n\nWelcome\n\nIBM Event and Experience Design supports agency partners and event marketers with executing event programs for all audience types, venues and geographic locations. It includes turnkey booth models, environmental graphics, signage and messaging.\n\n[#### Overview\n\n\n\n](https://www.ibm.com/design/event/overview)\n\n[#### Approach\n\n](https://www.ibm.com/design/event/booths/approach)\n\n[#### Models\n\n\n\n](https://www.ibm.com/design/event/booths/models/summary)\n\n[#### Activations\n\n\n\n](https://www.ibm.com/design/event/activations)\n\n[#### Copy placement\n\n](https://www.ibm.com/design/event/booths/copy-placement/)\n\n[#### Finishes\n\n](https://www.ibm.com/design/event/booths/finishes)\n\n[#### Graphics\n\n\n\n](https://www.ibm.com/design/event/graphics)\n\n[\n\n\n\n#### Gallery\n\n](https://www.ibm.com/design/event/gallery)\n\n[\n\nPrevious\n\nHome\n\n](https://www.ibm.com/design/event/)\n\n[\n\nNext\n\nGallery\n\n](https://www.ibm.com/design/event/gallery)\n",
"markdownStats": {
"images": 1,
"links": 1,
"tables": 0,
"codeBlocks": 0,
"headings": 0
},
"tokens": {
"htmlTokens": 224558,
"markdownTokens": 124,
"reduction": 224434,
"reductionPercent": 100
},
"score": {
"score": 48,
"grade": "D",
"rubricVersion": 3,
"dimensions": {
"accessibility": {
"score": 63,
"weight": 30,
"grade": "C",
"checks": {
"content_without_js": {
"score": 100,
"weight": 55,
"evidence": "proven",
"details": "Content available without JavaScript"
},
"fast_content_position": {
"score": 0,
"weight": 25,
"evidence": "plausible",
"details": "Main content starts at 95% of HTML"
},
"reasonable_page_size": {
"score": 40,
"weight": 20,
"evidence": "plausible",
"details": "Page size: 699KB"
}
}
},
"aiDiscoverability": {
"score": 31,
"weight": 25,
"grade": "F",
"checks": {
"robots_allows_ai_bots": {
"score": 60,
"weight": 35,
"evidence": "proven",
"details": "robots.txt allows AI search bots, but the edge does not: This origin answers 200 to an ordinary client but 403 to a client identifying as OAI-SearchBot, behind Akamai. Whether the verified crawler is also turned away cannot be determined from outside: check the bot rules in your Akamai dashboard."
},
"supports_markdown_negotiation": {
"score": 0,
"weight": 20,
"evidence": "plausible",
"details": "No Markdown for Agents support detected"
},
"has_sitemap": {
"score": 0,
"weight": 15,
"evidence": "plausible",
"details": "No sitemap found"
},
"has_robots_txt": {
"score": 100,
"weight": 10,
"evidence": "plausible",
"details": "robots.txt exists"
},
"has_llms_txt": {
"score": 0,
"weight": 10,
"evidence": "speculative",
"details": "No llms.txt found"
},
"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": 30,
"weight": 20,
"grade": "F",
"checks": {
"has_schema_org": {
"score": 0,
"weight": 35,
"evidence": "proven",
"details": "No JSON-LD / Schema.org found"
},
"has_open_graph": {
"score": 0,
"weight": 20,
"evidence": "plausible",
"details": "0/3 OG tags present"
},
"has_meta_description": {
"score": 100,
"weight": 20,
"evidence": "plausible",
"details": "Meta description: 144 chars"
},
"has_canonical_url": {
"score": 0,
"weight": 15,
"evidence": "plausible",
"details": "No canonical URL"
},
"has_lang_attribute": {
"score": 100,
"weight": 10,
"evidence": "plausible",
"details": "lang=\"en\""
}
}
},
"semanticHtml": {
"score": 74,
"weight": 15,
"grade": "C",
"checks": {
"proper_heading_hierarchy": {
"score": 70,
"weight": 30,
"evidence": "plausible",
"details": "no <h1>"
},
"uses_article_or_main": {
"score": 100,
"weight": 25,
"evidence": "plausible",
"details": "Has <main>"
},
"semantic_elements": {
"score": 17,
"weight": 20,
"evidence": "plausible",
"details": "5 semantic elements, 94 divs (ratio: 5%)"
},
"meaningful_alt_texts": {
"score": 100,
"weight": 15,
"evidence": "plausible",
"details": "5/5 images with meaningful alt text"
},
"low_div_nesting": {
"score": 99,
"weight": 10,
"evidence": "speculative",
"details": "Avg div depth: 5.1, max: 10"
}
}
},
"contentEfficiency": {
"score": 44,
"weight": 10,
"grade": "D",
"checks": {
"token_reduction_ratio": {
"score": 100,
"weight": 40,
"evidence": "speculative",
"details": "100% token reduction (HTML→Markdown)"
},
"content_to_noise_ratio": {
"score": 0,
"weight": 30,
"evidence": "speculative",
"details": "Content ratio: 0.0% (266 content chars / 715988 HTML bytes)"
},
"reasonable_page_weight": {
"score": 20,
"weight": 20,
"evidence": "speculative",
"details": "HTML size: 699KB"
},
"minimal_inline_styles": {
"score": 0,
"weight": 10,
"evidence": "speculative",
"details": "20/381 elements with inline styles (5.2%)"
}
}
}
}
},
"recommendations": [
{
"id": "move_content_earlier",
"priority": "critical",
"category": "accessibility",
"titleKey": "rec.move_content_earlier.title",
"descriptionKey": "rec.move_content_earlier.description",
"howToKey": "rec.move_content_earlier.howto",
"howToStepKeys": null,
"effort": "moderate",
"estimatedImpact": 7.5,
"maxImpact": 7.5,
"evidence": "plausible",
"checkScore": 0,
"checkDetails": "Main content starts at 95% of HTML"
},
{
"id": "add_schema_org",
"priority": "critical",
"category": "structuredData",
"titleKey": "rec.add_schema_org.title",
"descriptionKey": "rec.add_schema_org.description",
"howToKey": "rec.add_schema_org.howto",
"howToStepKeys": null,
"effort": "moderate",
"estimatedImpact": 7,
"maxImpact": 7,
"evidence": "proven",
"checkScore": 0,
"checkDetails": "No JSON-LD / Schema.org 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",
"howToStepKeys": null,
"effort": "significant",
"estimatedImpact": 5,
"maxImpact": 5,
"evidence": "plausible",
"checkScore": 0,
"checkDetails": "No Markdown for Agents support detected"
},
{
"id": "add_open_graph",
"priority": "high",
"category": "structuredData",
"titleKey": "rec.add_open_graph.title",
"descriptionKey": "rec.add_open_graph.description",
"howToKey": "rec.add_open_graph.howto",
"howToStepKeys": null,
"effort": "quick-win",
"estimatedImpact": 4,
"maxImpact": 4,
"evidence": "plausible",
"checkScore": 0,
"checkDetails": "0/3 OG tags present"
},
{
"id": "add_sitemap",
"priority": "high",
"category": "aiDiscoverability",
"titleKey": "rec.add_sitemap.title",
"descriptionKey": "rec.add_sitemap.description",
"howToKey": "rec.add_sitemap.howto",
"howToStepKeys": null,
"effort": "quick-win",
"estimatedImpact": 3.8,
"maxImpact": 3.8,
"evidence": "plausible",
"checkScore": 0,
"checkDetails": "No sitemap found"
},
{
"id": "reduce_page_size",
"priority": "high",
"category": "accessibility",
"titleKey": "rec.reduce_page_size.title",
"descriptionKey": "rec.reduce_page_size.description",
"howToKey": "rec.reduce_page_size.howto",
"howToStepKeys": null,
"effort": "moderate",
"estimatedImpact": 3.6,
"maxImpact": 6,
"evidence": "plausible",
"checkScore": 40,
"checkDetails": "Page size: 699KB"
},
{
"id": "allow_ai_bots",
"priority": "high",
"category": "aiDiscoverability",
"titleKey": "rec.allow_ai_bots.title",
"descriptionKey": "rec.allow_ai_bots.description",
"howToKey": "rec.allow_ai_bots.howto",
"howToStepKeys": null,
"effort": "quick-win",
"estimatedImpact": 3.5,
"maxImpact": 8.8,
"evidence": "proven",
"checkScore": 60,
"checkDetails": "robots.txt allows AI search bots, but the edge does not: This origin answers 200 to an ordinary client but 403 to a client identifying as OAI-SearchBot, behind Akamai. Whether the verified crawler is also turned away cannot be determined from outside: check the bot rules in your Akamai dashboard."
},
{
"id": "add_canonical_url",
"priority": "high",
"category": "structuredData",
"titleKey": "rec.add_canonical_url.title",
"descriptionKey": "rec.add_canonical_url.description",
"howToKey": "rec.add_canonical_url.howto",
"howToStepKeys": null,
"effort": "quick-win",
"estimatedImpact": 3,
"maxImpact": 3,
"evidence": "plausible",
"checkScore": 0,
"checkDetails": "No canonical URL"
},
{
"id": "improve_content_ratio",
"priority": "high",
"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": 3,
"maxImpact": 3,
"evidence": "speculative",
"checkScore": 0,
"checkDetails": "Content ratio: 0.0% (266 content chars / 715988 HTML bytes)"
},
{
"id": "add_llms_txt",
"priority": "high",
"category": "aiDiscoverability",
"titleKey": "rec.add_llms_txt.title",
"descriptionKey": "rec.add_llms_txt.description",
"howToKey": "rec.add_llms_txt.howto",
"howToStepKeys": null,
"effort": "quick-win",
"estimatedImpact": 2.5,
"maxImpact": 2.5,
"evidence": "speculative",
"checkScore": 0,
"checkDetails": "No llms.txt found"
}
],
"llmsTxtPreview": "# ibm.com\n\n> Learn about how IBM event design invites clients to engage with our brand and people—in settings that stimulate, connect and inspire innovation.\n\n## Main\n- [IBM Event Design](https://www.ibm.com/design/event/): Learn about how IBM event design invites clients to engage with our brand and people—in settings that stimulate, connec…\n- [Skip to main content](https://www.ibm.com/)\n- [Carbon for IBM.com](https://www.ibm.com/standards/carbon/)\n- [IBM Workplace Design](https://www.ibm.com/design/workplace/)\n- [Enterprise Design Thinking](https://www.ibm.com/design/thinking/)\n- [IBM Accessibility](https://www.ibm.com/able/)\n- [IBM Design for AI](https://www.ibm.com/design/ai)\n- [IBM Design Research](https://www.ibm.com/design/research/)\n- [Gallery](https://www.ibm.com/design/event/gallery)\n\n## Legal\n- [Privacy](https://www.ibm.com/privacy)\n- [Terms of use](https://www.ibm.com/legal)\n\n",
"llmsTxtExisting": null,
"emergingProtocols": {
"oauthProtectedResource": {
"exists": false,
"url": "https://www.ibm.com/.well-known/oauth-protected-resource"
},
"oauthDiscovery": {
"exists": false,
"url": "https://www.ibm.com/.well-known/oauth-authorization-server"
},
"mcpServerCard": {
"exists": false,
"url": "https://www.ibm.com/.well-known/mcp/server-card.json",
"draft": true
},
"a2aAgentCard": {
"exists": false,
"url": "https://www.ibm.com/.well-known/agent-card.json"
},
"apiCatalog": {
"exists": false,
"url": "https://www.ibm.com/.well-known/api-catalog"
},
"agentSkills": {
"exists": false,
"url": "https://www.ibm.com/.well-known/agent-skills/index.json",
"draft": true
},
"count": 0,
"total": 6
},
"botAccess": {
"probed": true,
"bot": "OAI-SearchBot",
"controlStatus": 200,
"botStatus": 403,
"discriminates": true,
"refusedAsBot": true,
"edge": "Akamai",
"verifiable": false,
"detail": "This origin answers 200 to an ordinary client but 403 to a client identifying as OAI-SearchBot, behind Akamai. Whether the verified crawler is also turned away cannot be determined from outside: check the bot rules in your Akamai dashboard."
},
"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": "# ibm.com\n\n> Learn about how IBM event design invites clients to engage with our brand and people—in settings that stimulate, connect and inspire innovation.\n\n## Main\n- [IBM Event Design](https://www.ibm.com/design/event/): Learn about how IBM event design invites clients to engage with our brand and people—in settings that stimulate, connec…\n- [Skip to main content](https://www.ibm.com/)\n- [Carbon for IBM.com](https://www.ibm.com/standards/carbon/)\n- [IBM Workplace Design](https://www.ibm.com/design/workplace/)\n- [Enterprise Design Thinking](https://www.ibm.com/design/thinking/)\n- [IBM Accessibility](https://www.ibm.com/able/)\n- [IBM Design for AI](https://www.ibm.com/design/ai)\n- [IBM Design Research](https://www.ibm.com/design/research/)\n- [Gallery](https://www.ibm.com/design/event/gallery)\n\n## Legal\n- [Privacy](https://www.ibm.com/privacy)\n- [Terms of use](https://www.ibm.com/legal)\n\n",
"filename": "/llms.txt"
},
{
"id": "add_open_graph",
"title": "Add missing Open Graph tags",
"description": "Open Graph tags control how your page looks when shared on social media and how AI platforms preview your URL in answers.",
"language": "html",
"code": "<meta property=\"og:title\" content=\"IBM Event Design\">\n<meta property=\"og:description\" content=\"Learn about how IBM event design invites clients to engage with our brand and people—in settings that stimulate, connect and inspire innovation.\">\n<meta property=\"og:image\" content=\"https://yoursite.com/og-image.jpg\">\n<meta property=\"og:url\" content=\"https://www.ibm.com/design/event/\">\n<meta property=\"og:type\" content=\"website\">",
"filename": "<head>",
"stacks": [
{
"id": "html",
"label": "HTML <head>",
"language": "html",
"filename": "<head>",
"code": "<meta property=\"og:title\" content=\"IBM Event Design\">\n<meta property=\"og:description\" content=\"Learn about how IBM event design invites clients to engage with our brand and people—in settings that stimulate, connect and inspire innovation.\">\n<meta property=\"og:image\" content=\"https://yoursite.com/og-image.jpg\">\n<meta property=\"og:url\" content=\"https://www.ibm.com/design/event/\">\n<meta property=\"og:type\" content=\"website\">"
},
{
"id": "wordpress",
"label": "WordPress",
"language": "php",
"filename": "functions.php",
"code": "<?php\n// Quick Open Graph tags without a plugin (skip if Yoast / Rank Math is active)\nadd_action('wp_head', function () {\n if (!is_singular()) return;\n $post = get_queried_object();\n $title = get_the_title($post);\n $desc = get_the_excerpt($post) ?: wp_trim_words(strip_tags($post->post_content), 30);\n $image = get_the_post_thumbnail_url($post, 'large') ?: 'https://yoursite.com/og-image.jpg';\n $url = get_permalink($post);\n printf('<meta property=\"og:title\" content=\"%s\">' . \"\\n\", esc_attr($title));\n printf('<meta property=\"og:description\" content=\"%s\">' . \"\\n\", esc_attr($desc));\n printf('<meta property=\"og:image\" content=\"%s\">' . \"\\n\", esc_url($image));\n printf('<meta property=\"og:url\" content=\"%s\">' . \"\\n\", esc_url($url));\n echo '<meta property=\"og:type\" content=\"article\">' . \"\\n\";\n}, 5);"
},
{
"id": "nextjs",
"label": "Next.js",
"language": "typescript",
"filename": "app/page.tsx",
"code": "// Next.js App Router — Metadata API\nimport type { Metadata } from 'next';\n\nexport const metadata: Metadata = {\n title: \"IBM Event Design\",\n description: \"Learn about how IBM event design invites clients to engage with our brand and people—in settings that stimulate, connect and inspire innovation.\",\n openGraph: {\n title: \"IBM Event Design\",\n description: \"Learn about how IBM event design invites clients to engage with our brand and people—in settings that stimulate, connect and inspire innovation.\",\n url: \"https://www.ibm.com/design/event/\",\n images: [\"https://yoursite.com/og-image.jpg\"],\n type: 'website',\n },\n};"
}
]
},
{
"id": "add_canonical_url",
"title": "Add canonical URL",
"description": "The canonical URL tells AI agents which version of the page is the \"official\" one, avoiding duplicate content issues.",
"language": "html",
"code": "<link rel=\"canonical\" href=\"https://www.ibm.com/design/event/\">",
"filename": "<head>"
},
{
"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\": \"IBM Event Design\",\n \"description\": \"Learn about how IBM event design invites clients to engage with our brand and people—in settings that stimulate, connect and inspire innovation.\",\n \"url\": \"https://www.ibm.com/design/event/\",\n \"inLanguage\": \"en\"\n}\n</script>",
"filename": "<head>"
},
{
"id": "allow_ai_bots",
"title": "Allow AI bots in robots.txt",
"description": "Some AI bots are blocked in your robots.txt. Remove or modify these Disallow rules to let AI agents index your content.",
"language": "txt",
"code": "# Add to your robots.txt — explicitly allow AI bots:\nUser-agent: GPTBot\nAllow: /\n\nUser-agent: ClaudeBot\nAllow: /\n\nUser-agent: PerplexityBot\nAllow: /",
"filename": "/robots.txt"
},
{
"id": "add_sitemap",
"title": "Create /sitemap.xml",
"description": "A sitemap helps AI agents discover all your pages. Most CMS platforms generate one automatically.",
"language": "xml",
"code": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n <url>\n <loc>https://www.ibm.com/design/event/</loc>\n <lastmod>2026-10-07</lastmod>\n </url>\n</urlset>",
"filename": "/sitemap.xml"
},
{
"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 www.ibm.com 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="7870a3ad-d226-4aa5-b0f6-07a66ac3eeec" data-domain="www.ibm.com"></script>
[](https://agentready.md/r/ibm.com)
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.