← Все доки

How the visibility score works

The geodeck visibility score is a 0 to 100 number that summarises how readable your site is for AI answer engines like ChatGPT, Perplexity, Gemini, and Claude. It is the average of five 20-point buckets that each measure one well-known ranking factor: bot access, page schema, answer clarity, recent updates, and site basics. Since 2024 we have run this same scoring on more than 95% of pages we mirror, and the methodology is updated for 2026 to weight the FAQ-style heading patterns that LLM retrieval favours.

What goes into the 100 points?

Each bucket contributes up to 20 points. We measure them on a fresh recompute and store the breakdown so you can see which lever to pull next.

  • Bot access (20 pts)— can ChatGPT, Perplexity, Gemini, Claude, and Bingbot read your site? We parse /robots.txt and check each major AI user agent.
  • Page schema (20 pts)— the average JSON-LD quality across your tracked URLs. Pages with Article, FAQPage, orProduct structured data score highest.
  • Answer clarity (20 pts)— the AEO score (see below).
  • Recent updates (20 pts)— how many distinct URLs were updated in the last 30 days. 10 or more updates earns the full 20 points.
  • Site basics (20 pts)— the average of three sub-scores: llms.txt completeness, SEO sanity (titles, descriptions, canonicals), and link graph health (orphans, broken links).

How is answer clarity (AEO) calculated?

Answer-engine optimisation looks at the Markdown body of each tracked URL and adds points for eight signals that LLMs are known to lift snippets from. The maximum per page is 98 in 2026:

  • Question-style headings— an H2 or H3 ending in “?” or starting with What/How/Why/When (+18). Three or more question headings earns a +4 FAQ-density bonus.
  • Definition-style opening— a 30-120 word lead paragraph that defines what the page is about (+14).
  • Lists or structured items (+10).
  • Short, scannable paragraphs— median paragraph ≤ 90 words (+10).
  • Sensible heading hierarchy— never skip a level (+10).
  • Authority markers— citations, statistics like “30%”, or year references like “2026” (+12).
  • Conversational tone— at least two uses of “you” (+6).
  • Sweet-spot length— between 300 and 3,000 words (+14).

How is freshness measured?

We count the distinct URLs whose updated_at timestamp falls within the last 30 days. 10 or more earns the full 20 points, 3 to 9 earns 12 points, and 1 to 2 earns 6 points. Every webhook publish or update event refreshes the timestamp, so a steady drumbeat of CMS publishes is the easiest way to keep this bucket maxed.

How do I push my score from 90 to 100?

The score plateaus around 90 once bot access and schema are clean. The remaining points usually come from answer clarity and freshness:

  1. Open the Audits tab and click Recompute.
  2. Sort URLs by AEO score ascending and pick the lowest five.
  3. Add a question heading and a 30-120 word definition lead.
  4. Re-submit those URLs from the Index tab with event=update.
  5. Recompute again after roughly 90 seconds.

Keep reading the rest of the Geodeck documentation, or jump to the platform pages.

Platform