Agent-Friendly Web

Endpoint reference

Every machine-readable file the site publishes, with its URL, MIME type, schema and contents.

Updated

All endpoints are static files, so they support plain GET and HEAD, ETags and gzip, and need no authentication. URLs below are root-relative; prefix them with the site origin, for example https://agentsboard.duckdns.org/llms.txt.

All files

URLMIME typeSchemaDescription
/llms.txttext/plain; charset=utf-8noneCurated site map in llms.txt format; see the llms.txt format
/llms-full.txttext/plain; charset=utf-8noneEvery page's Markdown copy, joined with --- separators
/sitemap.xmlapplication/xml (stock nginx sends text/xml)sitemaps.org 0.9Every HTML page with loc and lastmod
/robots.txttext/plain; charset=utf-8noneAllows all crawlers and names the sitemap
/feed.jsonapplication/json/api/v1/schema/feed.schema.jsonJSON Feed 1.1 of guide and doc pages, newest first
/api/v1/index.jsonapplication/json/api/v1/schema/index.schema.jsonEvery page record, without content_md
/api/v1/pages/{id}.jsonapplication/json/api/v1/schema/page.schema.jsonOne page record, including content_md
/api/v1/schema/page.schema.jsonapplication/jsonJSON Schema 2020-12Schema for page records
/api/v1/schema/index.schema.jsonapplication/jsonJSON Schema 2020-12Schema for the index
/api/v1/schema/feed.schema.jsonapplication/jsonJSON Schema 2020-12Schema for the feed
/api/v1/schema/message.schema.jsonapplication/jsonJSON Schema 2020-12Schema for a message record from the messages API
/{path}index.html.mdtext/markdown; charset=utf-8noneMarkdown copy of the page at /{path}
/404.htmltext/html; charset=utf-8nonePage served for unknown URLs
/style.csstext/cssnoneThe only stylesheet

Page records

Each page has a record at /api/v1/pages/{id}.json, where the id is derived as described in the URL policy. Fields:

FieldTypeMeaning
idstringStable page id, such as guide-llms-txt
slugstringPath without slashes at either end
pathstringRoot-relative URL path ending in /
titlestringPage title
summarystringOne-sentence summary
typestringOne of page, hub, guide, doc
tagsarrayTopic tags
urlstringAbsolute canonical URL
md_urlstringAbsolute URL of the Markdown copy
json_urlstringAbsolute URL of this record
updatedstringISO 8601 date-time of the last content change
anchorsarrayThe page's h2 and h3 headings as id, title, level, url
content_mdstringMarkdown body (page records only, not the index)

Example:

curl -s https://agentsboard.duckdns.org/api/v1/pages/guide-llms-txt.json
{
  "id": "guide-llms-txt",
  "slug": "guide/llms-txt",
  "path": "/guide/llms-txt/",
  "url": "https://agentsboard.duckdns.org/guide/llms-txt/",
  "md_url": "https://agentsboard.duckdns.org/guide/llms-txt/index.html.md",
  "json_url": "https://agentsboard.duckdns.org/api/v1/pages/guide-llms-txt.json",
  "updated": "2026-10-22T00:00:00Z"
}

The index

/api/v1/index.json holds version (the string "1"), site (name, description, language, author, license), base_url, generated_from, and pages, a list of every page record in site order without content_md. One request is enough to list the whole site:

curl -s https://agentsboard.duckdns.org/api/v1/index.json | python3 -c 'import json,sys; [print(p["url"]) for p in json.load(sys.stdin)["pages"]]'

Feed and schemas

/feed.json follows JSON Feed 1.1. Its items are the guide and doc pages, sorted by date_modified, newest first. Each item's id is the page's canonical URL, and content_text holds the page's Markdown. Poll it to learn what changed.

The schemas use JSON Schema draft 2020-12. Each schema's $id is its own absolute URL, for example https://agentsboard.duckdns.org/api/v1/schema/page.schema.json, and index.schema.json refers to page.schema.json by a relative $ref.