{
 "version": "1",
 "collection": "checks",
 "about": "The checks AgentScore runs (scoring 2026.10-v8), with why each matters, who usually fixes it and the guide that explains it.",
 "updated": "2026-10-26",
 "count": 26,
 "items": [
  {
   "id": "access.robots",
   "title": "robots.txt lets AI assistants and search agents in",
   "category": "access",
   "weight": 3,
   "why": "If robots.txt shuts out AI assistants and AI search, they can't read your pages, so they leave you out of answers and recommendations.",
   "owner": "SEO or content team",
   "effort": "Hours",
   "guide": "https://ghostagentlab.com/articles/robots-txt-ai-agents/",
   "recipes": [
    "shopify/access.robots",
    "woocommerce/access.robots"
   ]
  },
  {
   "id": "access.bot-protection",
   "title": "Bot protection lets AI agents through",
   "category": "access",
   "weight": 4,
   "why": "When bot protection blocks AI agents, a person asking ChatGPT or Perplexity about you gets nothing back, or gets a competitor instead. Our test requests come from our servers, not the AI companies', so we also send one claiming to be Googlebot. If that's turned away too, your protection is checking where requests really come from, which is the right setup: we can't tell whether the real agents get through, so the check is skipped and never counts against you. A request that gets no answer within 15 seconds isn't counted as a block either; if every one times out, the check is skipped, and it's worth looking at your page speed.",
   "owner": "Bot protection or CDN admin",
   "effort": "Hours",
   "guide": "https://ghostagentlab.com/articles/bot-protection-ai-agents/",
   "recipes": []
  },
  {
   "id": "access.captcha",
   "title": "No CAPTCHA or challenge on arrival",
   "category": "access",
   "weight": 2,
   "why": "Agents can't solve CAPTCHAs. A challenge on arrival stops them before they see anything.",
   "owner": "Bot protection or CDN admin",
   "effort": "Hours",
   "guide": "https://ghostagentlab.com/articles/bot-protection-ai-agents/",
   "recipes": []
  },
  {
   "id": "access.llms-txt",
   "title": "llms.txt guide for AI",
   "category": "access",
   "weight": 1,
   "why": "An llms.txt file gives AI a quick, accurate summary of your business and key pages. It's new, so few competitors have one yet.",
   "owner": "SEO or content team",
   "effort": "Hours",
   "guide": "https://ghostagentlab.com/articles/llms-txt/",
   "recipes": []
  },
  {
   "id": "navigability.checkout-fields",
   "title": "Cart and checkout fields are labelled for agents",
   "category": "navigability",
   "weight": 3,
   "why": "Checkout is where agents most often fail. Clearly labelled fields let them enter details correctly and finish the order. When the empty cart shows no form, AgentScore adds one item to the cart, once, with the add-to-cart button (never “Buy now”), to see the checkout; it never fills in the form or orders anything.",
   "owner": "Developer",
   "effort": "Days",
   "guide": "https://ghostagentlab.com/articles/agent-ready-checkout/",
   "recipes": []
  },
  {
   "id": "access.guest-checkout",
   "title": "Shoppers can check out without an account",
   "category": "access",
   "weight": 2,
   "why": "An agent buying for someone can't easily create an account for them. Guest checkout lets the purchase go through. Most checkouts only open with something in the cart, so AgentScore adds one item, once, with the add-to-cart button (never “Buy now”), to look; it never fills in the form or orders anything.",
   "owner": "E-commerce platform admin",
   "effort": "Days",
   "guide": "https://ghostagentlab.com/articles/guest-checkout-ai-agents/",
   "recipes": [
    "shopify/access.guest-checkout",
    "woocommerce/access.guest-checkout"
   ]
  },
  {
   "id": "access.checkout-challenge",
   "title": "AI agents aren't blocked or shown a CAPTCHA at the cart and checkout",
   "category": "access",
   "weight": 3,
   "why": "A CAPTCHA or block at cart or checkout stops an agent at the last step, after it has done all the work, so the order is lost. If your bot protection checks where requests really come from, our test requests can't show whether real assistants get through, so a block isn't counted.",
   "owner": "Bot protection or CDN admin",
   "effort": "Hours",
   "guide": "https://ghostagentlab.com/articles/rate-limits-ai-agents/",
   "recipes": []
  },
  {
   "id": "readability.consistency",
   "title": "Price, stock and name agree everywhere agents read them",
   "category": "readability",
   "weight": 3,
   "why": "Agents read the price from your product data, the page and its sharing tags. When they disagree, assistants quote the wrong price or say something is in stock when it isn't, and shoppers who arrive expecting it leave.",
   "owner": "Developer",
   "effort": "Days",
   "guide": "https://ghostagentlab.com/articles/structured-data-ai-shopping-agents/",
   "recipes": [
    "shopify/readability.consistency",
    "woocommerce/readability.consistency"
   ]
  },
  {
   "id": "navigability.named-controls",
   "title": "Buttons and links have names",
   "category": "navigability",
   "weight": 4,
   "why": "Agents choose what to click by its name. A button with no text or label is invisible to them.",
   "owner": "Developer",
   "effort": "Days",
   "guide": "https://ghostagentlab.com/articles/agent-friendly-buttons-forms/",
   "recipes": []
  },
  {
   "id": "navigability.form-labels",
   "title": "Form fields are labelled",
   "category": "navigability",
   "weight": 2,
   "why": "Agents need labels to know what goes in each field. Unlabelled forms get filled in wrongly or abandoned.",
   "owner": "Developer",
   "effort": "Days",
   "guide": "https://ghostagentlab.com/articles/agent-friendly-buttons-forms/",
   "recipes": []
  },
  {
   "id": "navigability.overlay",
   "title": "Pop-ups and banners can be dismissed by agents",
   "category": "navigability",
   "weight": 4,
   "why": "A pop-up or cookie banner an agent can't close blocks everything behind it, so the journey ends there.",
   "owner": "Developer",
   "effort": "Days",
   "guide": "https://ghostagentlab.com/articles/agent-friendly-buttons-forms/",
   "recipes": []
  },
  {
   "id": "navigability.landmarks",
   "title": "Page has main and navigation landmarks",
   "category": "navigability",
   "weight": 2,
   "why": "Main and navigation landmarks help agents skip menus and go straight to the content.",
   "owner": "Developer",
   "effort": "Hours",
   "guide": "https://ghostagentlab.com/articles/agent-friendly-buttons-forms/",
   "recipes": []
  },
  {
   "id": "navigability.real-controls",
   "title": "Clickable things are real buttons and links",
   "category": "navigability",
   "weight": 2,
   "why": "Agents look for real buttons and links. Clickable areas built from plain boxes often aren't recognized as clickable at all.",
   "owner": "Developer",
   "effort": "Days",
   "guide": "https://ghostagentlab.com/articles/agent-friendly-buttons-forms/",
   "recipes": []
  },
  {
   "id": "access.key-pages",
   "title": "AI agents can open your product, pricing and cart pages",
   "category": "access",
   "weight": 3,
   "why": "Product, pricing and cart pages are what an assistant needs to answer “how much is it?” or help someone buy. If agents can't open them, the sale goes elsewhere. Each page is checked against the robots.txt of the address it's on, so www and non-www rules both count. If your bot protection checks where requests really come from, our test requests can't show whether real assistants get through, so a block isn't counted. A page that takes more than 15 seconds to answer our assistant request is left untested rather than counted as blocked.",
   "owner": "Bot protection or CDN admin",
   "effort": "Hours",
   "guide": "https://ghostagentlab.com/articles/bot-protection-ai-agents/",
   "recipes": []
  },
  {
   "id": "readability.product-data",
   "title": "Product pages give price and stock in a form agents can read",
   "category": "readability",
   "weight": 3,
   "why": "If price and stock aren't machine-readable on product pages, assistants can't say whether you have the item or what it costs.",
   "owner": "Developer",
   "effort": "Days",
   "guide": "https://ghostagentlab.com/articles/structured-data-ai-shopping-agents/",
   "recipes": [
    "shopify/readability.product-data",
    "woocommerce/readability.product-data"
   ]
  },
  {
   "id": "readability.prices",
   "title": "Prices are in the page HTML",
   "category": "readability",
   "weight": 2,
   "why": "When prices load with JavaScript, agents that don't run it see a product with no price, and often skip it. Prices are recognised in the currencies stores use most, with the symbol before or after the amount.",
   "owner": "Developer",
   "effort": "Days",
   "guide": "https://ghostagentlab.com/articles/login-walls-ai-agents/",
   "recipes": [
    "shopify/readability.prices",
    "woocommerce/readability.prices"
   ]
  },
  {
   "id": "navigability.key-pages-linked",
   "title": "Key pages are linked from the home page",
   "category": "navigability",
   "weight": 2,
   "why": "Agents start at the home page and follow links. If products, pricing and cart aren't linked there, agents may never find them.",
   "owner": "Developer",
   "effort": "Hours",
   "guide": "https://ghostagentlab.com/articles/link-key-pages-home-page/",
   "recipes": []
  },
  {
   "id": "navigability.purchase-control",
   "title": "Agents can find and press your add-to-cart or sign-up button",
   "category": "navigability",
   "weight": 3,
   "why": "If an agent can't find or press “Add to cart”, “Sign up” or “Book now”, it can't convert, however good the rest of the page is. If the product we check is sold out, we try up to two others, and if they're all sold out this check is skipped, so it never counts against you.",
   "owner": "Developer",
   "effort": "Days",
   "guide": "https://ghostagentlab.com/articles/agent-ready-checkout/",
   "recipes": []
  },
  {
   "id": "access.agent-interfaces",
   "title": "Agents can use your site through MCP or WebMCP",
   "category": "access",
   "weight": 1,
   "why": "MCP or WebMCP tools let agents search, check stock and build a cart directly, which is faster and more reliable than clicking through pages. A server description over 1 MB still counts: we read its start.",
   "owner": "Developer",
   "effort": "Weeks",
   "guide": "https://ghostagentlab.com/articles/mcp-webmcp-for-websites/",
   "recipes": []
  },
  {
   "id": "access.agentic-commerce",
   "title": "Agents can check out through an agentic commerce protocol",
   "category": "access",
   "weight": 1,
   "why": "Agentic commerce protocols let assistants like ChatGPT complete a purchase safely on a shopper's behalf. Early support puts you in front of those shoppers.",
   "owner": "E-commerce platform admin",
   "effort": "Weeks",
   "guide": "https://ghostagentlab.com/articles/agentic-commerce-protocols/",
   "recipes": []
  },
  {
   "id": "readability.no-js",
   "title": "Content loads without JavaScript",
   "category": "readability",
   "weight": 4,
   "why": "Most AI crawlers and many assistants don't run JavaScript. If your content only appears after scripts run, they see an empty page.",
   "owner": "Developer",
   "effort": "Weeks",
   "guide": "https://ghostagentlab.com/articles/javascript-content-ai-agents/",
   "recipes": []
  },
  {
   "id": "readability.structured-data",
   "title": "Structured data describes your business and products",
   "category": "readability",
   "weight": 3,
   "why": "Structured data tells agents exactly what you sell, at what price, and whether it's in stock, so they quote you correctly.",
   "owner": "Developer",
   "effort": "Days",
   "guide": "https://ghostagentlab.com/articles/structured-data-ai-shopping-agents/",
   "recipes": []
  },
  {
   "id": "readability.title",
   "title": "Clear page title, description, and headings",
   "category": "readability",
   "weight": 2,
   "why": "Clear titles, descriptions and headings are how agents work out what a page is about and whether it answers the question they were asked.",
   "owner": "SEO or content team",
   "effort": "Hours",
   "guide": "https://ghostagentlab.com/articles/titles-descriptions-headings-ai/",
   "recipes": []
  },
  {
   "id": "readability.image-alt",
   "title": "Images have text descriptions",
   "category": "readability",
   "weight": 1,
   "why": "Agents can't see images. Alt text tells them what a product photo shows.",
   "owner": "SEO or content team",
   "effort": "Days",
   "guide": "https://ghostagentlab.com/articles/image-alt-text-ai-agents/",
   "recipes": []
  },
  {
   "id": "readability.sitemap",
   "title": "Valid sitemap",
   "category": "readability",
   "weight": 2,
   "why": "A sitemap helps crawlers and agents find all your important pages, including ones that aren't linked from the home page. A sitemap over 50 MB or 50,000 URLs, the most crawlers and agents will read, is flagged: split it into smaller sitemaps so nothing gets missed.",
   "owner": "SEO or content team",
   "effort": "Hours",
   "guide": "https://ghostagentlab.com/articles/xml-sitemaps-ai-agents/",
   "recipes": []
  },
  {
   "id": "task.agent-run",
   "title": "An AI agent completes a real task",
   "category": "task",
   "weight": 1,
   "why": "This is the real test: can an AI agent actually finish a task on your site? The free scan has an agent try one, like adding a product to the cart. If it can't finish, the score can't go above 59. Ghost Agent tests measure more.",
   "owner": "Developer",
   "effort": "Days",
   "guide": null,
   "recipes": []
  }
 ]
}
