llms.txt example: 3 complete files for docs, shops and blogs

# Site name

> One or two sentences that say what the site is and who it is for.

Optional notes that help an agent interpret the links below.

## Section name

- [Page title](https://www.example.com/page.md): What the page covers

## Optional

- [Secondary page](https://www.example.com/secondary.md): Safe to skip when context is short

# Northwind Metrics

> Northwind Metrics is a product analytics platform with a REST API and SDKs for JavaScript, Python and Go. This file lists the pages an agent needs to send events, query reports and manage API keys.

Notes for agents:

- The API base URL is https://api.example.com/v1 and every request needs a bearer token.
- The rate limit is 600 requests per minute per project. Retry with exponential backoff on HTTP 429.
- Event names are case-sensitive and limited to 64 characters.

## Getting started

- [Quickstart](https://docs.example.com/quickstart.md): Create a project, copy an API key and send a first event
- [Authentication](https://docs.example.com/authentication.md): API keys, scopes and key rotation
- [Core concepts](https://docs.example.com/concepts.md): Projects, events, properties and users

## API reference

- [Events API](https://docs.example.com/api/events.md): Send single and batched events, with the full JSON schema
- [Query API](https://docs.example.com/api/query.md): Run funnel, retention and trend queries
- [Errors and rate limits](https://docs.example.com/api/errors.md): Status codes, error bodies and retry guidance

## SDKs

- [JavaScript SDK](https://docs.example.com/sdks/javascript.md): Install, initialise and track in browsers and Node.js
- [Python SDK](https://docs.example.com/sdks/python.md): Install, async client and batching
- [Go SDK](https://docs.example.com/sdks/go.md): Client setup and context handling

## Optional

- [Changelog](https://docs.example.com/changelog.md): Release notes for the API and the SDKs
- [Migration guide from v0](https://docs.example.com/migrate-from-v0.md): Breaking changes and the upgrade checklist
- [Status page](https://status.example.com/): Current incidents and uptime history

# Fernwood Outdoor

> Fernwood Outdoor is an online shop for hiking and camping gear that ships from Leeds to the UK and Ireland. This file points to category pages, buying guides and the policies customers ask about most.

Key facts:

- Orders over £60 ship free in the UK, and standard delivery takes 2 to 4 working days.
- Unused items can be returned within 30 days.
- Prices are in GBP and include VAT.

## Shop by category

- [Tents](https://www.example.com/tents.md): Backpacking, family and ultralight tents with weight and season ratings
- [Sleeping bags](https://www.example.com/sleeping-bags.md): Down and synthetic bags, listed by comfort temperature
- [Rucksacks](https://www.example.com/rucksacks.md): Day packs and trekking packs, listed by capacity in litres
- [Footwear](https://www.example.com/footwear.md): Boots and trail shoes with width and waterproofing details

## Buying guides

- [How to choose a tent](https://www.example.com/guides/choose-a-tent.md): Season ratings, weight and packed size explained
- [Sleeping bag temperature ratings](https://www.example.com/guides/sleeping-bag-ratings.md): What comfort and limit ratings mean
- [Boot sizing guide](https://www.example.com/guides/boot-sizing.md): How to measure your foot and compare brands

## Policies

- [Delivery and shipping](https://www.example.com/policies/delivery.md): Costs, delivery times and countries served
- [Returns and refunds](https://www.example.com/policies/returns.md): Return window, condition rules and how refunds are paid
- [Warranty and repairs](https://www.example.com/policies/warranty.md): What is covered and how to make a claim

## Support

- [Contact us](https://www.example.com/contact.md): Email, phone hours and live chat
- [Order tracking](https://www.example.com/orders/tracking.md): How to track a parcel

## Optional

- [About Fernwood](https://www.example.com/about.md): The company, its stores and its sustainability commitments
- [Sitemap](https://www.example.com/sitemap.xml): Every product URL, for tools that need the full catalogue

# Ledgerline Engineering Blog

> Practical articles on payments infrastructure, written by the engineers at Ledgerline. Posts include working code and are updated when the underlying APIs change.

About this blog:

- New posts appear every Tuesday, and each post shows its publication and last updated dates.
- Code samples use TypeScript and Postgres unless a post says otherwise.
- Author pages list the role and expertise of each writer.

## Start here

- [Idempotency keys explained](https://blog.example.com/idempotency-keys.md): How to make payment retries safe, with a complete Node.js example
- [Designing a double-entry ledger](https://blog.example.com/double-entry-ledger.md): Schema, constraints and queries for a Postgres ledger
- [Webhook reliability checklist](https://blog.example.com/webhook-reliability.md): Signatures, retries and replay protection

## Topics

- [Payments](https://blog.example.com/topics/payments.md): All posts about charges, refunds and payouts
- [Databases](https://blog.example.com/topics/databases.md): Schema design, migrations and performance
- [Reliability](https://blog.example.com/topics/reliability.md): Incident reviews and resilience patterns

## About the authors

- [Authors](https://blog.example.com/authors.md): Who writes here and what they work on
- [Editorial policy](https://blog.example.com/editorial-policy.md): How posts are reviewed, corrected and updated

## Optional

- [Full archive](https://blog.example.com/archive.md): Every post, newest first
- [RSS feed](https://blog.example.com/feed.xml): Subscribe to new posts

grep "GET /llms.txt" access.log | awk -F'"' '{print $6}' | sort | uniq -c | sort -rn | head

import { readFile } from "node:fs/promises";

const location = process.argv[2];
if (!location) {
  console.error("Usage: node validateLlmsTxt.mjs <url-or-file>");
  process.exit(2);
}

async function loadText() {
  if (!/^https?:\/\//i.test(location)) return readFile(location, "utf8");
  const response = await fetch(location);
  if (!response.ok) throw new Error("HTTP " + response.status + " for " + location);
  return response.text();
}

async function readStatus(url) {
  try {
    const head = await fetch(url, { method: "HEAD" });
    return head.status === 405 || head.status === 403 ? (await fetch(url)).status : head.status;
  } catch (error) {
    return error instanceof Error ? error.message : String(error);
  }
}

const lines = (await loadText()).replace(/^\uFEFF/, "").split(/\r?\n/);
const problems = [];
const warnings = [];

const headings = lines.filter((line) => /^#\s+\S/.test(line));
if (headings.length !== 1) problems.push("Expected one H1, found " + headings.length + ".");
if (lines.find((line) => line.trim()) !== headings[0]) problems.push("The H1 must be the first line.");
if (!lines.slice(1).find((line) => line.trim())?.startsWith(">")) warnings.push("No blockquote summary after the H1.");

const entryPattern = /^\s*[-*]\s+\[([^\]]+)\]\((\S+?)\)(?::\s*(.+))?\s*$/;
const entries = lines.map((line) => entryPattern.exec(line)).filter(Boolean);
if (entries.length === 0) problems.push("No entries like - [name](url): notes found.");

const statuses = await Promise.all(entries.map(([, , url]) => (/^https?:\/\//i.test(url) ? readStatus(url) : "relative")));
entries.forEach(([, name, url, notes], index) => {
  if (statuses[index] !== 200) problems.push('Link "' + name + '" returned ' + statuses[index] + ": " + url);
  if (!notes) warnings.push('Link "' + name + '" has no notes.');
});

console.log(entries.length + " links, " + problems.length + " problem(s), " + warnings.length + " warning(s).");
problems.forEach((text) => console.log("PROBLEM " + text));
warnings.forEach((text) => console.log("WARNING " + text));
process.exitCode = problems.length > 0 ? 1 : 0;