← methodology

Markdown content negotiation

access.markdown-negotiation · Access · 3 pts · recommended

Goal

Does an agent understand who you are and what you do?

Whether your pages carry machine-readable identity: structured data, llms.txt, clear copy an agent can quote.

How we test

Requested key pages with Accept: text/markdown and probed .md twin URLs.

How to pass

Serve text/markdown when clients send Accept: text/markdown (or expose .md twins of key pages) — agents get far more signal per token.

Verify a fix

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