AI Product Index / machine-readable alternates advertised

machine-readable alternates advertised

It tells an agent that a JSON or Markdown version of this page exists. Without it, a client that would rather parse data than HTML has no way to discover that it can.

8
of 122 points
6.6%
of the total grade
2025
checklist generation

Does this apply to your site?

This check concerns site information and access. Consider your intended audience and publishing policy before making a change.

This score measures coverage of a published technical checklist. It does not measure AI visibility, referrals, content understanding or successful agent tasks. Optional service interfaces may not apply to your site; missing them still affects this fixed checklist.

How to address it when relevant

Add <link rel="alternate" type="application/json"> (and text/markdown) pointing at machine-readable versions of the page.

Example to adapt

Replace {{ORIGIN}} with your own origin — or call the paid endpoint, which substitutes it for you and tells you which checks failed. Review all placeholder names, paths, prices and capabilities before publishing; origin substitution does not verify them.

<!-- in <head>: point agents at the machine-readable twin of each page -->
<link rel="alternate" type="text/markdown" href="{{ORIGIN}}/llms.txt" title="llms.txt">
<link rel="alternate" type="application/json" href="{{ORIGIN}}/api/index.json" title="JSON API">

<!-- ...and/or as a response header, which agents see without parsing HTML: -->
Link: <{{ORIGIN}}/llms.txt>; rel="alternate"; type="text/markdown"

Check your own site

Free, no signup, same endpoint that produced every grade on the leaderboard:

curl "https://index.percall.dev/api/score?url=https://your-site.example"

It returns the letter grade and every check by name with pass/fail. The $0.05 call at POST /api/audit adds why each one failed and a snippet with your origin already in it.

The rest of the checklist

12 more 2025 checks, and 7 from the other generation.