0/100
min 0
AISO SCAN · combined· SCANNED 28D AGO
code.claude.com
How AI sees it: invisible · preview · 29 critical issues blocking AI agents.
AISO SCORE0/100Invisible29 critical
How AI sees it: invisible · preview · 29 critical issues blocking AI agents.
AISO fixBreak paragraphs above 400 words with subheadings, lists, or bolded facts
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 fixEnsure buttons have discernible text See https://dequeuniversity.com/rules/axe/4.11/button-name?application=axeAPI
AISO fixMaintain readable structure + recency: clear headings/lists for chunkability, recent updated-at dates, no stale fact decay, answer-extractable formatting (Q→A, def→explanation).
AISO fixCite at least one .edu/.gov, Wikipedia, IETF/W3C spec, or tier-1 publication near your flagship claims.
AISO fixWrap the FAQ with a FAQPage JSON-LD block so AI engines can lift the Q/A pairs verbatim.
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 fixEnsure every id attribute value of active elements is unique See https://dequeuniversity.com/rules/axe/4.11/duplicate-id-active?application=axeAPI
AISO fixMost claims lack inline sources within 200 chars. LLMs heavily discount uncited statistics. Add anchor links to primary sources, "according to" attributions, or numeric footnote refs.
AISO fixAdd a /best-X-alternatives or /you-vs-competitor page
AISO fixAdd a TL;DR sentence or '<Brand> is a <category> that …' lead at the top
AISO fixOpen the homepage with '<Brand> is a <category> that <differentiator>' — this is the single biggest lever for AI citability.
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 fixPublish JSON-LD with Organization/Service nodes including `audience` and `aggregateRating` properties so LLMs can extract market-fit signals.
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 fixscript-src 'self'; default-src 'self';
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 fixBold key statistics, definitions, and claims so AI can cite them
AISO fixRemove hidden instruction-like content, suspicious HTML comments, invisible text, and data attributes that target LLM behavior. Public pages should not contain prompt directives.
AISO fixEvery % / 'X customers' / stat deserves an inline citation link to the origin study or publication.
AISO fixValidate the response from your manifest URL. The body must parse as JSON. Re-serve with `Content-Type: application/json`.
AISO fixComparative pages can over-index on the competitor name. Rebalance copy so your own brand is the dominant entity per section.
AISO fixReturn valid JSON at /ai/faq.json with a faqs array of {question, answer, source_url} objects.
AISO fixReturn valid JSON at /ai/service.json shaped like a schema.org Service (@type, name, provider).
AISO fixReturn valid JSON at /ai/summary.json with at least name and description fields. Validate with a JSON linter.
AISO fixPrioritize: Frequently Asked Questions about AI Agent Tooling; AI Agent Tooling Glossary: Key Terms Explained.
AISO fixbridge fetch failed: fetch failed
AISO fixbridge fetch failed: fetch failed
AISO fixbridge fetch failed: fetch failed
AISO fixLift the lowest-scoring dimensions in `composite_inputs` first; citation-crawl and agent-readiness move the headline metric the most.
AISO fixEnsure all page content is contained by landmarks See https://dequeuniversity.com/rules/axe/4.11/region?application=axeAPI
AISO fixUse exactly one H1, ensure the first H2 precedes any H3, and give every H2 a clear topic label (3+ words).
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 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 fixAdd /.well-known/ai.txt with your AI/agent policy in RFC9116-style key:value lines or short markdown.
AISO fixAdd a 2–4 sentence paragraph immediately after the H1 summarising what the product is and who it serves.
AISO fixOpen with 'We are ...' / 'Our mission is ...' / 'This is ...' — AI models need explicit entity framing.
AISO fixAdd <time datetime='YYYY-MM-DD'>Updated ...</time> or article:modified_time meta, or expose dateModified in Article JSON-LD.
AISO fixobject-src 'none';
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 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 fixAdd statistical claims to drive AI-citation rate +30-40% (Aggarwal Princeton GEO 2024).
AISO fixworker-src 'self' https://trusted.example; (replace wildcards with explicit hosts)
AISO fixAdd explicit entity surfaces: about or company page, team or founder page, pricing page.
AISO fixAim for 3-11 words of context-bearing description per non-decorative image.
AISO fixImprove the underlying dimensions that drive chatgpt citations: crawlability, structure, schema, freshness, entity clarity, and trust.
AISO fixdefault-src 'self';
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 fixWrap term/definition pairs in <dl><dt>term</dt><dd>def</dd></dl> markup
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 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 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 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 paid agent/API access is supported, document x402 payment flow, supported networks/tokens, payment headers, and facilitator behavior.
AISO fixConfigure TINYFISH_API_KEY and BRAVE_SEARCH_API_KEY to cross-check rendered fetchability and search-index visibility.
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 fixRun Template Audit, Full Site, or Deep Investigation mode to compare key templates across the site.
AISO fixPages about prices, versions, launches, or changing data should expose a clear last-updated date and refresh cadence.
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.
# code.claude.com
> Public profile for agent-readable discovery.
Canonical: https://code.claude.com/docs/en/plugins
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": "code.claude.com",
"url": "https://code.claude.com/docs/en/plugins",
"description": "Public profile for agent-readable discovery.",
"offers": [],
"actions": [],
"evidence": []
}{
"schema": "aios.mcp_manifest.v1",
"name": "code.claude.com",
"profile_url": "https://code.claude.com/docs/en/plugins",
"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.