CanAgentUse tools

UCP Suite

Validate Universal Commerce Protocol discovery, then test product search, carts, checkout links, and merchant handoff flows.

MCP Playground

Connect to remote MCP servers, inspect tools and resources, test prompts, auth, headers, notifications, and JSON-RPC responses.

A2A Playground

Inspect Agent Cards, validate advertised endpoints, and prepare safe requests for agent-to-agent workflows.

Agent Website Viewer

Enter a public URL and see the roles, names, landmarks, controls, and blockers that shape how AI agents understand the page.

Back to blog
website auditsite-wide auditAI agent readinesssitemap

Why homepage scores lie in site-wide website audits

A homepage is 1 URL. Learn a repeatable site-wide website audit method using route families, representative sampling, prevalence, and regression checks.

By · · 12 min read

Share

Copy article as Markdown
A healthy homepage sits in front of varied site routes with warnings, blocked pages, and a site-wide audit report.
A healthy homepage sits in front of varied site routes with warnings, blocked pages, and a site-wide audit report.

A homepage is usually the most polished page on a website. It has the broadest internal support, the closest executive attention, and the simplest public path. That makes it a useful page to scan and a terrible page to use as a proxy for everything else.

The routes that carry real business risk live elsewhere: product detail pages, documentation, search results, account screens, forms, checkout, support, campaign templates, and JavaScript-heavy application views. They may use different layouts, data sources, deployment teams, authentication rules, and edge behavior.

A homepage-only audit can therefore produce a reassuring score while the conversion path is broken. The fix is not necessarily to scan every URL. Large sites contain duplicate templates, parameter combinations, faceted navigation, archives, and low-value pages. The better method is to discover the site, group structurally similar routes, choose a representative set, separate site-level checks from page-level checks, and report issue prevalence. A focused AI crawler audit can then investigate transport failures in depth.

Key takeaways

  • A homepage is 1 URL, not a statistical sample of a heterogeneous website.
  • Sitemap files may contain up to 50,000 URLs, so exhaustive scanning is rarely the right default.
  • Group routes by template and task, sample deterministically, then report failures by scope, severity, and prevalence.

Why can a homepage score hide serious failures?

Google's sitemap guidance allows a single sitemap file to contain up to 50,000 URLs or 50 MB uncompressed. A scan of 1 homepage covers 0.002% of that maximum URL count. Even on a smaller site, the coverage claim is usually weaker than the score implies.

Quantity is only part of the problem. The routes are structurally different. A marketing homepage may be server-rendered, public, fast, and rich with schema. The application can be client-rendered behind authentication. The docs may come from another platform. Product pages may depend on inventory APIs. Checkout may use a third-party frame. Support may live on a subdomain.

These pages fail in different ways:

RouteLikely audit risks
HomepageCanonical, organization schema, crawler policy, main navigation
Product detailProduct data, availability, variant state, price consistency
Search and filtersURL state, empty results, selected filters, pagination
DocumentationStale versions, code rendering, API discovery, deep-link crawlability
SignupLabels, validation, bot challenge, account confirmation
CheckoutFocus, authorization, final consent, duplicate submission, receipt
DashboardRendered content, canvas-only data, session state, exports
SupportForm recovery, ticket confirmation, status lookup

A strong homepage tells you that the homepage is strong. Nothing more should be inferred without evidence.

How should a site-wide website audit discover pages?

The Sitemap protocol defines XML files containing URL locations and optional metadata such as lastmod. Search engines also accept sitemap indexes that point to multiple sitemap files. Discovery should begin with declared sources, then add controlled crawl and manual task routes where sitemaps are incomplete.

A practical discovery order is:

  1. Resolve the canonical origin and inspect robots.txt for sitemap declarations.
  2. Probe conventional locations such as /sitemap.xml and sitemap indexes.
  3. Parse nested indexes with strict limits for depth, size, redirects, and origin.
  4. Normalize URLs without collapsing meaningful queries or route state.
  5. Add high-value pages missing from sitemaps, including authenticated task entries.
  6. Record where every candidate came from and when it was last modified.

CanAgentUse's website-audit implementation checks four conventional paths on the resolved origin: /sitemap.xml, /sitemap_index.xml, /sitemap-index.xml, and /sitemap.txt. The point is not that four paths are universally complete. It is that discovery should be explicit, testable, and repeatable.

Sitemaps are hints, not a full inventory. They often exclude account routes, filtered states, preview deployments, or pages that should not be indexed. Conversely, they may list thousands of near-duplicate archives. Discovery and selection need separate stages.

A sitemap can enumerate up to 50,000 URLs, according to Google Search Central. A site-wide audit should use that inventory to understand route coverage, not blindly scan every entry. The sample must represent different templates, tasks, states, and risk levels.

What is a representative page set?

A representative page set contains enough examples of each meaningful route family and user journey to expose template-specific failures. It is not a random handful of URLs and it is not the first N entries in a sitemap.

Start by deriving a pattern key. /products/red-bag and /products/blue-case probably belong to /products/{slug}. /docs/v2/auth and /docs/v2/search may belong to /docs/{version}/{slug}. Query parameter names can define another family when they change page behavior, such as /search?brand&price&page.

Then add business context. Two routes can share a template but carry different risk. A free account settings page and a payment-method page may use the same shell, yet the second deserves explicit coverage.

CanAgentUse's deterministic selection reserves the homepage, groups candidates by sitemap source and structural pattern, gives broad route families at least one slot where possible, then allocates remaining slots with diminishing returns. Within a family it favors shallower, recently modified pages before a stable hash breaks ties. Reversing the discovery order produces the same sample.

Determinism matters. If every audit chooses a different random product page, a changed score may reflect the sample rather than the site. A stable sample makes regression evidence comparable.

A practical selection matrix

Selection dimensionWhat to includeWhy
Route familyAt least one page per major templateFinds shared rendering and metadata defects
Business taskEntry and completion pages for valuable journeysProtects conversion and support outcomes
Rendering modeStatic, server-rendered, client-rendered, embeddedExposes different observation failures
Access statePublic, signed-in, role-restrictedTests policy and permission boundaries
FreshnessRecently changed and stable long-lived pagesFinds regressions without ignoring baseline content
Edge caseEmpty, error, unavailable, validation failureTests recovery instead of only happy paths

Do not claim statistical confidence unless the sampling design supports it. "Representative" here is an engineering coverage term. It means the sample spans known variation and risk.

Which checks are site-level and which are page-level?

Scope determines how often a check should run and how a failure should be reported. Re-fetching the same origin-level resource for every page wastes time and can inflate one defect into hundreds of identical findings. Assuming every page inherits the homepage's quality hides template defects.

Typical site-level checks include:

  • robots.txt policy and sitemap declarations
  • well-known discovery documents
  • API catalogs, OpenAPI entry points, and MCP server metadata
  • top-level security and crawler policy
  • organization identity and global editorial ownership

Typical page-level checks include:

  • title, canonical, headings, and page-specific structured data
  • rendered semantic HTML and accessibility tree quality
  • forms, filters, dialogs, and confirmation state
  • page performance and layout stability
  • content freshness, sources, and internal links

Some checks are mixed. Security headers may vary by route or CDN behavior. Canonical policy is global, but the actual canonical must be inspected on each template. A sitemap is site-level evidence, while inclusion of a particular page is a page-level fact.

The report should preserve that distinction. A site-level issue appears once with shared evidence. A page-level issue carries affected URLs and prevalence across the selected set.

How should issue prevalence be calculated?

Prevalence is the share of successfully evaluated sampled pages affected by a page-level finding. If 7 of 20 scanned pages have unlabeled form controls, prevalence is 35%. That number is more useful than twenty duplicate cards, but it still needs context.

Three details prevent misleading prevalence:

  1. Keep failed scans out of the denominator until their status is explicit. A timeout is not a passing page.
  2. Report the sample size with the percentage. "50%" can mean 1 of 2 or 500 of 1,000.
  3. Pair prevalence with severity and route value. A duplicate title on 80% of archive pages may matter less than a broken confirmation on 1 checkout page.

The aggregation model can be expressed simply:

Textprevalence(check) = affected evaluated pages / evaluated pages
risk(check) = severity x prevalence x route importance

The second formula is a prioritization model, not a universal standard. Its value is forcing a discussion about impact. A low-prevalence defect on a high-value path should not vanish below a widespread cosmetic warning.

CanAgentUse stores affected reports for each finding, separates site-wide issues from page prevalence, and retains example URLs so a developer can reproduce the failure. That last part matters. Percentages without evidence are hard to fix.

Why is scanning every URL often the wrong answer?

The Sitemap protocol's 50,000-URL allowance shows how quickly exhaustive scanning can grow. Faceted ecommerce and programmatic sites can produce far more URLs through sitemap indexes. Scanning all of them consumes crawl budget, audit capacity, and application resources while repeating the same template defect thousands of times.

Exhaustive coverage is appropriate in narrow cases: a small site, a migration requiring a status and canonical check on every URL, or a compliance process with explicit inventory requirements. A deep browser and accessibility run is different. It is slower, stateful, and more expensive.

Use a layered plan:

LayerCoverageChecks
Inventory passAll discovered URLs where safeURL validity, status, redirect, canonical hint, sitemap membership
Template sampleRepresentative pages per route familyRendered HTML, schema, accessibility, performance
Task pathsEvery high-value journeyInteraction, permissions, validation, confirmation
Incident expansionAll pages in a failing familyFocused verification of the suspected shared defect

This pattern spends depth where it buys evidence. When a sampled product page fails Product schema, expand within that family. When all sampled pages share a global header issue, fix the component before scanning another thousand pages.

How do scheduled audits detect regressions?

A baseline is useful only when later runs are comparable. Keep the selected page set, check configuration, crawler identity, device profile, and major timing rules stable. When the site adds a new route family, update the set deliberately and annotate the baseline change.

CanAgentUse's monthly automation uses a saved page selection and one normalized check configuration for manual and scheduled runs. Its scheduler preserves the chosen local time across daylight-saving changes and clamps a request for day 31 to the final day in shorter months. Those details sound mundane until a monitoring system silently drifts.

Regression reporting should distinguish four events:

  • a previously passing check now fails on the same page
  • an issue spreads to more pages in the sample
  • a selected page cannot be evaluated
  • the inventory changes through added, removed, or redirected routes

Do not bury failed pages in a score. A page that timed out, hit a challenge, or required a missing credential needs its own status and retry path. CanAgentUse tracks completed and failed pages separately, then calculates progress from both terminal states.

The alert should lead with changed evidence, not the new score. "Checkout confirmation disappeared on 2 of 2 tested checkout routes" is actionable. "Readiness fell from 86 to 82" is a clue. The GEO vs SEO guide explains how those technical signals fit beside content and visibility work.

A site-wide audit workflow engineers can trust

Run the audit as a pipeline with inspectable artifacts:

  1. Define the origin, allowed subdomains, credentials, and crawl limits.
  2. Discover sitemap and manual task candidates.
  3. Normalize exact page identity, including meaningful query names and fragments.
  4. Group pages by structural family and business task.
  5. Save a deterministic representative selection.
  6. Run site-level checks once and page-level checks per selected route.
  7. Track completed, failed, skipped, and retried pages separately.
  8. Aggregate page findings by prevalence without losing example evidence.
  9. Prioritize with severity, route importance, and the first blocking task stage.
  10. Save the baseline and rerun it after deployments or on a schedule.

This process is intentionally less dramatic than a single score. It produces something better: a report that says what was covered, what failed, how often it failed, and where an engineer can reproduce it.

Frequently asked questions

How many pages should a website audit scan?

There is no universal number. Google permits 50,000 URLs in one sitemap file, but deep scanning all of them is rarely efficient. Begin with every major route family and high-value task, then add samples where a family has more variation or risk.

Is a homepage scan useless?

No. It is the first route in CanAgentUse's deterministic sample and is useful for global navigation, organization signals, and public crawler behavior. It becomes misleading only when a 1-page result is presented as evidence for the entire site.

What is issue prevalence?

Issue prevalence is affected evaluated pages divided by evaluated sampled pages. A finding on 7 of 20 pages has 35% prevalence. Always report the numerator, denominator, severity, and affected route family beside the percentage.

Should failed pages count as passing pages?

No. A timeout, challenge, or missing credential is not a pass. Keep failed pages in a separate terminal state, retry when appropriate, and explain whether the failure itself indicates an access or reliability problem.

How often should a site-wide audit run?

Run it after major template, edge, schema, authentication, or design-system changes. Monthly scheduled audits provide a stable general baseline. High-risk checkout, signup, and support paths may deserve a focused check on every deployment.

Stop asking one page to speak for the whole site

Homepage scores lie by implication, not necessarily by calculation. The homepage result may be perfectly accurate. The mistake is extending it to routes that were never observed.

A credible site-wide website audit makes its coverage visible. It knows which pages share a template, which routes carry business risk, which checks belong to the origin, which need a real browser, and which failures are spreading. It also preserves the awkward evidence: failed pages, inconsistent edge behavior, and broken task outcomes.

Run a [CanAgentUse website scan](/) for an initial view, then use the representative method for the routes that actually run the business.

Research and implementation sources

Share

Copy article as Markdown