← methodology

Semantic HTML structure

access.semantic-html · Access · 3 pts · required

Goal

Can an agent operate your website directly?

Whether the site itself is legible to non-rendering and browser agents: semantic HTML, no JS walls, accessibility.

How we test

Scored landmark elements, heading hierarchy, and text-to-markup ratio on the homepage.

How to pass

Use landmark elements (main/nav/header/footer) and a clean heading hierarchy; agents parse structure, not pixels.

Verify a fix

curl -X POST /api/scan/checks \
  -H 'content-type: application/json' \
  -d '{"url": "yourdomain.com", "checkIds": ["access.semantic-html"]}'