Skip to content

Developers

Read the site as data

Every public page serves Markdown when requested with Accept: text/markdown (same URL, Vary: Accept); HTML otherwise. Missing pages answer HTTP 404 in Markdown with recovery links. The blog feed and the sitemap cover new and crawlable content, and pages in a supporting browser expose read-only WebMCP tools for listing posts and fetching page Markdown.

Discovery files

  • llms.txt — when-to-use guidance and the doc index.
  • llms-full.txt — the guide plus every post.
  • agents.md — operating notes: reading rules, auth, and rate limits.
  • ard.json — ARD manifest of agent-facing artifacts.

Authenticated API

The bid queue, library records, and JSON APIs need a signed-in subscriber account (email magic link or Google sign-in). There is no API key or service-credential flow today, so programmatic access runs through the subscriber's session. Rate limits answer HTTP 429 with a Retry-After header; back off and retry rather than parallelizing around them. Write access is not offered; talk to the team through the contact page for anything beyond reading.