llms.txt — AI Discovery Files

2026-05-27 · Engineering · architecture

What

Two files at the site root that help AI models (ChatGPT, Claude, Perplexity, Google AI) understand VPN.com's content and cite it correctly.

Files

FileLocationMaintainedGenerated
llms.txtpublic/llms.txtManualNo — hand-written
llms-full.txtpublic/llms-full.txtAutoYes — scripts/generate-llms-full.mjs at build step 2c

llms.txt structure

  1. Header — one-line description of VPN.com (VPN research + domain brokerage)
  2. Domain Brokerage — highest revenue, listed first
  3. VPN Rankings & Reviews — top providers with Trust Scores
  4. Provider Data API — JSON endpoints for machine consumption
  5. Methodology — how we test and score
  6. Comparison Guides — best-for pages
  7. Cybersecurity — security guides
  8. Educational — explainers
  9. Contact — email, phone, press

llms-full.txt generation

Script: scripts/generate-llms-full.mjs

Build step 2c in scripts/build.sh.

When to update

ChangeAction
New English page addedAuto — llms-full.txt regenerates on build
Provider data changesAuto — API endpoints serve fresh data
New section/category addedManual — update llms.txt sections
Domain broker offering changesManual — update llms.txt Domain Brokerage section
Trust Score methodology changesManual — update llms.txt Methodology section
Provider removed/addedAuto for llms-full.txt. Manual for llms.txt if top-7 provider changes.

Key decisions

Done

Todo