www.codaquest.com
Strong technical baseline
Task
What does www.codaquest.com do and who is it for? Explain it back to me.
Critical access needs attention
These checks describe whether an ordinary agent can enter, read, and operate the public site.
- 2 / 2 passed
Agents can reach the site
Crawler access and bot defenses.
- 1 / 2 passed
Core content is available
Useful content remains accessible without a fragile browser-only path.
- 2 / 2 passed
Navigation fails safely
Redirects and missing pages give agents a recoverable path.
- 3 / 3 passed
Controls are understandable
Forms and interactive controls expose usable names and structure.
Evaluated surfaces are technically strong
The public website is always evaluated. Optional surfaces appear when the scan finds positive evidence that they apply.
Public website
Strong
14 of 16 mature checks passed
Fix these gaps first
Critical access gaps come first, followed by other applicable readiness gaps.
- 01Critical access
Content without JavaScript
Server-side render your homepage so AI crawlers see meaningful content without JavaScript. Ensure an H1 and 500+ chars of text in raw HTML.
- 02Other readiness checks
Brand name discoverability
Make sure a clean search for your brand name returns your own domain in the top results. If it does not, your brand may be too generic, conflict with a more established term, or not yet indexed. Strengthen brand-name search by claiming consistent NAP across listings, earning press mentions that link to the canonical domain, and avoiding redirect chains that mask the apex domain in search results.
Audit the checks behind the score
Applicable evidence is grouped by how it contributes to this preview model. Bonus checks appear only when they add points.
Essential6 of 7 passed · 76.2 / 80 points
- Content without JavaScriptPartial (67%)
11781 chars with H1 but flat heading structure
Recommendation
Server-side render your homepage so AI crawlers see meaningful content without JavaScript. Ensure an H1 and 500+ chars of text in raw HTML.
- Not blocked by bot detectionPassed
Site accessible to 6 AI agent user-agents
Recommendation
Allowlist known AI agent User-Agents (ChatGPT-User, ClaudeBot, Google-Extended, DeepSeekBot) in your WAF or bot-detection rules.
- Redirect hygienePassed
No meta-refresh stubs, JavaScript-redirect stubs, or cross-domain hops across 6 checked pages
Recommendation
Replace meta-refresh and JavaScript-only redirects with real HTTP 301/302 redirects. Non-JS agents never execute
location.hrefor wait for a meta refresh - they see only the stub page. Verify withcurl -sI <url>- you should see a Location header, not a 200 with a near-empty body. - Content behind authPassed
All 5 sampled pages are publicly readable (5 with substantive content)
Recommendation
Serve your content pages without a login wall. Agents cannot complete auth flows while browsing - a 401/403 or a login-form page is invisible content. Keep public documentation public; if some content must stay gated, publish an ungated summary so agents can still represent it.
- Markdown content negotiation (acceptmarkdown.com)Passed
Canonical URL serves text/markdown and text/html via Accept negotiation with Vary: Accept
Recommendation
On the responses that serve text/markdown via Accept negotiation, add Accept to the Vary header (Vary: Accept, Accept-Encoding). Without it, CDNs can serve the cached HTML variant to an agent asking for markdown (or vice versa), depending on which variant landed in cache first.
- Agent crawler reachabilityPassed
Reachable to all major AI crawlers - ChatGPT-User: reachable, ClaudeBot: reachable, Google-Extended: reachable, ora-agent: reachable, DeepSeekBot: reachable
Recommendation
Verify that major agent User-Agents can reach the homepage. If your WAF or bot rules block them, remove or narrow the blocking rule. Add an allow rule only when your security setup denies them by default.
- Agent-friendly 404sPassed
Nonexistent paths return HTTP 404 with markdown guidance for agents - the strongest 404 contract
Recommendation
Return a real HTTP 404 (or 410) status for nonexistent paths - never a 200 with your app shell, which makes agents believe every path exists. For full credit, give the 404 response a short markdown body pointing agents at your sitemap, llms.txt, or docs index. Verify with
curl -s -o /dev/null -w "%{http_code}" https://yourdomain.com/some-path-that-does-not-exist- it must print 404.
Recommended8 of 9 passed · 19.3 / 20 points
- Brand name discoverabilityPartial (67%)
codaquest.com appears 2 times in brand-name search results for "Codaquest" (top position: #4)
Recommendation
Make sure a clean search for your brand name returns your own domain in the top results. If it does not, your brand may be too generic, conflict with a more established term, or not yet indexed. Strengthen brand-name search by claiming consistent NAP across listings, earning press mentions that link to the canonical domain, and avoiding redirect chains that mask the apex domain in search results.
- Sitemap existsPassed
Valid sitemap found at https://www.codaquest.com/sitemap.xml with 31 entries
Recommendation
Add a valid XML sitemap at /sitemap.xml listing all indexable URLs. Include lastmod dates and keep it under 50MB.
- JSON-LD structured dataPassed
Rich JSON-LD identity: Organization with name, description, url, and sameAs/logo/address (10 block(s))
Recommendation
Add JSON-LD structured data to your homepage using the identity type that matches your site - SoftwareApplication for products, Organization or LocalBusiness for companies, Person for personal sites, Article for blogs - with name, description, url, and type-appropriate fields (offers, sameAs, author) so AI can parse your identity programmatically.
- Agent instruction / when-to-usePassed
Agent instruction with when-to-use guidance at /.well-known/agent-skills/
Recommendation
Tell agents when to reach for you: add a 'when to use this' section to your llms.txt (or a dedicated agent-instructions file) that names your best-fit use cases and how an agent should call you. Be specific about the jobs you are right for - generic marketing copy does not read as guidance.
- Metadata completenessPassed
All metadata signals present: canonical URL, lang="fr", og:image, og:type
Recommendation
Add all four signals to your homepage: , , , and . Agents use these for entity resolution and attribution.
- Organization schema completenessPassed
Organization schema complete with contactPoint and address
Recommendation
Add Organization JSON-LD that includes both contactPoint (with email/phone and contactType) and address (PostalAddress). This lets AI verify your business legitimacy and answer contact queries.
- Trust anchor pagesPassed
All trust anchor pages verified: About, Contact, Privacy
Recommendation
Publish real /about, /contact, and /privacy pages with at least 500 characters of content each. These are the pages AI agents check to verify your business is legitimate before recommending you.
- Page token budgetPassed
All 6 measured pages fit an agent context budget (largest ~3K tokens)
Recommendation
Keep each page's extracted text under ~100K characters (~25K tokens) so it fits an agent's context window without truncation. Split oversized reference pages into focused per-topic documents and link them from an index. Check a page with
curl -s <url> | wc -cand remember agents read the extracted text, not the raw HTML. - Code fence validityPassed
Code fences balanced across 1 markdown document
Recommendation
Close every fenced code block (``` or ~~~) in your served markdown. CommonMark treats everything after an unclosed fence as code, so an agent parsing the document silently loses the rest of it. Count fence lines per file - the total must be even.
Bonus signals20 positive · +4.9 points
- ARD / ai-catalogPassed
ARD catalog valid (spec 1.0) - 4/4 entries, trustManifest present
Recommendation
Publish an Agentic Resource Discovery catalog at /.well-known/ai-catalog.json listing your agentic resources (MCP servers, agents, skills, APIs), each entry with a urn:air identifier, a media type, and exactly one of url or data. See https://agenticresourcediscovery.org/
- ARD entry validityPassed
All 4 entries valid with domain-anchored urn:air identifiers
Recommendation
Make every ai-catalog.json entry fully valid: a domain-anchored urn:air identifier, a displayName, a media type, and exactly one of url or data.
- ARD trust manifestPassed
trustManifest present on catalog entries (4/4 entries valid)
Recommendation
Add a trustManifest (verifiable identity, compliance attestations, or signature) to your ai-catalog.json entries so clients can verify your resources with progressive trust.
- Agent discovery filePassed
Agent Skills index (agentskills.io) found at /.well-known/agent-skills/index.json with 1 skill(s)
Recommendation
Publish an Agent Skills index at /.well-known/agent-skills/index.json that lists your capabilities, with each skill carrying a name and a description so agents can find and parse what you offer.
- Agent Skills index conformance (v0.2.0)Passed
Index v0.2.0 conformant; verified SHA-256 of "codaquest"
Recommendation
Upgrade /.well-known/agent-skills/index.json to the v0.2.0 schema: add "$schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json", and give every entry a type (skill-md or archive), url, and digest. Use "digest": "sha256:<64 lowercase hex chars>" (e.g. "digest": "sha256:a3f1...") - a bare "sha256": "" field is also accepted. Compute the value from the artifact's raw bytes.
- pricing.md existsPassed
Structured pricing.md found at /pricing.md (62 lines)
Recommendation
Create a /pricing.md file with your pricing tiers, features, and limits in plain markdown. This lets AI agents compare costs and recommend plans without scraping HTML pricing pages.
- MCP well-known discoveryPartial (50%)
MCP server at https://help.codaquest.com/mcp - consider adding /.well-known/mcp for standard discovery
Recommendation
Serve your MCP server at /.well-known/mcp, publish a server-card.json at /.well-known/mcp/server-card.json, or reference it in llms.txt so agents can discover it automatically without manual URL input.
- HTTP Link headers (RFC 8288)Passed
RFC 8288 Link header advertises: alternate(markdown)
Recommendation
Add HTTP Link: response headers (RFC 8288) advertising your sitemap, markdown alternates, API service descriptions, and API catalog. Example: Link: </sitemap.xml>; rel="sitemap", </index.md>; rel="alternate"; type="text/markdown".
- Sitemap freshness (lastmod)Passed
100% of 31 sampled sitemap entries carry lastmod; newest is 0 day(s) old
Recommendation
Add dates (W3C datetime, e.g. 2026-08-01) to your sitemap entries and update them when content actually changes. Aim for lastmod on at least half your entries with the newest within the last year. Verify with
curl https://yourdomain.com/sitemap.xml | grep lastmod. - llms.txt existsPassed
Found the llms.txt at https://codaquest.com/llms.txt.
Recommendation
Create an llms.txt file at your domain root (/llms.txt) - the AI equivalent of robots.txt. Write at least 100 characters of real content: what your product is, what it does, and links to your key docs. Then verify it with
curl https://yourdomain.com/llms.txt- you should see your text, not HTML. If your app returns its homepage for every URL (common with single-page apps), add a static file route so the raw text is served. A placeholder with just a heading earns no credit. - llms.txt formattingPassed
The llms.txt is well-formatted: 87 lines with markdown links, 6,737 characters in total.
Recommendation
Format your llms.txt as a navigation index: start with a markdown heading, include markdown links to deeper resources, and keep it under 30,000 characters. If you have more to say, move long-form content into /llms-full.txt or per-section files (e.g. /docs/llms.txt, /api/llms.txt) and link to them from the main index.
- Schema type breadthPassed
Rich schema vocabulary: Service, FAQPage, Review
Recommendation
Expand your JSON-LD beyond Organization/WebSite. Add FAQPage for common questions, Service or Product for offerings, AggregateRating or Review for social proof, and BreadcrumbList for navigation context.
- llms.txt links resolvePassed
All 5 probed llms.txt links resolve to real content
Recommendation
Make every link your llms.txt declares resolve to real content. Verify each one with
curl -L <url>- you should see the linked document, not your homepage. If your app returns the homepage shell for unknown paths (common with single-page apps), a 200 status is not proof: check the body. Fix or remove any dead link; agents that follow the index treat a broken link as a dead end. - Markdown frontmatter metadataPassed
Frontmatter with title + description and canonical on /
Recommendation
Open your served markdown docs with a --- frontmatter block carrying title plus at least one of description, canonical, or last-updated. Agents read frontmatter as document metadata without scraping. A Link: rel="canonical" response header also satisfies the canonical slot.
- Markdown agent docsPassed
Returns markdown when requested via Accept header
Recommendation
Pick one: (a) return Content-Type: text/markdown on GET when the request sends Accept: text/markdown, or (b) publish a static /llms.md, /auth.md, or /agents.md file at your root with real markdown content. Option (b) is usually a single static file. This is the cold-discovery path for agents that land at your homepage from web search without reading llms.txt first.
- WebMCP supportPassed
Declarative WebMCP API detected (1 form(s) with toolname + tooldescription attributes)
Recommendation
Expose in-page tools via WebMCP, the W3C draft standard for browser-resident AI agents. Add toolname and tooldescription attributes to your action forms - they survive into server-rendered HTML, so scanners and agents can see them - and register richer tools from client-side JS with document.modelContext.registerTool() (navigator.modelContext is the deprecated pre-Chrome-150 alias). Chrome ships WebMCP in 157 after the 149-156 origin trial.
- Accessible document structurePassed
Server HTML is a well-structured document (main=true, landmarks=4/4, h1=1, maxHeadingSkip=1).
- Native interactive controlsPassed
71 native controls, 0 non-native div-soup affordances (100% native).
- Accessible names on controlsPassed
70/71 interactive elements have a computable accessible name (99%).
- Accessibility-tree injection safety (bonus)Passed
No hidden instruction text detected in accessibility-tree attributes or off-screen content.
Inspect the underlying audit
The complete Ora audit uses evidence from the scan on . After applying changes, run another scan from the homepage to refresh these recommendations.
Sign me up for Vercel product updates and marketing emails.
Unsubscribe anytime. Privacy Notice
Source: Ora API
Snapshot 2026-08-23T09-22-10-297Z