{
 "version": "1",
 "collection": "guides",
 "about": "Every how-to guide and blog post. markdown is the full text as Markdown.",
 "updated": "2026-10-26",
 "count": 103,
 "items": [
  {
   "id": "post/your-product-page-is-an-api",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/your-product-page-is-an-api/",
   "markdown": "https://ghostagentlab.com/blog/your-product-page-is-an-api/index.html.md",
   "title": "Your product page is now an API",
   "description": "AI agents read product pages as data sources. Why stable URLs, structured data, prices in the HTML and one consistent price now matter as much as design.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/why-agentscore-is-rule-based",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/why-agentscore-is-rule-based/",
   "markdown": "https://ghostagentlab.com/blog/why-agentscore-is-rule-based/index.html.md",
   "title": "Why AgentScore scores with rules, not an AI model",
   "description": "Why AgentScore scores your site with fixed rules instead of an AI model, what rules get wrong, and where real AI agents belong in testing.",
   "published": "2026-10-20",
   "modified": "2026-10-21",
   "readMinutes": 6,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/what-ai-agents-cant-do-yet",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/what-ai-agents-cant-do-yet/",
   "markdown": "https://ghostagentlab.com/blog/what-ai-agents-cant-do-yet/index.html.md",
   "title": "What AI agents can't do on websites yet",
   "description": "An honest list of where today's AI agents stop on websites, from CAPTCHAs and logins to payment and custom widgets, and what to fix now versus wait for.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 5,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/should-you-build-an-mcp-server-yet",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/should-you-build-an-mcp-server-yet/",
   "markdown": "https://ghostagentlab.com/blog/should-you-build-an-mcp-server-yet/index.html.md",
   "title": "Should you build an MCP server yet?",
   "description": "A decision guide for leaders: who should build an MCP server now, who should wait, what to build first, the risks and costs, and the cheaper fixes first.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/server-rendered-html-is-back",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/server-rendered-html-is-back/",
   "markdown": "https://ghostagentlab.com/blog/server-rendered-html-is-back/index.html.md",
   "title": "AI agents are making server-rendered HTML matter again",
   "description": "AI agents that read raw HTML have turned server rendering and hydration into a business decision. What to render on the server and what to ask your team.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 6,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/questions-to-ask-your-ecommerce-platform",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/questions-to-ask-your-ecommerce-platform/",
   "markdown": "https://ghostagentlab.com/blog/questions-to-ask-your-ecommerce-platform/index.html.md",
   "title": "Questions to ask your e-commerce platform about AI agents",
   "description": "The questions to put to your e-commerce platform about bot protection, product data, checkout, agentic protocols and logs, and what good answers sound like.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/questions-for-your-cdn-vendor",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/questions-for-your-cdn-vendor/",
   "markdown": "https://ghostagentlab.com/blog/questions-for-your-cdn-vendor/index.html.md",
   "title": "Questions to ask your CDN or bot protection vendor",
   "description": "Questions to ask your CDN or bot protection vendor about verified bots, Web Bot Auth, AI crawler controls, challenges, rule order and logging for AI agents.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 6,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/how-agentscore-finds-product-pages",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/how-agentscore-finds-product-pages/",
   "markdown": "https://ghostagentlab.com/blog/how-agentscore-finds-product-pages/index.html.md",
   "title": "How AgentScore finds your product pages",
   "description": "How AgentScore finds a product page on your store: home page links, sitemaps, product cards and common paths, and how it decides what kind of site you run.",
   "published": "2026-10-20",
   "modified": "2026-10-21",
   "readMinutes": 7,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/five-agent-readiness-fixes-this-week",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/five-agent-readiness-fixes-this-week/",
   "markdown": "https://ghostagentlab.com/blog/five-agent-readiness-fixes-this-week/index.html.md",
   "title": "Five agent readiness fixes you can ship this week",
   "description": "Five quick fixes that help AI agents use your site, with who does each, how long it takes, how to check it, and the AgentScore check it moves.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/brief-your-agency-on-agent-readiness",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/brief-your-agency-on-agent-readiness/",
   "markdown": "https://ghostagentlab.com/blog/brief-your-agency-on-agent-readiness/index.html.md",
   "title": "How to brief your agency on agent readiness",
   "description": "How to write an agent readiness brief for your web, SEO or dev agency: scope, the checks to name, acceptance criteria, reporting and a template to copy.",
   "published": "2026-10-20",
   "modified": "2026-10-21",
   "readMinutes": 7,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/ai-agents-and-your-conversion-funnel",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/ai-agents-and-your-conversion-funnel/",
   "markdown": "https://ghostagentlab.com/blog/ai-agents-and-your-conversion-funnel/index.html.md",
   "title": "What AI agents do to your conversion funnel",
   "description": "When AI agents shop for people, discovery, browsing and comparison move out of sight. How the funnel changes, why reports mislead, and what to measure instead.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 6,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agentscore-v7-checkout-with-an-item",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agentscore-v7-checkout-with-an-item/",
   "markdown": "https://ghostagentlab.com/blog/agentscore-v7-checkout-with-an-item/index.html.md",
   "title": "AgentScore now checks your checkout with an item in the cart",
   "description": "AgentScore v7 adds one item to the cart to see your checkout form: what it presses, where it stops, and what happens when it can't add one.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agent-readiness-for-woocommerce-stores",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agent-readiness-for-woocommerce-stores/",
   "markdown": "https://ghostagentlab.com/blog/agent-readiness-for-woocommerce-stores/index.html.md",
   "title": "Agent readiness for WooCommerce stores: what you control",
   "description": "Agent readiness on WooCommerce: site visibility, robots.txt, structured data, caching and security plugins, guest checkout, block checkout and agentic commerce.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 6,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agent-readiness-for-travel-and-hospitality",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agent-readiness-for-travel-and-hospitality/",
   "markdown": "https://ghostagentlab.com/blog/agent-readiness-for-travel-and-hospitality/index.html.md",
   "title": "Agent readiness for hotels, tours and restaurants",
   "description": "How hotels, tour operators and restaurants can make booking widgets, date pickers, rates and cancellation terms work for AI agents booking for travelers.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 6,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agent-readiness-for-shopify-stores",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agent-readiness-for-shopify-stores/",
   "markdown": "https://ghostagentlab.com/blog/agent-readiness-for-shopify-stores/index.html.md",
   "title": "Agent readiness for Shopify stores: what you control",
   "description": "What Shopify handles for AI agents and what you control: robots.txt.liquid, llms.txt, theme structured data, CAPTCHAs, checkout sign-in and agentic storefronts.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agent-readiness-for-marketplaces",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agent-readiness-for-marketplaces/",
   "markdown": "https://ghostagentlab.com/blog/agent-readiness-for-marketplaces/index.html.md",
   "title": "Agent readiness for marketplaces: many sellers, one standard",
   "description": "How marketplaces can give AI agents consistent listings, clear seller details, shipping per seller, usable search and separate reviews across many sellers.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 6,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agent-readiness-for-local-businesses",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agent-readiness-for-local-businesses/",
   "markdown": "https://ghostagentlab.com/blog/agent-readiness-for-local-businesses/index.html.md",
   "title": "Agent readiness for local businesses",
   "description": "How restaurants, salons, clinics and trades can make hours, location, prices and booking clear to AI assistants, and keep their website and listings in step.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agent-readiness-for-grocery-and-food",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agent-readiness-for-grocery-and-food/",
   "markdown": "https://ghostagentlab.com/blog/agent-readiness-for-grocery-and-food/index.html.md",
   "title": "Agent readiness for grocery and food retailers",
   "description": "How grocery and food retailers can make postal code checks, delivery slots, minimum orders, unit prices, allergens and substitutions work for AI agents.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agent-readiness-for-fashion-retailers",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agent-readiness-for-fashion-retailers/",
   "markdown": "https://ghostagentlab.com/blog/agent-readiness-for-fashion-retailers/index.html.md",
   "title": "Agent readiness for fashion retailers: sizes, fit and returns",
   "description": "What AI agents are asked to do on fashion sites, where sizes, stock, fit guides and pop-ups trip them up, and the fixes to make first.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agent-readiness-for-b2b-ecommerce",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agent-readiness-for-b2b-ecommerce/",
   "markdown": "https://ghostagentlab.com/blog/agent-readiness-for-b2b-ecommerce/index.html.md",
   "title": "Agent readiness for B2B: catalogs, quotes and reorders",
   "description": "What buyers ask AI agents to do on B2B sites, what to make public and what can stay behind login, and the fixes for quotes, specs and reorders.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 6,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agentscore-verified-crawlers",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agentscore-verified-crawlers/",
   "markdown": "https://ghostagentlab.com/blog/agentscore-verified-crawlers/index.html.md",
   "title": "Why AgentScore stopped marking you down for checking who's visiting",
   "description": "AgentScore's test requests use AI assistants' names but come from our servers, so sites that verify visitors rightly turned them away and lost points. How we fixed it, and two other corrections.",
   "published": "2026-10-19",
   "modified": "2026-10-20",
   "readMinutes": 5,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/what-scanning-600-stores-taught-us",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/what-scanning-600-stores-taught-us/",
   "markdown": "https://ghostagentlab.com/blog/what-scanning-600-stores-taught-us/index.html.md",
   "title": "What scanning 600 stores taught us about our own scanner",
   "description": "Running AgentScore on 600 real stores exposed three bugs in our own scanner, and one run that looked perfect because almost nothing was tested. What we found, fixed and changed.",
   "published": "2026-10-09",
   "modified": "2026-10-20",
   "readMinutes": 5,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agentscore-store-study-2026",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agentscore-store-study-2026/",
   "markdown": "https://ghostagentlab.com/blog/agentscore-store-study-2026/index.html.md",
   "title": "We scanned 255 online stores with AgentScore. Here's what trips up AI agents",
   "description": "Most online stores let AI agents in, but many trip them up once inside: unnamed buttons, missing product data, and prices agents can't see. Results from 255 stores.",
   "published": "2026-10-09",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/what-an-ai-agent-sees",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/what-an-ai-agent-sees/",
   "markdown": "https://ghostagentlab.com/blog/what-an-ai-agent-sees/index.html.md",
   "title": "What an AI agent sees when it visits your store",
   "description": "One product page, three views: the raw HTML an assistant reads, the rendered page a browser agent sees, and the accessibility tree it acts on.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/holiday-season-agent-readiness",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/holiday-season-agent-readiness/",
   "markdown": "https://ghostagentlab.com/blog/holiday-season-agent-readiness/index.html.md",
   "title": "Getting agent-ready before the holiday rush",
   "description": "Bot rules, sale prices, stock, promo pop-ups and code freezes: what to check before peak season so AI agents can still find, price and buy.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 6,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agent-readiness-for-saas",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agent-readiness-for-saas/",
   "markdown": "https://ghostagentlab.com/blog/agent-readiness-for-saas/index.html.md",
   "title": "Agent readiness for software companies: pricing, sign-up and docs",
   "description": "For software companies, the pricing page is the product page and sign-up is the checkout. How to get pricing, trials, docs, llms.txt and MCP right.",
   "published": "2026-10-09",
   "modified": "2026-10-19",
   "readMinutes": 5,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/explain-agent-readiness-to-your-board",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/explain-agent-readiness-to-your-board/",
   "markdown": "https://ghostagentlab.com/blog/explain-agent-readiness-to-your-board/index.html.md",
   "title": "How to explain agent readiness to your board",
   "description": "A one-page way to explain agent readiness to your board: what's changing, the risks, what to measure and what to ask for, without hype or invented numbers.",
   "published": "2026-10-09",
   "modified": "2026-10-21",
   "readMinutes": 5,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agent-readiness-mistakes",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agent-readiness-mistakes/",
   "markdown": "https://ghostagentlab.com/blog/agent-readiness-mistakes/index.html.md",
   "title": "Seven agent readiness mistakes to avoid",
   "description": "Seven common agent readiness mistakes, from blocking AI assistants with training crawlers to measuring agents with JavaScript analytics, and how to avoid each.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/how-agentscore-renders-pages",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/how-agentscore-renders-pages/",
   "markdown": "https://ghostagentlab.com/blog/how-agentscore-renders-pages/index.html.md",
   "title": "How AgentScore renders your pages in a real browser",
   "description": "Which pages AgentScore opens in a headless browser, with what settings and safeguards, how it looks for WebMCP tools, and what it never does.",
   "published": "2026-10-09",
   "modified": "2026-10-21",
   "readMinutes": 6,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/reading-your-agentscore-report",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/reading-your-agentscore-report/",
   "markdown": "https://ghostagentlab.com/blog/reading-your-agentscore-report/index.html.md",
   "title": "Reading your AgentScore report: what to fix first",
   "description": "What each part of an AgentScore report means, from the verdict and statuses to severity and score impact, and how to turn it into a fix list.",
   "published": "2026-10-09",
   "modified": "2026-10-21",
   "readMinutes": 5,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/agent-traffic-is-not-bot-traffic",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/agent-traffic-is-not-bot-traffic/",
   "markdown": "https://ghostagentlab.com/blog/agent-traffic-is-not-bot-traffic/index.html.md",
   "title": "Agent traffic isn't bot traffic",
   "description": "Lumping AI agents in with scrapers hides customers. Why agent traffic needs its own categories, rules and reports, and how to start separating it.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 4,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/seo-to-agent-readiness",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/seo-to-agent-readiness/",
   "markdown": "https://ghostagentlab.com/blog/seo-to-agent-readiness/index.html.md",
   "title": "SEO got you found. Agent readiness gets you chosen",
   "description": "SEO decides whether AI agents find you. Agent readiness decides whether they can use your site and choose you. What carries over, and what's new.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/how-agentscore-works",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/how-agentscore-works/",
   "markdown": "https://ghostagentlab.com/blog/how-agentscore-works/index.html.md",
   "title": "How AgentScore works: what's behind the 100 points",
   "description": "How AgentScore turns its checks into a score out of 100: the four categories, how points are earned, which pages it visits, and what isn't scored yet.",
   "published": "2026-10-09",
   "modified": "2026-10-22",
   "readMinutes": 6,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/introducing-ghost-agents",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/introducing-ghost-agents/",
   "markdown": "https://ghostagentlab.com/blog/introducing-ghost-agents/index.html.md",
   "title": "Ghost Agents: testing your site with real AI agents",
   "description": "Ghost Agents are real AI agents that run your checkout, search and sign-up journeys on a schedule, with pass rates, step-by-step replays and alerts.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 4,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/accessibility-is-agent-readiness",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/accessibility-is-agent-readiness/",
   "markdown": "https://ghostagentlab.com/blog/accessibility-is-agent-readiness/index.html.md",
   "title": "Accessibility work is agent readiness work",
   "description": "Many browser agents read pages through the accessibility tree. Where WCAG and agent readiness overlap, where they differ, and how to make fixes pay twice.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/scanner-wears-other-names",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/scanner-wears-other-names/",
   "markdown": "https://ghostagentlab.com/blog/scanner-wears-other-names/index.html.md",
   "title": "Why our scanner sometimes wears other agents' names",
   "description": "AgentScore requests a few pages as ChatGPT, Claude, Perplexity and Googlebot, unsigned, to see how your site treats them. Here's exactly what and why.",
   "published": "2026-10-09",
   "modified": "2026-10-22",
   "readMinutes": 5,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/block-or-allow-ai-crawlers",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/block-or-allow-ai-crawlers/",
   "markdown": "https://ghostagentlab.com/blog/block-or-allow-ai-crawlers/index.html.md",
   "title": "Should you block AI crawlers? A decision guide for leaders",
   "description": "Blocking AI crawlers is several decisions, not one. How to decide on training crawlers, AI search and assistants, and how to enforce the policy.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 4,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/90-day-agent-readiness-plan",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/90-day-agent-readiness-plan/",
   "markdown": "https://ghostagentlab.com/blog/90-day-agent-readiness-plan/index.html.md",
   "title": "A 90-day agent readiness plan for e-commerce teams",
   "description": "A practical three-phase plan: let AI agents in, make pages readable and usable, then prove agents can finish checkout, mapped to AgentScore checks.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/who-owns-agent-readiness",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/who-owns-agent-readiness/",
   "markdown": "https://ghostagentlab.com/blog/who-owns-agent-readiness/index.html.md",
   "title": "Who owns agent readiness?",
   "description": "Agent readiness spans e-commerce, SEO, developers, security and legal. Who usually fixes what, and how to give the work one clear owner.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 4,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/next-customer-not-human",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/next-customer-not-human/",
   "markdown": "https://ghostagentlab.com/blog/next-customer-not-human/index.html.md",
   "title": "Your next customer won't be human",
   "description": "AI agents now read, compare and buy on people's behalf. Most websites can't see them, don't know if they succeed, and were never built for them. Here's what's changing.",
   "published": "2026-10-08",
   "modified": "2026-10-08",
   "readMinutes": 6,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "post/signed-requests",
   "kind": "post",
   "url": "https://ghostagentlab.com/blog/signed-requests/",
   "markdown": "https://ghostagentlab.com/blog/signed-requests/index.html.md",
   "title": "Why we sign every request our agents send",
   "description": "Anyone can copy a user agent. Here's how Ghost Agent Lab signs its scanner and Ghost Agent traffic with Web Bot Auth, and why every well-behaved agent should.",
   "published": "2026-10-08",
   "modified": "2026-10-08",
   "readMinutes": 5,
   "answer": null,
   "checks": [],
   "sources": []
  },
  {
   "id": "guide/agent-readiness",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/agent-readiness/",
   "markdown": "https://ghostagentlab.com/articles/agent-readiness/index.html.md",
   "title": "What is agent readiness? A complete guide",
   "description": "How well AI agents can get into your site, understand it, find their way around and complete tasks: what each part means, what good looks like, and where to start.",
   "published": "2026-10-08",
   "modified": "2026-10-08",
   "readMinutes": 8,
   "answer": {
    "question": "What is agent readiness, and why does it matter?",
    "text": "Agent readiness is how well AI agents can get into your website, understand it, find their way around and complete tasks for customers. An agent that can't use your site moves on and recommends one it can use. Start by checking your robots.txt, asking how your bot protection treats AI agents, and fixing the top three issues AgentScore lists."
   },
   "checks": [],
   "sources": [
    {
     "title": "RFC 9309: Robots Exclusion Protocol",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc9309.html"
    },
    {
     "title": "Product",
     "publisher": "schema.org",
     "url": "https://schema.org/Product"
    },
    {
     "title": "Sitemaps XML format",
     "publisher": "sitemaps.org",
     "url": "https://www.sitemaps.org/protocol.html"
    },
    {
     "title": "The /llms.txt file",
     "publisher": "llmstxt.org",
     "url": "https://llmstxt.org/"
    }
   ]
  },
  {
   "id": "guide/kinds-of-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/kinds-of-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/kinds-of-ai-agents/index.html.md",
   "title": "The AI agents that visit your website, and what each one wants",
   "description": "Training crawlers, AI search crawlers, assistant fetchers, browser agents and tool-using agents: what each does, what it needs from your site, and how to treat it.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 10,
   "answer": {
    "question": "Which AI agents visit my website, and how should I treat each?",
    "text": "Training crawlers, AI search crawlers, assistant fetchers, browser agents and tool-using agents each want different things. Block training crawlers in robots.txt if you choose, but allow AI search crawlers and assistant fetchers, and let verified browser agents through bot protection on product, cart and checkout pages. Keep blocking unknown bots, and add tools for agents once the basics work."
   },
   "checks": [],
   "sources": []
  },
  {
   "id": "guide/agent-readiness-glossary",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/agent-readiness-glossary/",
   "markdown": "https://ghostagentlab.com/articles/agent-readiness-glossary/index.html.md",
   "title": "Agent readiness glossary: the terms you'll hear, in plain English",
   "description": "Plain-English definitions of the terms behind agent readiness, from assistant fetchers and Web Bot Auth to structured data, the accessibility tree, MCP and AgentScore.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 11,
   "answer": {
    "question": "What do the main agent readiness terms mean?",
    "text": "Agent readiness is how well AI agents can get into your site, understand it, find their way around and complete tasks. Key terms include training crawlers, which collect pages for AI models, and assistant fetchers, which read a page because a person asked. Use them with developers and vendors, and run AgentScore to see where your site stands."
   },
   "checks": [],
   "sources": []
  },
  {
   "id": "guide/how-ai-assistants-choose-products",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/how-ai-assistants-choose-products/",
   "markdown": "https://ghostagentlab.com/articles/how-ai-assistants-choose-products/index.html.md",
   "title": "How AI assistants decide which products and stores to recommend",
   "description": "What's known and unknown about how AI assistants pick products and stores, and the three gates (read, verify, agree) your store must pass first.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 8,
   "answer": {
    "question": "How do AI assistants decide which products to recommend?",
    "text": "No AI company publishes how it ranks products, but an assistant must first read your pages, verify price, stock and policies, and find that your sources agree. Blocking its search crawler or fetcher can keep you out of its answers. Check that your ten best sellers show price, currency and availability in the HTML and in matching structured data."
   },
   "checks": [],
   "sources": [
    {
     "title": "AI features and your website",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/ai-features"
    },
    {
     "title": "Overview of OpenAI crawlers",
     "publisher": "OpenAI",
     "url": "https://developers.openai.com/api/docs/bots"
    },
    {
     "title": "Agentic Commerce: Get started (product feeds)",
     "publisher": "OpenAI",
     "url": "https://developers.openai.com/commerce/guides/get-started"
    },
    {
     "title": "Does Anthropic crawl data from the web, and how can site owners block the crawler?",
     "publisher": "Anthropic",
     "url": "https://support.claude.com/en/articles/8896518-does-anthropic-crawl-data-from-the-web-and-how-can-site-owners-block-the-crawler"
    },
    {
     "title": "Perplexity crawlers",
     "publisher": "Perplexity",
     "url": "https://docs.perplexity.ai/docs/resources/perplexity-crawlers"
    }
   ]
  },
  {
   "id": "guide/robots-txt-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/robots-txt-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/robots-txt-ai-agents/index.html.md",
   "title": "robots.txt for AI agents: who to allow and who to block",
   "description": "The three kinds of AI agent, the robots.txt names each one uses, a sensible default, and the most-specific-group rule that catches most people out.",
   "published": "2026-10-08",
   "modified": "2026-10-08",
   "readMinutes": 7,
   "answer": {
    "question": "Should I block AI crawlers in robots.txt?",
    "text": "Block only AI training crawlers, such as GPTBot and ClaudeBot, if you don't want your content used for training. Allow AI search crawlers and assistant fetchers, because they answer customers' questions about you and link back. Check your file for a leftover rule that blocks everything, and remember that a crawler follows only the most specific group that names it."
   },
   "checks": [
    "access.robots"
   ],
   "sources": [
    {
     "title": "RFC 9309: Robots Exclusion Protocol",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc9309.html"
    },
    {
     "title": "Overview of OpenAI Crawlers",
     "publisher": "OpenAI",
     "url": "https://developers.openai.com/api/docs/bots"
    },
    {
     "title": "Does Anthropic crawl data from the web, and how can site owners block the crawler?",
     "publisher": "Anthropic",
     "url": "https://support.claude.com/en/articles/8896518-does-anthropic-crawl-data-from-the-web-and-how-can-site-owners-block-the-crawler"
    },
    {
     "title": "List of Google's common crawlers",
     "publisher": "Google",
     "url": "https://developers.google.com/crawling/docs/crawlers-fetchers/google-common-crawlers"
    }
   ]
  },
  {
   "id": "guide/verify-ai-crawlers",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/verify-ai-crawlers/",
   "markdown": "https://ghostagentlab.com/articles/verify-ai-crawlers/index.html.md",
   "title": "How to tell if an AI crawler is real",
   "description": "Anyone can claim to be GPTBot or Googlebot. How to verify AI agents with published IP ranges, reverse DNS and signed requests, and what to do when there's no proof.",
   "published": "2026-10-08",
   "modified": "2026-10-08",
   "readMinutes": 7,
   "answer": {
    "question": "How do I tell if an AI crawler is real?",
    "text": "Check where the request came from, because anyone can copy a crawler's name. Use the strongest proof the operator offers: a Web Bot Auth signature, then published IP ranges, then forward-confirmed reverse DNS. Ask whether your CDN already verifies bots, and treat requests you can't verify as unknown, handled with rate limits rather than a hard block."
   },
   "checks": [],
   "sources": [
    {
     "title": "Verify requests from Google crawlers and fetchers",
     "publisher": "Google",
     "url": "https://developers.google.com/crawling/docs/crawlers-fetchers/verify-google-requests"
    },
    {
     "title": "Overview of OpenAI Crawlers",
     "publisher": "OpenAI",
     "url": "https://developers.openai.com/api/docs/bots"
    },
    {
     "title": "About Applebot",
     "publisher": "Apple",
     "url": "https://support.apple.com/en-us/119829"
    },
    {
     "title": "HTTP Message Signatures for automated traffic Architecture (Web Bot Auth draft)",
     "publisher": "IETF",
     "url": "https://datatracker.ietf.org/doc/draft-meunier-web-bot-auth-architecture/"
    }
   ]
  },
  {
   "id": "guide/bot-protection-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/bot-protection-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/bot-protection-ai-agents/index.html.md",
   "title": "Bot protection and CAPTCHAs: stop blocking the agents you want",
   "description": "Why bot protection catches AI assistants, how to tell if it's happening, and how to tune your CDN, WAF and CAPTCHAs so good agents get through and bad bots don't.",
   "published": "2026-10-08",
   "modified": "2026-10-19",
   "readMinutes": 7,
   "answer": {
    "question": "How do I stop bot protection blocking AI assistants?",
    "text": "Allow AI assistants and AI search by verified identity in your bot management settings, and never by user agent name alone. Check that any \"block AI\" setting covers only the agents you mean to block. Keep product, pricing and policy pages open, use rate limits instead of blocks, and save strict challenges and CAPTCHAs for login, sign-up and checkout."
   },
   "checks": [
    "access.bot-protection",
    "access.captcha",
    "access.key-pages"
   ],
   "sources": [
    {
     "title": "RFC 9110: HTTP Semantics",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc9110.html"
    },
    {
     "title": "RFC 6585: Additional HTTP Status Codes",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc6585.html"
    }
   ]
  },
  {
   "id": "guide/llms-txt",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/llms-txt/",
   "markdown": "https://ghostagentlab.com/articles/llms-txt/index.html.md",
   "title": "How to write an llms.txt file",
   "description": "What llms.txt is, what to put in it, a complete example for an online store, and the mistakes that make it useless to AI agents.",
   "published": "2026-10-08",
   "modified": "2026-10-08",
   "readMinutes": 7,
   "answer": {
    "question": "What is an llms.txt file, and should I add one?",
    "text": "An llms.txt file is a short Markdown guide at your domain root that tells AI agents what your business does and where your key pages are. It's a proposal that not every AI company reads, so add it alongside clear pages. List twenty to forty well-described links, publish it as plain text, and keep it current."
   },
   "checks": [
    "access.llms-txt"
   ],
   "sources": [
    {
     "title": "The /llms.txt file",
     "publisher": "llmstxt.org",
     "url": "https://llmstxt.org/"
    }
   ]
  },
  {
   "id": "guide/mcp-webmcp-for-websites",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/mcp-webmcp-for-websites/",
   "markdown": "https://ghostagentlab.com/articles/mcp-webmcp-for-websites/index.html.md",
   "title": "MCP and WebMCP: giving AI agents a direct way into your site",
   "description": "What MCP servers and WebMCP tools are, what they mean for your business, how AgentScore detects them, and how to start safely.",
   "published": "2026-10-09",
   "modified": "2026-10-20",
   "readMinutes": 6,
   "answer": {
    "question": "Should my website offer an MCP server for AI agents?",
    "text": "MCP and WebMCP let AI agents call named actions, such as searching products, instead of clicking through your pages. An MCP server is the practical choice today, while WebMCP is still an early proposal. Make sure agents can get in and read your pages first, then ask your commerce platform about MCP support and start with read-only tools."
   },
   "checks": [
    "access.agent-interfaces"
   ],
   "sources": [
    {
     "title": "What is the Model Context Protocol (MCP)?",
     "publisher": "Model Context Protocol",
     "url": "https://modelcontextprotocol.io/"
    },
    {
     "title": "WebMCP (Draft Community Group Report)",
     "publisher": "W3C Web Machine Learning Community Group",
     "url": "https://webmachinelearning.github.io/webmcp/"
    }
   ]
  },
  {
   "id": "guide/agentic-commerce-protocols",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/agentic-commerce-protocols/",
   "markdown": "https://ghostagentlab.com/articles/agentic-commerce-protocols/index.html.md",
   "title": "Agentic commerce protocols explained",
   "description": "What ACP, UCP and AP2 are for, what they mean for your store, what to ask your platform, and what AgentScore can and can't detect.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "What are agentic commerce protocols, and does my store need one?",
    "text": "Agentic commerce protocols, such as ACP, UCP and AP2, let an AI assistant buy from your store for a person without filling in your checkout pages. Most stores get support through their commerce platform or payment provider. Fix your website journey and product data first, then ask your platform and payment provider which protocols they support."
   },
   "checks": [
    "access.agentic-commerce"
   ],
   "sources": [
    {
     "title": "Agentic Commerce Protocol",
     "publisher": "Agentic Commerce Protocol",
     "url": "https://www.agenticcommerce.dev/"
    },
    {
     "title": "Universal Commerce Protocol specification overview",
     "publisher": "Universal Commerce Protocol",
     "url": "https://ucp.dev/specification/overview/"
    },
    {
     "title": "AP2: Agent Payments Protocol documentation",
     "publisher": "Agent Payments Protocol",
     "url": "https://ap2-protocol.org/"
    }
   ]
  },
  {
   "id": "guide/guest-checkout-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/guest-checkout-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/guest-checkout-ai-agents/index.html.md",
   "title": "Guest checkout: why AI shopping agents need it",
   "description": "Why forced accounts stop AI agents at the last step, how AgentScore checks for guest checkout, and how to offer it without losing accounts.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "Why do AI shopping agents need guest checkout?",
    "text": "AI agents can't create accounts for shoppers and usually can't sign in as them, so a forced account stops the order at the last step. Offer a clear guest option in words, with no password field, and make sure the cart doesn't say shoppers must sign in. Check your platform's checkout setting first, which may simply require accounts."
   },
   "checks": [
    "access.guest-checkout"
   ],
   "sources": [
    {
     "title": "HTML Standard: Form control infrastructure (autofill)",
     "publisher": "WHATWG",
     "url": "https://html.spec.whatwg.org/multipage/form-control-infrastructure.html"
    }
   ]
  },
  {
   "id": "guide/rate-limits-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/rate-limits-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/rate-limits-ai-agents/index.html.md",
   "title": "Rate limits for AI agents: fair limits that don't turn customers away",
   "description": "How to set rate limits that stop scrapers but not AI assistants: 429 with Retry-After, per-agent limits for verified agents, and what to watch.",
   "published": "2026-10-09",
   "modified": "2026-10-19",
   "readMinutes": 5,
   "answer": {
    "question": "How should I set rate limits for AI agents?",
    "text": "Give verified AI assistants generous limits that allow short bursts, since many share cloud addresses and each request stands in for a customer. When a limit is hit, answer with 429 Too Many Requests and a Retry-After header, never a block or CAPTCHA. Put your strictest limits on logins, coupons and search rather than product pages."
   },
   "checks": [
    "access.bot-protection",
    "access.key-pages",
    "access.checkout-challenge"
   ],
   "sources": [
    {
     "title": "RFC 6585: Additional HTTP Status Codes",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc6585.html"
    },
    {
     "title": "RFC 9110: HTTP Semantics",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc9110.html"
    },
    {
     "title": "Reduce the Google crawl rate",
     "publisher": "Google",
     "url": "https://developers.google.com/crawling/docs/crawlers-fetchers/reduce-crawl-rate"
    },
    {
     "title": "RateLimit header fields for HTTP (draft)",
     "publisher": "IETF",
     "url": "https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/"
    }
   ]
  },
  {
   "id": "guide/cdn-settings-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/cdn-settings-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/cdn-settings-ai-agents/index.html.md",
   "title": "Setting up your CDN for AI agents",
   "description": "How to set up your CDN and WAF for AI agents: verified bot categories, signed requests, rule order, challenge versus block, and logging.",
   "published": "2026-10-09",
   "modified": "2026-10-19",
   "readMinutes": 6,
   "answer": {
    "question": "How should I set up my CDN for AI agents?",
    "text": "First agree which kinds of AI agent you want, then build CDN rules on verified bot categories rather than user agent names. Place the allow rule for verified agents above any broad \"block AI bots\" rule, or it never runs. Treat any challenge as a block for agents, and run new rules in log-only mode for a few days first."
   },
   "checks": [],
   "sources": [
    {
     "title": "RFC 9421: HTTP Message Signatures",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc9421.html"
    },
    {
     "title": "HTTP Message Signatures for automated traffic Architecture (Web Bot Auth draft)",
     "publisher": "IETF",
     "url": "https://datatracker.ietf.org/doc/draft-meunier-web-bot-auth-architecture/"
    },
    {
     "title": "Verified bots",
     "publisher": "Cloudflare",
     "url": "https://developers.cloudflare.com/bots/concepts/bot/verified-bots/"
    },
    {
     "title": "AWS WAF Bot Control",
     "publisher": "AWS",
     "url": "https://docs.aws.amazon.com/waf/latest/developerguide/waf-bot-control.html"
    }
   ]
  },
  {
   "id": "guide/geo-blocking-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/geo-blocking-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/geo-blocking-ai-agents/index.html.md",
   "title": "Geo-blocking, VPN blocks and AI agents",
   "description": "Why country, VPN and data center blocks and IP-based redirects catch AI agents visiting from cloud servers abroad, and how to let verified agents through.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "Can geo-blocking stop AI assistants from reaching my site?",
    "text": "Yes. AI assistants visit from cloud data centers, sometimes in another country, so country, VPN and data center rules can block them, and IP redirects can show them the wrong store. List every location and network rule, keep the legally required ones, and let verified AI agents past the rest. Use country URLs with hreflang instead of automatic redirects."
   },
   "checks": [],
   "sources": [
    {
     "title": "Localized versions of your pages (hreflang)",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/specialty/international/localized-versions"
    },
    {
     "title": "Managing multi-regional and multilingual sites",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/specialty/international/managing-multi-regional-sites"
    }
   ]
  },
  {
   "id": "guide/login-walls-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/login-walls-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/login-walls-ai-agents/index.html.md",
   "title": "Login walls and gated content: what AI agents can reach",
   "description": "What AI agents can't reach behind logins and paywalls, what to keep public, how to hand off to the customer, and paywall structured data for publishers.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 4,
   "answer": {
    "question": "Can AI agents see content behind a login?",
    "text": "No. For most AI agents, anything behind a login or paywall simply isn't there, so they can only use what's public. Keep prices, product details, policies and contact details public, so assistants don't quote a competitor instead. Put the wall in front of private and paid content only, and offer guest checkout so agents can finish a purchase."
   },
   "checks": [
    "access.guest-checkout",
    "access.key-pages",
    "readability.prices"
   ],
   "sources": [
    {
     "title": "Subscription and paywalled content markup",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/paywalled-content"
    },
    {
     "title": "isAccessibleForFree (schema.org property)",
     "publisher": "schema.org",
     "url": "https://schema.org/isAccessibleForFree"
    },
    {
     "title": "RFC 9110: HTTP Semantics",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc9110.html"
    },
    {
     "title": "HTML Standard: Autofill",
     "publisher": "WHATWG",
     "url": "https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#autofill"
    }
   ]
  },
  {
   "id": "guide/age-gates-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/age-gates-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/age-gates-ai-agents/index.html.md",
   "title": "Age gates and region pickers that stop AI agents",
   "description": "How age checks, country pickers and language splash pages stop AI agents, and how to keep the gate you need while agents can still read products.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 9,
   "answer": {
    "question": "Do age gates and region pickers stop AI agents?",
    "text": "They often do, because a gate that redirects every URL to one page leaves AI agents with no product, price or stock to read. Ask your lawyer whether an overlay on the real page is acceptable, and build any gate as a clear dialog. Replace region pickers with country URLs and a default page that is a real store."
   },
   "checks": [],
   "sources": [
    {
     "title": "Avoid intrusive interstitials and dialogs",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/avoid-intrusive-interstitials"
    },
    {
     "title": "How Google crawls locale-adaptive pages",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/specialty/international/locale-adaptive-pages"
    },
    {
     "title": "Dialog (Modal) pattern",
     "publisher": "W3C WAI-ARIA Authoring Practices",
     "url": "https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/"
    },
    {
     "title": "Agentic Commerce: Get started (prohibited products policy)",
     "publisher": "OpenAI",
     "url": "https://developers.openai.com/commerce/guides/get-started"
    }
   ]
  },
  {
   "id": "guide/status-codes-redirects-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/status-codes-redirects-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/status-codes-redirects-ai-agents/index.html.md",
   "title": "Status codes, redirects and soft 404s for AI agents",
   "description": "The HTTP status codes and redirects that decide whether AI agents trust, retry or drop your pages, plus what to send for out-of-stock products.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 9,
   "answer": {
    "question": "What status codes should my site send to AI agents?",
    "text": "Send the code that matches what each page really is, because AI agents act on the status code before they read the page. Keep out-of-stock products live with a 200, redirect retired URLs to their closest equivalent in one 301 hop, and use 503 with Retry-After during maintenance. Never send a 200 with a 'not found' page."
   },
   "checks": [],
   "sources": [
    {
     "title": "RFC 9110: HTTP Semantics",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc9110.html"
    },
    {
     "title": "RFC 6585: Additional HTTP Status Codes (429)",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc6585.html"
    },
    {
     "title": "How HTTP status codes affect Google's crawlers",
     "publisher": "Google",
     "url": "https://developers.google.com/crawling/docs/troubleshooting/http-status-codes"
    },
    {
     "title": "Redirects and Google Search",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/crawling-indexing/301-redirects"
    }
   ]
  },
  {
   "id": "guide/structured-data-ai-shopping-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/structured-data-ai-shopping-agents/",
   "markdown": "https://ghostagentlab.com/articles/structured-data-ai-shopping-agents/index.html.md",
   "title": "Product data that AI shopping agents can read",
   "description": "How to describe products, prices, stock, shipping and returns with schema.org structured data, with a complete JSON-LD example and the rules that keep it trustworthy.",
   "published": "2026-10-08",
   "modified": "2026-10-08",
   "readMinutes": 7,
   "answer": {
    "question": "Do I need structured data for AI shopping agents?",
    "text": "Yes. Structured data gives AI agents your product's name, price, currency, stock and return terms in a standard format, so they don't have to guess from your layout. Check what your platform already outputs, fill gaps such as stock status, product codes, and shipping and return details, and keep every value matching the visible page."
   },
   "checks": [
    "readability.structured-data",
    "readability.product-data",
    "readability.consistency"
   ],
   "sources": [
    {
     "title": "Product (schema.org type)",
     "publisher": "schema.org",
     "url": "https://schema.org/Product"
    },
    {
     "title": "ProductGroup (schema.org type)",
     "publisher": "schema.org",
     "url": "https://schema.org/ProductGroup"
    },
    {
     "title": "Intro to product structured data on Google",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/product"
    },
    {
     "title": "General structured data guidelines",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/sd-policies"
    }
   ]
  },
  {
   "id": "guide/javascript-content-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/javascript-content-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/javascript-content-ai-agents/index.html.md",
   "title": "Why AI agents can't see your JavaScript-only content",
   "description": "Many AI agents read only the HTML your server sends. How to check what they see, what usually goes missing, and how to fix it with server rendering.",
   "published": "2026-10-08",
   "modified": "2026-10-08",
   "readMinutes": 7,
   "answer": {
    "question": "Can AI agents see content my site loads with JavaScript?",
    "text": "Often they can't. Many AI agents read only the HTML your server sends, so prices, products and policies that appear after scripts run may be invisible to them, even if you rank well in Google. Ask your developers to put product name, price, availability, key specifications, shipping, returns and plan pricing in the server's HTML first."
   },
   "checks": [
    "readability.no-js"
   ],
   "sources": [
    {
     "title": "Understand JavaScript SEO basics",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics"
    },
    {
     "title": "Dynamic rendering as a workaround",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/crawling-indexing/javascript/dynamic-rendering"
    },
    {
     "title": "Disable JavaScript (Chrome DevTools)",
     "publisher": "Chrome for Developers",
     "url": "https://developer.chrome.com/docs/devtools/javascript/disable"
    }
   ]
  },
  {
   "id": "guide/image-alt-text-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/image-alt-text-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/image-alt-text-ai-agents/index.html.md",
   "title": "Alt text for AI agents: describing product images",
   "description": "Why AI agents rely on alt text, what AgentScore checks, and how to write useful descriptions for product photos across a whole catalog.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "Why does image alt text matter for AI shopping agents?",
    "text": "Most AI agents read the alt text attached to your product images instead of the photos, so an image without alt text is effectively invisible to them. Make your product image template fall back to the product name and variant. Then hand-write short descriptions for your bestsellers that name the product, the variant and what each shot shows."
   },
   "checks": [
    "readability.image-alt"
   ],
   "sources": [
    {
     "title": "HTML Standard: Requirements for providing text to act as an alternative for images",
     "publisher": "WHATWG",
     "url": "https://html.spec.whatwg.org/multipage/images.html#alt"
    },
    {
     "title": "Decorative images",
     "publisher": "W3C Web Accessibility Initiative",
     "url": "https://www.w3.org/WAI/tutorials/images/decorative/"
    },
    {
     "title": "Functional images",
     "publisher": "W3C Web Accessibility Initiative",
     "url": "https://www.w3.org/WAI/tutorials/images/functional/"
    }
   ]
  },
  {
   "id": "guide/xml-sitemaps-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/xml-sitemaps-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/xml-sitemaps-ai-agents/index.html.md",
   "title": "XML sitemaps for AI agents",
   "description": "How AI agents and crawlers use your sitemap, what AgentScore checks, what to include and how to keep it accurate.",
   "published": "2026-10-09",
   "modified": "2026-10-26",
   "readMinutes": 4,
   "answer": {
    "question": "Do I need an XML sitemap for AI agents?",
    "text": "Yes. A sitemap lists the pages you want found, so AI agents and crawlers can reach products and policies your navigation might hide. Let your platform generate it automatically, since hand-made sitemaps go stale, then check that robots.txt has a Sitemap line and that the file it points to loads as a list of your pages."
   },
   "checks": [
    "readability.sitemap"
   ],
   "sources": [
    {
     "title": "Sitemaps XML format (protocol)",
     "publisher": "sitemaps.org",
     "url": "https://www.sitemaps.org/protocol.html"
    },
    {
     "title": "What is a sitemap",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/crawling-indexing/sitemaps/overview"
    },
    {
     "title": "Build and submit a sitemap",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap"
    }
   ]
  },
  {
   "id": "guide/titles-descriptions-headings-ai",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/titles-descriptions-headings-ai/",
   "markdown": "https://ghostagentlab.com/articles/titles-descriptions-headings-ai/index.html.md",
   "title": "Titles, descriptions and headings AI agents understand",
   "description": "How AI agents use page titles, meta descriptions, headings and the lang attribute, and how to write each so agents pick the right page.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "How should I write page titles and descriptions for AI agents?",
    "text": "Give every page a specific, unique title, a one or two sentence description of what's on it, one clear h1 heading and a lang attribute. AI agents use these labels to decide whether a page answers their question. Fix the templates for product, category and policy pages first, then hand-write your home page and top categories."
   },
   "checks": [
    "readability.title"
   ],
   "sources": [
    {
     "title": "Influencing title links in Google Search",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/title-link"
    },
    {
     "title": "How to write meta descriptions",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/snippet"
    },
    {
     "title": "Headings (page structure tutorial)",
     "publisher": "W3C Web Accessibility Initiative",
     "url": "https://www.w3.org/WAI/tutorials/page-structure/headings/"
    },
    {
     "title": "HTML Standard: The lang and xml:lang attributes",
     "publisher": "WHATWG",
     "url": "https://html.spec.whatwg.org/multipage/dom.html#the-lang-and-xml:lang-attributes"
    }
   ]
  },
  {
   "id": "guide/machine-readable-prices",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/machine-readable-prices/",
   "markdown": "https://ghostagentlab.com/articles/machine-readable-prices/index.html.md",
   "title": "Prices AI agents can read",
   "description": "How to show prices AI agents read correctly: in the server HTML, with a clear currency, labelled sale prices, variant prices and one source of truth.",
   "published": "2026-10-09",
   "modified": "2026-10-19",
   "readMinutes": 5,
   "answer": {
    "question": "How do I make sure AI agents can read my prices?",
    "text": "Put the price in the HTML your server sends, both as visible text and in structured data, and make sure the two agree. Many agents don't run JavaScript, so a price loaded later is invisible to them. Show a currency code where a symbol is ambiguous, and label sale prices in words, such as 'Was $24.00, now $18.00'."
   },
   "checks": [
    "readability.product-data",
    "readability.prices",
    "readability.consistency"
   ],
   "sources": [
    {
     "title": "Offer (schema.org type)",
     "publisher": "schema.org",
     "url": "https://schema.org/Offer"
    },
    {
     "title": "Product variant structured data (ProductGroup, Product)",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/product-variants"
    },
    {
     "title": "General structured data guidelines",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/sd-policies"
    },
    {
     "title": "HTML Standard: The del element",
     "publisher": "WHATWG",
     "url": "https://html.spec.whatwg.org/multipage/edits.html#the-del-element"
    }
   ]
  },
  {
   "id": "guide/policy-pages-ai-assistants",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/policy-pages-ai-assistants/",
   "markdown": "https://ghostagentlab.com/articles/policy-pages-ai-assistants/index.html.md",
   "title": "Shipping, returns and FAQ pages AI assistants can quote",
   "description": "How to write shipping, returns and FAQ pages that AI assistants can find, read and quote accurately to shoppers before they buy.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "How do I stop AI assistants misquoting my shipping and returns policies?",
    "text": "Write shipping, returns and FAQ pages as plain HTML text, with numbers instead of adjectives, so each sentence makes sense when quoted alone. Keep one version of each policy, because contradictions force assistants to guess. Then ask a few AI assistants your most common support questions and rewrite the pages behind any wrong or hesitant answers."
   },
   "checks": [],
   "sources": []
  },
  {
   "id": "guide/organization-structured-data",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/organization-structured-data/",
   "markdown": "https://ghostagentlab.com/articles/organization-structured-data/index.html.md",
   "title": "Business and store details AI agents can trust: Organization and LocalBusiness data",
   "description": "How to describe your business, contact points, opening hours and return policy with Organization and LocalBusiness JSON-LD that AI agents can trust.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "How do I tell AI agents who my business is?",
    "text": "Add Organization structured data to your home page, using the most specific true type, such as OnlineStore or LocalBusiness. Include your name, logo, contact details, address, social profiles and default return policy, so agents get one trusted summary. Generate it from the same settings as your footer, so the phone number, hours and return window match your pages."
   },
   "checks": [
    "readability.structured-data"
   ],
   "sources": [
    {
     "title": "Organization schema markup",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/organization"
    },
    {
     "title": "OnlineStore (schema.org type)",
     "publisher": "schema.org",
     "url": "https://schema.org/OnlineStore"
    },
    {
     "title": "Local business (LocalBusiness) structured data",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/local-business"
    }
   ]
  },
  {
   "id": "guide/product-descriptions-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/product-descriptions-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/product-descriptions-ai-agents/index.html.md",
   "title": "Product descriptions AI agents can compare",
   "description": "How to write product descriptions AI agents can compare: specs as text and tables, consistent attributes, units, materials and compatibility.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "How should I write product descriptions so AI agents recommend us?",
    "text": "Write the facts shoppers compare as plain text with units, such as 'Weight: 410 g (size M)', instead of claims like 'ultralight'. AI agents recommend the products they can confirm, and specs in images, PDFs or script-loaded tabs are often invisible to them. Start with your best-selling category and fill the same five to ten attributes on every product."
   },
   "checks": [],
   "sources": [
    {
     "title": "Product",
     "publisher": "schema.org",
     "url": "https://schema.org/Product"
    },
    {
     "title": "PropertyValue",
     "publisher": "schema.org",
     "url": "https://schema.org/PropertyValue"
    },
    {
     "title": "isAccessoryOrSparePartFor",
     "publisher": "schema.org",
     "url": "https://schema.org/isAccessoryOrSparePartFor"
    }
   ]
  },
  {
   "id": "guide/reviews-ratings-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/reviews-ratings-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/reviews-ratings-ai-agents/index.html.md",
   "title": "Reviews and ratings AI agents can read",
   "description": "How to make reviews and ratings visible to AI agents: reviews in the HTML, AggregateRating and Review markup that follows the rules, and honest moderation.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "Can AI shopping agents see my product reviews?",
    "text": "Often they can't, because many review apps load reviews with JavaScript and agents that read only the HTML see an empty space. Check a product page's source for your rating and a phrase from a review. If they're missing, turn on your review provider's server-side output, or at least show the average rating and review count as text."
   },
   "checks": [],
   "sources": [
    {
     "title": "Review snippet (Review, AggregateRating) structured data",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/review-snippet"
    },
    {
     "title": "AggregateRating",
     "publisher": "schema.org",
     "url": "https://schema.org/AggregateRating"
    },
    {
     "title": "Review",
     "publisher": "schema.org",
     "url": "https://schema.org/Review"
    }
   ]
  },
  {
   "id": "guide/canonical-urls-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/canonical-urls-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/canonical-urls-ai-agents/index.html.md",
   "title": "Canonical URLs and duplicate pages for AI agents",
   "description": "How to stop AI agents reading the same page at many URLs: rel=canonical, parameter and variant URLs, http, https and www redirects, and clean sitemaps.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "How do I stop duplicate product URLs confusing AI agents?",
    "text": "Name one main address for each page with a canonical link in the HTML, using the full URL. Without it, agents may treat one product as several, quote an old price or send shoppers to a copy with a stale campaign tag. Redirect old http and www versions in one step, and list only main addresses in your sitemap."
   },
   "checks": [],
   "sources": [
    {
     "title": "How to specify a canonical with rel=\"canonical\" and other methods",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls"
    },
    {
     "title": "Redirects and Google Search",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/crawling-indexing/301-redirects"
    },
    {
     "title": "RFC 6596: The Canonical Link Relation",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc6596.html"
    }
   ]
  },
  {
   "id": "guide/international-sites-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/international-sites-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/international-sites-ai-agents/index.html.md",
   "title": "Languages, currencies and regions: international sites for AI agents",
   "description": "How to make international stores work for AI agents: lang and hreflang, unambiguous currencies, region redirects that don't trap agents, and shipping countries.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 4,
   "answer": {
    "question": "How do I make my international store work for AI agents?",
    "text": "Let every country address open directly without forced location redirects, because AI agents often run from data centers elsewhere and can get trapped in the wrong country store. Set the right lang attribute on each version and connect versions with hreflang. Show currency codes where symbols are ambiguous, and list the countries you ship to."
   },
   "checks": [],
   "sources": [
    {
     "title": "Localized versions of your pages",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/specialty/international/localized-versions"
    },
    {
     "title": "Declaring language in HTML",
     "publisher": "W3C",
     "url": "https://www.w3.org/International/questions/qa-html-language-declarations"
    },
    {
     "title": "priceCurrency",
     "publisher": "schema.org",
     "url": "https://schema.org/priceCurrency"
    },
    {
     "title": "OfferShippingDetails",
     "publisher": "schema.org",
     "url": "https://schema.org/OfferShippingDetails"
    }
   ]
  },
  {
   "id": "guide/comparison-tables-buying-guides-ai",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/comparison-tables-buying-guides-ai/",
   "markdown": "https://ghostagentlab.com/articles/comparison-tables-buying-guides-ai/index.html.md",
   "title": "Comparison tables and buying guides AI assistants can use",
   "description": "Build comparison tables as real HTML tables with consistent attributes, and write buying guides that answer \"which should I buy?\" honestly enough to be quoted.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": {
    "question": "How do I make comparison charts AI assistants can read?",
    "text": "Build each comparison chart as a real HTML table with a caption and header cells, instead of an image, styled boxes or a table built by a script. Use the same attributes and units in every row, write 'Yes' or 'No' beside any icons, and match your product pages. Add a buying guide that says who each product suits."
   },
   "checks": [],
   "sources": [
    {
     "title": "Tables tutorial",
     "publisher": "W3C Web Accessibility Initiative",
     "url": "https://www.w3.org/WAI/tutorials/tables/"
    },
    {
     "title": "Caption and summary (tables tutorial)",
     "publisher": "W3C Web Accessibility Initiative",
     "url": "https://www.w3.org/WAI/tutorials/tables/caption-summary/"
    },
    {
     "title": "HTML Standard: Tabular data",
     "publisher": "WHATWG",
     "url": "https://html.spec.whatwg.org/multipage/tables.html"
    }
   ]
  },
  {
   "id": "guide/pdfs-documents-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/pdfs-documents-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/pdfs-documents-ai-agents/index.html.md",
   "title": "PDFs and documents AI agents can read",
   "description": "Spec sheets, manuals, menus and price lists in PDFs: which facts belong in HTML, how to make PDFs real tagged text, and how to name and link them.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": {
    "question": "Can AI agents read the information in my PDFs?",
    "text": "Sometimes, but a fact only in a PDF has to survive several steps before an agent can use it. Put the facts shoppers ask about, such as specs, prices and menus, on the page as HTML text. Keep PDFs for the full detail, export them with real text, run text recognition on scans and link them in plain HTML."
   },
   "checks": [],
   "sources": [
    {
     "title": "All WCAG 2.2 Techniques: PDF techniques",
     "publisher": "W3C Web Accessibility Initiative",
     "url": "https://www.w3.org/WAI/WCAG22/Techniques/#pdf"
    },
    {
     "title": "PDF7: Performing OCR on a scanned PDF document to provide actual text",
     "publisher": "W3C Web Accessibility Initiative",
     "url": "https://www.w3.org/WAI/WCAG22/Techniques/pdf/PDF7"
    },
    {
     "title": "PDF18: Specifying the document title using the Title entry",
     "publisher": "W3C Web Accessibility Initiative",
     "url": "https://www.w3.org/WAI/WCAG22/Techniques/pdf/PDF18"
    },
    {
     "title": "File types indexable by Google",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/crawling-indexing/indexable-file-types"
    }
   ]
  },
  {
   "id": "guide/personalization-ab-tests-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/personalization-ab-tests-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/personalization-ab-tests-ai-agents/index.html.md",
   "title": "Personalization and A/B tests: what AI agents see",
   "description": "AI agents see your default page as a stranger from a data center; here is how tests, personalization, geo-pricing and caching can mislead them.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 8,
   "answer": {
    "question": "Do A/B tests and personalization change what AI agents see?",
    "text": "Yes. An AI agent usually sees your default page with no cookies, no sign-in and a data center's location, then reports that version to the shopper. Vary layout and copy as much as you like, but keep price, stock, delivery and returns the same for every visitor to a URL, and keep test content in the HTML."
   },
   "checks": [],
   "sources": [
    {
     "title": "Minimize A/B testing impact in Google Search",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/crawling-indexing/website-testing"
    },
    {
     "title": "Spam policies for Google web search (cloaking)",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/essentials/spam-policies"
    },
    {
     "title": "How Google crawls locale-adaptive pages",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/specialty/international/locale-adaptive-pages"
    },
    {
     "title": "RFC 9110: HTTP Semantics, section 12.5.5 Vary",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc9110.html#name-vary"
    }
   ]
  },
  {
   "id": "guide/product-feeds-ai-shopping",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/product-feeds-ai-shopping/",
   "markdown": "https://ghostagentlab.com/articles/product-feeds-ai-shopping/index.html.md",
   "title": "Product feeds and merchant listings for AI shopping",
   "description": "What product feeds do for AI shopping, the Google and OpenAI feed programs, keeping feed, page and structured data in agreement, and how often to update.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": {
    "question": "How should I manage product feeds for AI shopping?",
    "text": "Send shopping platforms such as Google Merchant Center and OpenAI's ChatGPT program a full product feed at least daily, and push price and stock changes as they happen. Generate the feed, your page's structured data and the visible page from one product record, because platforms compare them. A feed adds to your product pages and doesn't replace them."
   },
   "checks": [],
   "sources": [
    {
     "title": "Product data specification",
     "publisher": "Google Merchant Center Help",
     "url": "https://support.google.com/merchants/answer/7052112"
    },
    {
     "title": "Allow Merchant Center to update product information automatically",
     "publisher": "Google Merchant Center Help",
     "url": "https://support.google.com/merchants/answer/12157888"
    },
    {
     "title": "Agentic Commerce: Get started",
     "publisher": "OpenAI",
     "url": "https://developers.openai.com/commerce/guides/get-started"
    },
    {
     "title": "Agentic Commerce: Products (file upload)",
     "publisher": "OpenAI",
     "url": "https://developers.openai.com/commerce/specs/file-upload/products"
    },
    {
     "title": "Agentic Commerce: File upload overview",
     "publisher": "OpenAI",
     "url": "https://developers.openai.com/commerce/specs/file-upload/overview"
    }
   ]
  },
  {
   "id": "guide/product-identifiers-gtin-mpn",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/product-identifiers-gtin-mpn/",
   "markdown": "https://ghostagentlab.com/articles/product-identifiers-gtin-mpn/index.html.md",
   "title": "Product identifiers (GTIN, MPN, SKU) for AI shopping agents",
   "description": "How GTINs, MPNs, brands and SKUs let AI agents match your products to the same item elsewhere, where to put them, and what to do without one.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 9,
   "answer": {
    "question": "Should I add GTINs and other product identifiers for AI agents?",
    "text": "Yes. A GTIN, the number behind the barcode, lets AI agents match your listing to the same product at other stores and to its reviews. Put the GTIN, brand, MPN and SKU in your Product structured data and on the page, with one GTIN per variant. Never guess a code, since a wrong one matches someone else's product."
   },
   "checks": [],
   "sources": [
    {
     "title": "Product",
     "publisher": "Schema.org",
     "url": "https://schema.org/Product"
    },
    {
     "title": "gtin",
     "publisher": "Schema.org",
     "url": "https://schema.org/gtin"
    },
    {
     "title": "Merchant listing structured data",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/merchant-listing"
    },
    {
     "title": "GTIN [gtin]",
     "publisher": "Google Merchant Center Help",
     "url": "https://support.google.com/merchants/answer/6324461"
    },
    {
     "title": "How to get UPC barcodes for products",
     "publisher": "GS1 US",
     "url": "https://www.gs1us.org/upcs-barcodes-prefixes/how-to-get-a-upc-barcode"
    }
   ]
  },
  {
   "id": "guide/video-transcripts-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/video-transcripts-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/video-transcripts-ai-agents/index.html.md",
   "title": "Video, audio and transcripts for AI agents",
   "description": "Give AI agents the words behind your product videos and podcasts: key facts on the page, HTML transcripts, accurate captions and VideoObject structured data.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": {
    "question": "How do I make product videos readable for AI agents?",
    "text": "Write the facts your video shows on the page as labeled text, because AI agents usually read the page around a video rather than the video itself. Publish a corrected HTML transcript on the same page, including on-screen text and actions. Add VideoObject structured data with a name, thumbnail, upload date and description for each video."
   },
   "checks": [],
   "sources": [
    {
     "title": "Transcripts",
     "publisher": "W3C Web Accessibility Initiative",
     "url": "https://www.w3.org/WAI/media/av/transcripts/"
    },
    {
     "title": "Captions/Subtitles",
     "publisher": "W3C Web Accessibility Initiative",
     "url": "https://www.w3.org/WAI/media/av/captions/"
    },
    {
     "title": "VideoObject",
     "publisher": "Schema.org",
     "url": "https://schema.org/VideoObject"
    },
    {
     "title": "Video (VideoObject, Clip, BroadcastEvent) structured data",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/video"
    },
    {
     "title": "Video SEO best practices",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/video"
    }
   ]
  },
  {
   "id": "guide/agent-friendly-buttons-forms",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/agent-friendly-buttons-forms/",
   "markdown": "https://ghostagentlab.com/articles/agent-friendly-buttons-forms/index.html.md",
   "title": "Buttons, links and forms agents can use: a checklist",
   "description": "Browser agents navigate by the names and roles of controls. Fix icon-only buttons, fake buttons, unlabelled fields, blocking pop-ups and hover-only menus.",
   "published": "2026-10-08",
   "modified": "2026-10-08",
   "readMinutes": 8,
   "answer": {
    "question": "How do I make buttons and forms usable by AI agents?",
    "text": "Give every button and link a clear name, use real buttons and links, and connect a label to every form field. Browser agents find their way by these names and roles, so icon-only buttons, covering pop-ups and hover-only menus stop them. Test by reaching the menu, search, a product and the cart with the keyboard alone."
   },
   "checks": [
    "navigability.named-controls",
    "navigability.real-controls",
    "navigability.form-labels",
    "navigability.landmarks",
    "navigability.overlay"
   ],
   "sources": [
    {
     "title": "WCAG 2.2",
     "publisher": "W3C",
     "url": "https://www.w3.org/TR/WCAG22/"
    },
    {
     "title": "Button pattern (ARIA Authoring Practices Guide)",
     "publisher": "W3C",
     "url": "https://www.w3.org/WAI/ARIA/apg/patterns/button/"
    },
    {
     "title": "HTML Standard: form control infrastructure (autofill)",
     "publisher": "WHATWG",
     "url": "https://html.spec.whatwg.org/multipage/form-control-infrastructure.html"
    }
   ]
  },
  {
   "id": "guide/cookie-banners-popups-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/cookie-banners-popups-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/cookie-banners-popups-ai-agents/index.html.md",
   "title": "Cookie banners and pop-ups that trap AI agents",
   "description": "How cookie banners, sign-up pop-ups and chat widgets block AI agents, what AgentScore checks, and how to design overlays agents can dismiss.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 6,
   "answer": {
    "question": "Can cookie banners and pop-ups block AI shopping agents?",
    "text": "Yes. A banner or pop-up an agent can't dismiss ends its visit, and you never hear about it. Keep consent banners at the edge of the screen with named \"Accept all\" and \"Reject all\" buttons, label close icons, and show sign-up pop-ups after someone engages rather than on arrival. Agree any banner change with your privacy owner."
   },
   "checks": [
    "navigability.overlay"
   ],
   "sources": [
    {
     "title": "Dialog (modal) pattern (ARIA Authoring Practices Guide)",
     "publisher": "W3C",
     "url": "https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/"
    },
    {
     "title": "Report of the work undertaken by the Cookie Banner Taskforce",
     "publisher": "European Data Protection Board",
     "url": "https://www.edpb.europa.eu/documents/task-force-report/report-of-the-work-undertaken-by-the-cookie-banner-taskforce_en"
    }
   ]
  },
  {
   "id": "guide/link-key-pages-home-page",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/link-key-pages-home-page/",
   "markdown": "https://ghostagentlab.com/articles/link-key-pages-home-page/index.html.md",
   "title": "Link your key pages from the home page",
   "description": "AI agents start at your home page and follow links. Make sure products, the cart and pricing are linked in plain HTML so every agent can find them.",
   "published": "2026-10-09",
   "modified": "2026-10-19",
   "readMinutes": 5,
   "answer": {
    "question": "Which pages should my home page link to for AI agents?",
    "text": "Link the pages that make you money, such as main categories, bestsellers, the cart, pricing, shipping and returns, directly from your home page. AI agents usually start there and follow links, and many can't see menus built by JavaScript. Use plain HTML links with clear text, and remember that footer links count too."
   },
   "checks": [
    "navigability.key-pages-linked"
   ],
   "sources": [
    {
     "title": "SEO link best practices for Google",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/crawling-indexing/links-crawlable"
    }
   ]
  },
  {
   "id": "guide/site-search-filters-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/site-search-filters-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/site-search-filters-ai-agents/index.html.md",
   "title": "Site search and filters AI agents can use",
   "description": "Build a search box, results URLs and filters that AI agents can operate, so they find the right products instead of giving up or guessing.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 6,
   "answer": {
    "question": "How can I make site search and filters work for AI agents?",
    "text": "Give your search box a label, make filters real controls, and give every search and filtered view its own readable web address that shows the same results when opened fresh. AI agents search and filter like shoppers, and assistants that fetch pages can only open links. Unlabelled search icons and script-only results make agents give up."
   },
   "checks": [],
   "sources": [
    {
     "title": "SearchAction",
     "publisher": "schema.org",
     "url": "https://schema.org/SearchAction"
    },
    {
     "title": "Grouping controls (forms tutorial)",
     "publisher": "W3C",
     "url": "https://www.w3.org/WAI/tutorials/forms/grouping/"
    },
    {
     "title": "RFC 9309: Robots Exclusion Protocol",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc9309.html"
    }
   ]
  },
  {
   "id": "guide/variant-pickers-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/variant-pickers-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/variant-pickers-ai-agents/index.html.md",
   "title": "Size, color and variant pickers AI agents can use",
   "description": "Build size and color pickers AI agents can use: named options, a readable selected state, clear sold-out options, variant URLs and prices that update.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 6,
   "answer": {
    "question": "Why can't AI agents choose sizes and colors on my site?",
    "text": "Usually because color swatches have no name, the chosen option is shown only by a border, or sold-out sizes are merely faded. Agents then give up or add the wrong item to the cart. Ask your developer or theme provider to rebuild swatches as named radio buttons styled the same way, and give each variant its own URL."
   },
   "checks": [],
   "sources": [
    {
     "title": "Radio group pattern (ARIA Authoring Practices Guide)",
     "publisher": "W3C",
     "url": "https://www.w3.org/WAI/ARIA/apg/patterns/radio/"
    },
    {
     "title": "Button pattern (ARIA Authoring Practices Guide)",
     "publisher": "W3C",
     "url": "https://www.w3.org/WAI/ARIA/apg/patterns/button/"
    },
    {
     "title": "ProductGroup",
     "publisher": "schema.org",
     "url": "https://schema.org/ProductGroup"
    },
    {
     "title": "Product variant structured data",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/product-variants"
    }
   ]
  },
  {
   "id": "guide/infinite-scroll-pagination-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/infinite-scroll-pagination-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/infinite-scroll-pagination-ai-agents/index.html.md",
   "title": "Infinite scroll, “load more” and pagination for AI agents",
   "description": "Infinite scroll can hide most of your catalog from AI agents. Back it with real paginated URLs, a “load more” link and a sitemap.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "Does infinite scroll hide my products from AI agents?",
    "text": "It can. With infinite scroll alone, many agents see only the first batch of products, and an assistant may tell a shopper you don't sell an item further down. Keep infinite scroll or \"load more\" if you like it, but give each page of results its own web address and a real link, and list products in your sitemap."
   },
   "checks": [],
   "sources": [
    {
     "title": "Pagination best practices for Google",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/specialty/ecommerce/pagination-and-incremental-page-loading"
    },
    {
     "title": "WAI-ARIA 1.2",
     "publisher": "W3C",
     "url": "https://www.w3.org/TR/wai-aria-1.2/"
    }
   ]
  },
  {
   "id": "guide/error-messages-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/error-messages-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/error-messages-ai-agents/index.html.md",
   "title": "Error messages AI agents can understand and fix",
   "description": "Help AI agents recover from mistakes: error text tied to each field, live regions, useful 404 pages and HTTP status codes that match what the page says.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 6,
   "answer": {
    "question": "How should form error messages work for AI agents?",
    "text": "Write each error as text that says what to fix, such as \"Enter a 5-digit ZIP code,\" and place it beside the right field. AI agents may miss red borders and other visual cues, so an unclear error can quietly lose an order. Test by submitting your checkout with a wrong ZIP code and reading only the page text."
   },
   "checks": [],
   "sources": [
    {
     "title": "RFC 9110: HTTP Semantics",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc9110.html"
    },
    {
     "title": "RFC 6585: Additional HTTP Status Codes",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc6585.html"
    },
    {
     "title": "Understanding WCAG 2.2 Success Criterion 3.3.1: Error Identification",
     "publisher": "W3C",
     "url": "https://www.w3.org/WAI/WCAG22/Understanding/error-identification.html"
    },
    {
     "title": "Accessible Rich Internet Applications (WAI-ARIA) 1.2",
     "publisher": "W3C",
     "url": "https://www.w3.org/TR/wai-aria-1.2/"
    }
   ]
  },
  {
   "id": "guide/breadcrumbs-site-structure-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/breadcrumbs-site-structure-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/breadcrumbs-site-structure-ai-agents/index.html.md",
   "title": "Breadcrumbs and site structure for AI agents",
   "description": "How breadcrumbs as real links, BreadcrumbList structured data and a shallow hierarchy help AI agents understand and navigate your store.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": {
    "question": "Do breadcrumbs help AI agents understand my store?",
    "text": "Yes. AI agents usually land in the middle of your site, so a breadcrumb trail is often their only map of your store. Put it in the server-sent HTML as real links inside a labeled navigation landmark, add BreadcrumbList structured data that names the same steps, and keep your hierarchy shallow with plain category names."
   },
   "checks": [],
   "sources": [
    {
     "title": "BreadcrumbList",
     "publisher": "Schema.org",
     "url": "https://schema.org/BreadcrumbList"
    },
    {
     "title": "How to add breadcrumb (BreadcrumbList) markup",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/breadcrumb"
    },
    {
     "title": "Breadcrumb Pattern",
     "publisher": "W3C WAI-ARIA Authoring Practices Guide",
     "url": "https://www.w3.org/WAI/ARIA/apg/patterns/breadcrumb/"
    },
    {
     "title": "Help Google understand your ecommerce website structure",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/specialty/ecommerce/help-google-understand-your-ecommerce-site-structure"
    }
   ]
  },
  {
   "id": "guide/category-pages-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/category-pages-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/category-pages-ai-agents/index.html.md",
   "title": "Category and collection pages AI agents can browse",
   "description": "What category pages need for AI agents: product cards with name, price and link in the HTML, sort and filter URLs, counts, pagination and a description.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": {
    "question": "What do AI agents need from my category pages?",
    "text": "Each product card needs its name, price, image and one main link in the HTML your server sends, with stock and ratings in words. Give sorted views, filtered views and every page of results their own URLs, linked with real links. Check by viewing your best-selling category's source for the last product's name and price."
   },
   "checks": [],
   "sources": [
    {
     "title": "Help Google understand your ecommerce website structure",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/specialty/ecommerce/help-google-understand-your-ecommerce-site-structure"
    },
    {
     "title": "SEO link best practices for Google",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/crawling-indexing/links-crawlable"
    },
    {
     "title": "Pagination best practices for Google",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/specialty/ecommerce/pagination-and-incremental-page-loading"
    }
   ]
  },
  {
   "id": "guide/iframes-shadow-dom-widgets-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/iframes-shadow-dom-widgets-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/iframes-shadow-dom-widgets-ai-agents/index.html.md",
   "title": "Iframes, shadow DOM and embedded widgets for AI agents",
   "description": "What AI agents miss inside booking engines, review widgets and other iframes or shadow DOM, and the fallbacks that keep key facts within their reach.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 8,
   "answer": {
    "question": "Can AI agents read widgets embedded in iframes on my site?",
    "text": "Often not. Agents that read your HTML can't see inside iframes or shadow roots, where booking engines, review widgets and size finders often sit. Keep the widgets, but make sure key facts like the rating, price and main button also appear in your own HTML, and add a real link to a full page for each widget."
   },
   "checks": [],
   "sources": [
    {
     "title": "<iframe>: HTML inline frame element",
     "publisher": "MDN Web Docs",
     "url": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/iframe"
    },
    {
     "title": "Using shadow DOM",
     "publisher": "MDN Web Docs",
     "url": "https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_shadow_DOM"
    },
    {
     "title": "Same-origin policy",
     "publisher": "MDN Web Docs",
     "url": "https://developer.mozilla.org/en-US/docs/Web/Security/Defenses/Same-origin_policy"
    }
   ]
  },
  {
   "id": "guide/store-locators-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/store-locators-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/store-locators-ai-agents/index.html.md",
   "title": "Store locators and maps AI agents can use",
   "description": "Turn a map-only store locator into locations AI agents can read: a list in the HTML, a page per location, LocalBusiness data and a labeled search.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": {
    "question": "How do I make my store locator readable by AI assistants?",
    "text": "Publish a plain list of locations in your HTML, plus a page for each location with its address, hours and LocalBusiness data. A locator that loads shops only after a postcode search shows agents that read HTML an empty page. Keep the search box, but label its field, name its buttons and give results their own URL."
   },
   "checks": [],
   "sources": [
    {
     "title": "LocalBusiness",
     "publisher": "Schema.org",
     "url": "https://schema.org/LocalBusiness"
    },
    {
     "title": "Local Business (LocalBusiness) structured data",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/local-business"
    }
   ]
  },
  {
   "id": "guide/tabs-accordions-hidden-content-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/tabs-accordions-hidden-content-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/tabs-accordions-hidden-content-ai-agents/index.html.md",
   "title": "Tabs, accordions and \"read more\": content agents can reach",
   "description": "Tabs, accordions, read more links, tooltips and carousels can hide product details from AI agents. How to keep that content in reach of every agent.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": {
    "question": "Do tabs and accordions hide product details from AI agents?",
    "text": "Only when the content loads on click. Collapsed text is fine as long as it's in the HTML your server sends, while panels a script fetches on click are invisible to agents that read HTML. Use real, named buttons as toggles, consider the details and summary elements for accordions, and keep key facts out of hover-only tooltips."
   },
   "checks": [],
   "sources": [
    {
     "title": "Tabs Pattern",
     "publisher": "W3C WAI-ARIA Authoring Practices Guide",
     "url": "https://www.w3.org/WAI/ARIA/apg/patterns/tabs/"
    },
    {
     "title": "Accordion Pattern",
     "publisher": "W3C WAI-ARIA Authoring Practices Guide",
     "url": "https://www.w3.org/WAI/ARIA/apg/patterns/accordion/"
    },
    {
     "title": "<details>: HTML details disclosure element",
     "publisher": "MDN Web Docs",
     "url": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/details"
    },
    {
     "title": "hidden HTML global attribute",
     "publisher": "MDN Web Docs",
     "url": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/hidden"
    }
   ]
  },
  {
   "id": "guide/agent-ready-checkout",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/agent-ready-checkout/",
   "markdown": "https://ghostagentlab.com/articles/agent-ready-checkout/index.html.md",
   "title": "How to make checkout work for AI shopping agents",
   "description": "A step-by-step guide to the shopping journey for AI agents: finding products, choosing options, adding to cart, checkout and the payment handoff.",
   "published": "2026-10-08",
   "modified": "2026-10-08",
   "readMinutes": 8,
   "answer": {
    "question": "How do I make my checkout work for AI shopping agents?",
    "text": "Make each step usable, from finding the product and choosing options to adding to cart, checking out and handing over payment. Replace custom size and color pickers that agents can't operate, and offer guest checkout instead of forcing an account. Label every field, show the full total before payment, and retest with the keyboard after every theme update."
   },
   "checks": [
    "navigability.purchase-control",
    "navigability.checkout-fields",
    "access.guest-checkout",
    "access.checkout-challenge"
   ],
   "sources": [
    {
     "title": "Agentic Commerce Protocol",
     "publisher": "OpenAI",
     "url": "https://developers.openai.com/commerce"
    },
    {
     "title": "Google Universal Commerce Protocol (UCP) Guide",
     "publisher": "Google for Developers",
     "url": "https://developers.google.com/merchant/ucp"
    },
    {
     "title": "HTML Standard: Form control infrastructure (autofill)",
     "publisher": "WHATWG",
     "url": "https://html.spec.whatwg.org/multipage/form-control-infrastructure.html"
    }
   ]
  },
  {
   "id": "guide/agent-friendly-sign-up-booking",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/agent-friendly-sign-up-booking/",
   "markdown": "https://ghostagentlab.com/articles/agent-friendly-sign-up-booking/index.html.md",
   "title": "Sign-up, booking and lead forms AI agents can finish",
   "description": "How to build sign-up, booking and quote forms AI agents can complete, and how to handle email verification, CAPTCHAs, date pickers and the handoff.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 6,
   "answer": {
    "question": "How do I make booking and sign-up forms work for AI agents?",
    "text": "Give every field a visible label, use standard controls for dates, times and choices, and confirm in words with a reference number. Replace CAPTCHAs on every submission with checks that only challenge suspicious activity. Save the booking or lead before asking for email verification, so nothing is lost when the agent hands back to the person."
   },
   "checks": [
    "navigability.form-labels",
    "navigability.purchase-control",
    "access.captcha"
   ],
   "sources": [
    {
     "title": "HTML Standard: Form control infrastructure (autofill)",
     "publisher": "WHATWG",
     "url": "https://html.spec.whatwg.org/multipage/form-control-infrastructure.html"
    },
    {
     "title": "HTTP Message Signatures for automated traffic Architecture (Web Bot Auth draft)",
     "publisher": "IETF",
     "url": "https://datatracker.ietf.org/doc/draft-meunier-web-bot-auth-architecture/"
    }
   ]
  },
  {
   "id": "guide/test-journeys-with-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/test-journeys-with-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/test-journeys-with-ai-agents/index.html.md",
   "title": "How to test your key journeys with AI agents",
   "description": "Which journeys to test with AI agents, how to test by hand and with Ghost Agents, what to measure, and how to test safely without real purchases.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "How can I tell if AI agents can actually use my site?",
    "text": "Send an AI agent through your most valuable journey and watch, because passing technical checks doesn't prove an agent can finish a task. Try it by hand with a consumer AI assistant at least three times, then automate it on a schedule. Use test data only, stop at payment, and treat a journey that passes only sometimes as a problem."
   },
   "checks": [],
   "sources": [
    {
     "title": "HTTP Message Signatures for automated traffic Architecture (Web Bot Auth draft)",
     "publisher": "IETF",
     "url": "https://datatracker.ietf.org/doc/draft-meunier-web-bot-auth-architecture/"
    }
   ]
  },
  {
   "id": "guide/cart-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/cart-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/cart-ai-agents/index.html.md",
   "title": "Carts AI agents can manage: quantities, promo codes and totals",
   "description": "How to build a cart AI agents can change and check: named quantity and remove controls, usable promo code fields, clear totals and carts that last.",
   "published": "2026-10-09",
   "modified": "2026-10-20",
   "readMinutes": 6,
   "answer": {
    "question": "What does my cart need so AI agents can manage it?",
    "text": "Make every part of the cart readable as text: items, quantities, discounts, shipping, tax and the total with its currency. Use labeled quantity fields, name every plus, minus and remove button, and explain promo code failures in words. Keep carts for days at a stable URL, so the cart is still there when the person comes back to pay."
   },
   "checks": [
    "access.key-pages",
    "navigability.checkout-fields",
    "navigability.named-controls"
   ],
   "sources": [
    {
     "title": "Accessible Rich Internet Applications (WAI-ARIA) 1.2",
     "publisher": "W3C",
     "url": "https://www.w3.org/TR/wai-aria-1.2/"
    },
    {
     "title": "Create cart permalinks",
     "publisher": "Shopify Dev Docs",
     "url": "https://shopify.dev/docs/apps/build/checkout/create-cart-permalinks"
    },
    {
     "title": "Directive 2011/83/EU on consumer rights",
     "publisher": "EUR-Lex (European Union)",
     "url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32011L0083"
    }
   ]
  },
  {
   "id": "guide/order-tasks-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/order-tasks-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/order-tasks-ai-agents/index.html.md",
   "title": "Order tracking, returns and reorders by AI agents",
   "description": "How to let AI agents track orders, start returns and reorder for customers without a login, and when to hand back to the person for security.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "How do I let AI agents track orders and start returns?",
    "text": "Give order lookup its own public page that asks only for the order number and email, and shows the status in words. Put a direct status link in every order email. Let returns open the same way, with a review step, and keep address changes, cancellations and saved card changes for the person to confirm."
   },
   "checks": [],
   "sources": [
    {
     "title": "RFC 6585: Additional HTTP Status Codes",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc6585.html"
    }
   ]
  },
  {
   "id": "guide/agentic-payments-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/agentic-payments-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/agentic-payments-ai-agents/index.html.md",
   "title": "Payments for AI agents: wallets, tokens and handing back",
   "description": "How payment works when an AI agent shops: handing back to the person, wallets, delegated payment programs, 3-D Secure, and what to do now.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 9,
   "answer": {
    "question": "How will AI agents pay on my online store?",
    "text": "On most stores today, the agent fills the cart and hands back to the person to pay. Make that handoff work by keeping carts alive, showing the full total in text before the payment form, and offering guest checkout and a clearly named wallet button. Delegated payment programs are early, so ask your payment provider what it supports."
   },
   "checks": [],
   "sources": [
    {
     "title": "Visa Intelligent Commerce",
     "publisher": "Visa",
     "url": "https://www.visa.com/en-us/solutions/intelligent-commerce"
    },
    {
     "title": "Agentic commerce",
     "publisher": "Stripe",
     "url": "https://docs.stripe.com/agentic-commerce"
    },
    {
     "title": "Agent Payments Protocol (AP2)",
     "publisher": "AP2 project",
     "url": "https://ap2-protocol.org/"
    },
    {
     "title": "EMV 3-D Secure",
     "publisher": "EMVCo",
     "url": "https://www.emvco.com/emv-technologies/3-d-secure/"
    },
    {
     "title": "Commission Delegated Regulation (EU) 2018/389 on strong customer authentication",
     "publisher": "European Union (EUR-Lex)",
     "url": "https://eur-lex.europa.eu/eli/reg_del/2018/389/oj"
    }
   ]
  },
  {
   "id": "guide/b2b-ordering-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/b2b-ordering-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/b2b-ordering-ai-agents/index.html.md",
   "title": "B2B ordering for AI agents: trade accounts, price lists and POs",
   "description": "How B2B sites can work for AI agents inside a trade account: price lists, quick order by SKU, reorders, quotes, PO numbers, approvals and delegated access.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 8,
   "answer": {
    "question": "How can AI agents help business buyers order from my trade site?",
    "text": "Once the buyer signs in, an agent can build the order if your account pages say everything in text. Show the buyer's own price next to the list price, with its price list and tax basis. Label quick order and purchase order fields, and state approval steps plainly, so the agent stops where a person must approve."
   },
   "checks": [],
   "sources": [
    {
     "title": "Offer",
     "publisher": "schema.org",
     "url": "https://schema.org/Offer"
    },
    {
     "title": "RFC 6749: The OAuth 2.0 Authorization Framework",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc6749.html"
    },
    {
     "title": "Model Context Protocol specification: Authorization",
     "publisher": "Model Context Protocol",
     "url": "https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization"
    }
   ]
  },
  {
   "id": "guide/delivery-slots-click-collect-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/delivery-slots-click-collect-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/delivery-slots-click-collect-ai-agents/index.html.md",
   "title": "Delivery slots and click and collect for AI agents",
   "description": "Make delivery work for AI agents: costs and cut-offs before checkout, postal code checks, readable slot and date pickers, and click and collect.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 8,
   "answer": {
    "question": "How can AI agents check my delivery dates and click and collect?",
    "text": "Show delivery costs and cut-off times, with a time zone and days, on product pages and a delivery page before checkout. Make postal code checks a labeled form with the result in text. Name each slot's day, time and price, mark full slots as fully booked, and list collection stores in text with stock and ready times."
   },
   "checks": [],
   "sources": [
    {
     "title": "ShippingDeliveryTime",
     "publisher": "schema.org",
     "url": "https://schema.org/ShippingDeliveryTime"
    },
    {
     "title": "OfferShippingDetails",
     "publisher": "schema.org",
     "url": "https://schema.org/OfferShippingDetails"
    },
    {
     "title": "Merchant shipping policy (ShippingService) structured data",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/structured-data/shipping-policy"
    },
    {
     "title": "Date Picker Dialog Example",
     "publisher": "W3C WAI ARIA Authoring Practices Guide",
     "url": "https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/examples/datepicker-dialog/"
    }
   ]
  },
  {
   "id": "guide/subscriptions-ai-agents",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/subscriptions-ai-agents/",
   "markdown": "https://ghostagentlab.com/articles/subscriptions-ai-agents/index.html.md",
   "title": "Subscriptions AI agents can start, pause and cancel",
   "description": "Make subscriptions clear for AI agents: plan prices and terms in the HTML, named controls to skip, pause and change, and a fair cancel path.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 8,
   "answer": {
    "question": "How do I make subscriptions easy for AI agents to manage?",
    "text": "Put the repeat price, billing period, any introductory offer and the cancellation terms in text in the plan page HTML. Give skipping, pausing and changing their own named buttons, with the next delivery or charge date in words. Make the cancel button as easy to find as sign-up, with one offer at most and a clear confirmation."
   },
   "checks": [],
   "sources": [
    {
     "title": "UnitPriceSpecification",
     "publisher": "schema.org",
     "url": "https://schema.org/UnitPriceSpecification"
    },
    {
     "title": "Web Content Accessibility Guidelines (WCAG) 2.2",
     "publisher": "W3C",
     "url": "https://www.w3.org/TR/WCAG22/"
    }
   ]
  },
  {
   "id": "guide/measure-ai-agent-traffic",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/measure-ai-agent-traffic/",
   "markdown": "https://ghostagentlab.com/articles/measure-ai-agent-traffic/index.html.md",
   "title": "Why your analytics can't see AI agents, and how to measure agent traffic",
   "description": "JavaScript analytics tags miss most AI agents. How to measure agent traffic from server and CDN logs, and what to track: who's visiting, who's real, and where they're blocked.",
   "published": "2026-10-08",
   "modified": "2026-10-08",
   "readMinutes": 7,
   "answer": {
    "question": "Why can't Google Analytics show me AI agent visits?",
    "text": "Most AI agents never run your analytics tag, analytics tools filter out known bots, and browser agents look like ordinary visitors. To measure agent traffic, use your server or CDN logs, which record every request. Verify agents against their operators' published IP ranges or reverse DNS, then track who visits, what they read and where they're blocked."
   },
   "checks": [],
   "sources": [
    {
     "title": "Known bot-traffic exclusion",
     "publisher": "Google Analytics Help",
     "url": "https://support.google.com/analytics/answer/9888366"
    },
    {
     "title": "Logpush",
     "publisher": "Cloudflare Docs",
     "url": "https://developers.cloudflare.com/logs/logpush/"
    },
    {
     "title": "Working with Drains",
     "publisher": "Vercel Docs",
     "url": "https://vercel.com/docs/drains"
    },
    {
     "title": "Overview of OpenAI Crawlers",
     "publisher": "OpenAI",
     "url": "https://developers.openai.com/api/docs/bots"
    }
   ]
  },
  {
   "id": "guide/ai-referral-traffic",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/ai-referral-traffic/",
   "markdown": "https://ghostagentlab.com/articles/ai-referral-traffic/index.html.md",
   "title": "Tracking visits and sales that come from AI assistants",
   "description": "How to spot visits from ChatGPT, Perplexity and other AI assistants in your analytics, report them in GA4, and understand what attribution misses.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "How do I track visits and sales from ChatGPT and other assistants?",
    "text": "People who click links in AI answers show up in your analytics through referrer domains such as chatgpt.com and perplexity.ai, or campaign tags. In GA4, create a custom channel group for AI assistants placed above Referral, and check your referral report monthly for new sources. Report the result as a floor, since app visits and copied links arrive as direct."
   },
   "checks": [],
   "sources": [
    {
     "title": "Custom channel groups",
     "publisher": "Google Analytics Help",
     "url": "https://support.google.com/analytics/answer/13051316"
    },
    {
     "title": "AI Features and Your Website",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/ai-features"
    },
    {
     "title": "Overview of OpenAI Crawlers",
     "publisher": "OpenAI",
     "url": "https://developers.openai.com/api/docs/bots"
    }
   ]
  },
  {
   "id": "guide/agent-readiness-kpis",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/agent-readiness-kpis/",
   "markdown": "https://ghostagentlab.com/articles/agent-readiness-kpis/index.html.md",
   "title": "Agent readiness KPIs: what to report each month",
   "description": "A monthly agent readiness report in six measures: AgentScore, agent visits, verification, blocks and errors, Ghost Agent pass rates and AI referrals.",
   "published": "2026-10-09",
   "modified": "2026-10-21",
   "readMinutes": 6,
   "answer": {
    "question": "What agent readiness numbers should I report each month?",
    "text": "Report six measures on one page: AgentScore, agent visits by type, the share of agent traffic that's verified, blocks and errors, pass rates for journeys tested with AI agents, and AI referral visits and orders. Compare each with your own trend, read them together, give each one owner, and note what changed that month."
   },
   "checks": [],
   "sources": []
  },
  {
   "id": "guide/agent-errors-in-logs",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/agent-errors-in-logs/",
   "markdown": "https://ghostagentlab.com/articles/agent-errors-in-logs/index.html.md",
   "title": "Finding the errors AI agents hit, in your server and CDN logs",
   "description": "How to find the 403s, 429s, challenges, timeouts and server errors AI agents hit in your logs, with example queries and how to separate real agents from fakes.",
   "published": "2026-10-09",
   "modified": "2026-10-09",
   "readMinutes": 5,
   "answer": {
    "question": "How do I find out if AI agents are being blocked?",
    "text": "Check your server and CDN logs for the errors AI agents get, such as 403 blocks, 429 rate limits, challenge pages, timeouts and 404s. Then check each blocked agent against its operator's published IP ranges or reverse DNS. Fix rules that stop verified agents, keep blocking impostors, and repeat after every bot protection or CDN change."
   },
   "checks": [],
   "sources": [
    {
     "title": "Overview of OpenAI Crawlers",
     "publisher": "OpenAI",
     "url": "https://developers.openai.com/api/docs/bots"
    },
    {
     "title": "Detect a Challenge Page response",
     "publisher": "Cloudflare Docs",
     "url": "https://developers.cloudflare.com/cloudflare-challenges/challenge-types/challenge-pages/detect-response/"
    },
    {
     "title": "Module ngx_http_log_module",
     "publisher": "nginx",
     "url": "https://nginx.org/en/docs/http/ngx_http_log_module.html"
    },
    {
     "title": "RFC 6585: Additional HTTP Status Codes",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc6585.html"
    }
   ]
  },
  {
   "id": "guide/benchmark-competitors-agent-readiness",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/benchmark-competitors-agent-readiness/",
   "markdown": "https://ghostagentlab.com/articles/benchmark-competitors-agent-readiness/index.html.md",
   "title": "Benchmarking your agent readiness against competitors",
   "description": "How to benchmark agent readiness against competitors fairly: AgentScore on each site, categories not totals, store study context and hand checks.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 8,
   "answer": {
    "question": "How do I compare my agent readiness with my competitors?",
    "text": "Scan three to five comparable competitors with AgentScore on the same day, then compare category scores and individual checks rather than totals. Only compare checks that ran on both sites. Add a few journeys checked by hand as an ordinary shopper, stopping before you pay, then fix access gaps first and repeat the benchmark every quarter."
   },
   "checks": [],
   "sources": [
    {
     "title": "RFC 9309: Robots Exclusion Protocol",
     "publisher": "IETF",
     "url": "https://www.rfc-editor.org/rfc/rfc9309.html"
    },
    {
     "title": "Accessibility features reference",
     "publisher": "Chrome for Developers",
     "url": "https://developer.chrome.com/docs/devtools/accessibility/reference"
    }
   ]
  },
  {
   "id": "guide/brand-answers-ai-assistants",
   "kind": "guide",
   "url": "https://ghostagentlab.com/articles/brand-answers-ai-assistants/",
   "markdown": "https://ghostagentlab.com/articles/brand-answers-ai-assistants/index.html.md",
   "title": "Tracking how AI assistants describe your brand",
   "description": "How to track what AI assistants say about your brand: a fixed question set, competitors, answers recorded over time, fact checks and fixing the source.",
   "published": "2026-10-20",
   "modified": "2026-10-20",
   "readMinutes": 7,
   "answer": {
    "question": "How do I track what AI assistants say about my brand?",
    "text": "Write a fixed set of 15 to 25 shopper questions and ask each several times, in fresh conversations, on a regular schedule. Record whether you're named, which competitors appear, the facts stated and the pages cited. Trace every wrong fact or missing mention to a page, and fix your own pages first, starting with access."
   },
   "checks": [],
   "sources": [
    {
     "title": "AI features and your website",
     "publisher": "Google Search Central",
     "url": "https://developers.google.com/search/docs/appearance/ai-features"
    },
    {
     "title": "Overview of OpenAI crawlers",
     "publisher": "OpenAI",
     "url": "https://developers.openai.com/api/docs/bots"
    },
    {
     "title": "Does Anthropic crawl data from the web, and how can site owners block the crawler?",
     "publisher": "Anthropic",
     "url": "https://support.claude.com/en/articles/8896518-does-anthropic-crawl-data-from-the-web-and-how-can-site-owners-block-the-crawler"
    },
    {
     "title": "Web search tool",
     "publisher": "Anthropic",
     "url": "https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool"
    }
   ]
  }
 ]
}
