How AI sees it: invisible · preview · 34 critical issues blocking AI agents.
AISO fixSend a Content-Security-Policy response header (or <meta http-equiv> tag) so directive strictness can be scored.
AISO fixBuild cited-by signals: domain authority (OpenPageRank), placements on high-DR publications (TechCrunch, ProductHunt, etc), patent/news mentions. Authority is the #1 driver of LLM citations.
AISO fixMention the brand at least once like "Example is a [category] for [audience]" for clean LLM resolution.
AISO fixMake WHO you are unambiguous: Organization JSON-LD with sameAs links, agent-discovery files (llms.txt + .well-known manifests), structured contact + offer data so delegate agents can transact.
AISO fixMeta description should be 40+ chars; LLMs use it as the cited summary on SERPs and AI overviews.
AISO fixSend `Strict-Transport-Security: max-age=63072000; includeSubDomains; preload` to force browsers to use HTTPS for the configured duration. Submit the domain to https://hstspreload.org/ once the header is stable.
AISO fixAdd headings like '<Product> vs <Competitor>' to comparison content
AISO fixPublish an About page with at least 500 words covering who you are, when you were founded, and your team. Use h2 subheadings (Mission, Team, History). Provenance is one of the strongest E-E-A-T signals.
AISO fixPublish a /faq page or link a help center from the homepage navigation.
AISO fixPublish /llms.txt at the site root with '# <Project>' + a short summary + H2 sections linking to canonical doc URLs.
AISO fixPublish a privacy policy at /privacy. Legal requirement in many jurisdictions; also a strong E-E-A-T trust signal.
AISO fixExpose a public API reference or OpenAPI document at /docs/api, /openapi.json, or an equivalent developer URL so agents can understand callable surfaces.
AISO fixSend `X-Frame-Options: DENY` (or `SAMEORIGIN`) OR include `frame-ancestors 'none'` (or a hostname allowlist) in your CSP. Without either, the site can be iframed and clickjacked.
AISO fixWrap term/definition pairs in <dl><dt>term</dt><dd>def</dd></dl> markup
AISO fixAdd a /best-X-alternatives or /you-vs-competitor page
AISO fixOpen the homepage with '<Brand> is a <category> that <differentiator>' — this is the single biggest lever for AI citability.
AISO fixAdd a FAQ block with ≥5 question/answer pairs using <details>/<summary> or <h3>+<p> patterns. Also mark it up with FAQPage JSON-LD.
AISO fixAdd FAQPage schema with 5-10 high-frequency questions for AI-search retrieval.
AISO fixAdd an HTML <table> with <th>feature</th>/<th>price</th> columns
AISO fixAdd a Person JSON-LD entry for founder/principal author with sameAs links.
AISO fixAdd a glossary page with 5+ defined terms
AISO fixDefine key terms explicitly: '**AI Agent** is a software program that...'
AISO fixBuild at least a basic navigation menu linking the homepage to product, pricing, and content pages. Without internal links, AI crawlers can't traverse the site.
AISO fixPublish JSON-LD with Organization/Service nodes including `audience` and `aggregateRating` properties so LLMs can extract market-fit signals.
AISO fixStructured data (Organization, LocalBusiness, FAQ, Article) is the strongest GEO signal — LLMs prefer schema-typed entities.
AISO fixPublish JSON-LD blocks (`<script type="application/ld+json">`) describing your offer/service, address, and contact methods. Without structured data, delegate agents can't transact on your behalf.
AISO fixPublish Organization JSON-LD with name + url + sameAs for entity association.
AISO fixAdd Pros/Cons sections to comparison and review pages
AISO fixAdd an explicit '<h2>FAQ</h2>' or 'Frequently Asked Questions' section with at least 3 items.
AISO fixPublish a /robots.txt that explicitly allows GPTBot, ClaudeBot, PerplexityBot, Google-Extended and other AI crawlers.
AISO fixAdd <script type='application/ld+json'> with @type:Organization including name, url, logo, and sameAs (≥3 social profiles).
AISO fixIncrease the sampled-page count to evaluate internal connectivity
AISO fixRemove agent-hostile signals: prompt-injection patterns, broken links, deceptive cloaking, robots conflicts. Agents discount hosts that look unsafe to act on.
AISO fixFix crawl access first: ensure 200 OK on homepage + sitemap, valid JSON-LD, llms.txt published, SSR-rendered content, and a non-blocking CSP. Without this layer agents can't read the site.
AISO fixAim for 5-10 explicit brand mentions in body copy. Helps LLMs build a clean entity-page association during indexing.
AISO fixPrioritize: Frequently Asked Questions about Example; Example Glossary: Key Terms Explained.
AISO fixMissing: strict-transport-security, x-content-type-options, x-frame-options, content-security-policy, x-xss-protection, referrer-policy.
AISO fixEnsure all page content is contained by landmarks See https://dequeuniversity.com/rules/axe/4.11/region?application=axeAPI
AISO fixEnsure the document has a main landmark See https://dequeuniversity.com/rules/axe/4.11/landmark-one-main?application=axeAPI
AISO fixAdd H2/H3 section breaks every ~500 words to scaffold the content
AISO fixSurface at least 2 contact channels on the homepage: a visible phone number, physical address, contact <form>, or mailto: link. AI rankers correlate contact accessibility with trustworthiness.
AISO fixPopulate <meta name='description'> and <meta property='og:image'> in the server response. If your framework injects them client-side via react-helmet or similar, switch to a server-side metadata API (Next.js generateMetadata, Nuxt useHead with server: true).
AISO fixSend `Referrer-Policy: strict-origin-when-cross-origin` to balance analytics utility with privacy. Without it browsers fall back to a permissive default that leaks full URLs across origins.
AISO fixSend `X-Content-Type-Options: nosniff` so browsers won't MIME-sniff responses and execute disguised resources.
AISO fixAdd /.well-known/ai.txt with your AI/agent policy in RFC9116-style key:value lines or short markdown.
AISO fixPublish an About page listing founders, team, and credentials. AI engines heavily weight provenance.
AISO fixPublish /ai/summary.json with name, description, founded, services[], contact, and brand_assets so agents skip HTML scraping.
AISO fixPublish terms of service at /terms or /terms-of-service. Standard trust signal.
AISO fixPublish /llms.txt and, when relevant, a .well-known agent/plugin manifest that points agents at docs, APIs, MCP endpoints, and support policies.
AISO fixDocument the skills, actions, tools, or capabilities agents can use. Include names, input schemas, output shapes, auth requirements, and whether each action is read-only or writes data.
AISO fixPublish an AGENTS.md at your repo or web root listing the skills, conventions, and tools agents should use when working with your codebase or service.
AISO fixOpen with 'We are ...' / 'Our mission is ...' / 'This is ...' — AI models need explicit entity framing.
AISO fixPublish at least one of /editorial-standards, /editorial-policy, /fact-checking, /corrections. LLM rankers down-weight content from sources without explicit editorial transparency.
AISO fixPublish an MCP endpoint or setup guide, then link it from the homepage or llms.txt. Agents should be able to discover tool access without reading human-only docs.
AISO fixConcrete claims (percentages, customer counts, dates, comparative superlatives) drive trust + LLM citation likelihood. Add specific stats with sources.
AISO fixBold key statistics, definitions, and claims so AI can cite them
AISO fixUse numbered and bullet lists to expose key facts
AISO fixAim for 134-167 words per h2-bounded section — zubair's empirical citability optimum. Long sections get truncated; short ones don't carry enough signal.
AISO fixRestructure paragraphs to 30-120 words each. RAG retrievers favour self-contained spans of this size.
AISO fixAdd 'according to', 'source:', or numeric footnote references. LLMs cite content that points at primary sources.
AISO fixAdd statistical claims to drive AI-citation rate +30-40% (Aggarwal Princeton GEO 2024).
AISO fixAdd explicit entity surfaces: about or company page, team or founder page, pricing page, docs or API page.
AISO fixImprove the underlying dimensions that drive chatgpt citations: crawlability, structure, schema, freshness, entity clarity, and trust.
AISO fixImprove the underlying dimensions that drive claude citations: crawlability, structure, schema, freshness, entity clarity, and trust.
AISO fixCustom-built sites can still rank, but CMS detection lets agent fixes target the right platform.
AISO fixAdd a unique <title>, meta description, and canonical URL. Add Open Graph/Twitter tags for share and citation previews.
AISO fixImprove the underlying dimensions that drive google_ai citations: crawlability, structure, schema, freshness, entity clarity, and trust.
AISO fixAdd ItemList JSON-LD schema to comparison pages
AISO fixAdopt and reuse a small vocabulary of capitalised brand terms
AISO fixMention 2-3 explicit competitors with comparison points
AISO fixOG image drives social previews and is referenced by some AI image-aware crawlers.
AISO fixSend `Permissions-Policy` (formerly Feature-Policy) explicitly declaring which browser features (camera, microphone, geolocation, payment, …) the site uses. Default-deny posture: `camera=(), microphone=(), geolocation=()`.
AISO fixOptional: publish /.well-known/agent.json (A2A or MCP manifest) so agent runtimes can discover capabilities.
AISO fixPublish /ai/faq.json as { faqs: [{ question, answer, source_url }] } so agents can cite your answers verbatim.
AISO fixPublish /ai/service.json as a schema.org Service object describing what you sell, area served, and provider.
AISO fixAdd author / contributor profile pages and link them from the homepage (e.g. <a href="/author/jane">). LLMs use these to ground claims to a named expert.
AISO fixAI bot allowlists rely on robots.txt — missing file means default-allow but no policy signal.
AISO fixWithout a sitemap, AI crawlers must infer URL structure from links.
AISO fixExpose a crawlable sitemap (sitemap.xml or sitemap.md) and stable navigation to docs, pricing, support, API references, and key task pages. Agents need predictable links, not only app-shell buttons.
AISO fixAdd CLI install/use docs when your product can be operated from CI, terminals, or coding agents. Include copy-paste commands and JSON output examples.
AISO fixDocument auth, API keys/OAuth, rate limits, webhooks, SDKs, sandbox/test mode, and status-page behavior so agents can call tools safely.
AISO fixIf the homepage surfaces editorial content, include an author byline (Person JSON-LD or 'By <Name>').
AISO fixAdd a Person JSON-LD block with `name` and `jobTitle` for the founder / editor-in-chief / lead author. Anchors authorship to a named human, which LLMs use for credibility ranking.
AISO fixIf the service supports temporary agent visits, publish a Portal manifest at /portal with tool metadata and a call endpoint, then link it from docs and llms.txt.
AISO fixAdd links to Wikipedia, LinkedIn company page, YouTube channel, or GitHub org so AI engines can cross-reference authority.
AISO fixSites without an archive history are weaker citation candidates for LLMs that prefer aged sources.
AISO fixIf the site supports browser-native agent access, publish a WebMCP endpoint or discovery document and link it from developer docs and llms.txt.
AISO fixIf you intend to expose agentic surfaces, publish a WebMCP manifest at `/.well-known/webmcp.json` with version + entrypoint + tools list.
AISO fixIf paid agent/API access is supported, document x402 payment flow, supported networks/tokens, payment headers, and facilitator behavior.
AISO fixAdd 'founder': [{ @type: Person, name: ... }] to the Organization schema.
AISO fixWe will retry on the next scan. No action needed on your side.
AISO fixImprove the underlying dimensions that drive perplexity citations: crawlability, structure, schema, freshness, entity clarity, and trust.
AISO fixProvide business_name + area in ScanContext.agntBridge so the bridge can call this lane.
AISO fixIf you launch localised variants (e.g. /es, /de, fr.example.com), add `<link rel="alternate" hreflang="...">` tags pointing at each variant plus `x-default`.
AISO fixProvide social_links in ScanContext.agntBridge so the bridge can call this lane.
AISO fixExpand thin pages with direct answers, evidence, FAQs, and specific facts before expecting AI engines to cite them.
AISO fixAdd concrete numbers, dates, and named entities. LLMs cite specifics — '47% of teams use X' beats 'many teams use X'.
AISO fixRun Template Audit, Full Site, or Deep Investigation mode to compare key templates across the site.
Deterministic extraction from stored page context: identity, offers, actions, files, trust, and evidence.
No grounded description found.
No structured offer or price evidence found.
No booking, buying, contact, quote, or API path found.
No llms.txt, agents.json, mcp.json, x402.json, profile.json, or offers.json found.
Agents need a stable name, category, and short description before they can explain the page.
Agents cannot recommend, compare, or transact without a grounded offer or price.
Agents need explicit next actions instead of guessing how to engage.
Files such as llms.txt, agents.json, mcp.json, profile.json, and offers.json make the site directly readable.
Paste these into the public agent files your site is missing, then rescan.
# example.com
> Public profile for agent-readable discovery.
Canonical: https://example.com/
Agent-readable schema: aios.agent_readable.v1
## Offers
- Add structured offers.
## Actions
- Add book, buy, quote, contact, or API actions.{
"schema": "aios.agent_readable.v1",
"name": "example.com",
"url": "https://example.com/",
"description": "Public profile for agent-readable discovery.",
"offers": [],
"actions": [],
"evidence": []
}{
"schema": "aios.mcp_manifest.v1",
"name": "example.com",
"profile_url": "https://example.com/",
"tools": [
{
"name": "ask_profile",
"description": "Answer questions using grounded public profile context."
},
{
"name": "get_offers",
"description": "Return structured offers with prices, URLs, and evidence."
},
{
"name": "start_action",
"description": "Open the best booking, buying, quote, contact, or API action."
}
]
}Every check rolls up into covered, not captured, or planned-only. Click-through rows below stay tied to stored signals only.
AISO maps llms.txt and WebMCP overlap with Chrome Lighthouse's experimental agentic audits. This is an overlap map, not a Lighthouse pass/fail claim.
Web3 surfaces, Solidity and Rust audit, content quality, and site-wide context intelligence ship via the AISO Web Context Engine plus planned TOOLBOX code-audit workers. Cards below show what each module checks; metrics populate once the context-shard dispatch is enabled for your tier.
Wallet-connect, contract addresses, x402 endpoint health, ENS, chain metadata, exposed ABI and token metadata.
Context Engine - scrape regex + actionsFlesch-Kincaid readability, AI-readability, thin pages, duplicate content, keyword stuffing and original-research density.
Context Engine - scrape + researchSitemap coverage %, scrape markdown quality, crawl-discovered pages, entity knowledge-graph presence, research-synthesized authority and wire-extractor results.
Context Engine - scrape + map + crawl + researchAgent readiness is discovery, metadata, proof, offers, actions, protocols, and safe access together.
Sequential. Most of it auto-generates when you install Agent Link; the scanner verifies the result on the next pass.
The preview above stays visible. The detailed scanner rows, provider evidence, PDF export, and long copy-paste repair prompt are behind a one-time Stripe checkout. Referral attribution is preserved through the signed AISO referral cookie when present.
The detail rows, provider evidence, repair prompt and PDF export are behind a one-time unlock. The preview cards above stay visible.