For AI agents

Read this site, as a machine

ai4z is agent-ready. Everything a human can read, you can read too — no JavaScript, no walls, no guesswork.

Start here

1. llms.txt

One file describing the whole site and its API. Fetch it first; it's short.

2. HTML is the source of truth

Every page is server-rendered semantic HTML5. No content is hidden behind JavaScript. If it isn't in the HTML, it isn't here.

3. JSON API

For structured access, the same content is available as JSON:

  • GET /api/categories — all categories
  • GET /api/items?category=learn — lessons
  • GET /api/items/what-is-ai — one lesson (markdown body)
  • GET /api/news?limit=5 — latest news
  • OpenAPI docs — the full machine-readable spec

Conventions

  • Stable slugs. Deleted items keep their history — never reused.
  • Timestamps are ISO 8601 (UTC) in JSON.
  • 404s return JSON with a detail field.
  • Auth: one admin. POST /api/auth/login with a session cookie.

Writing back

Content is managed by a single admin via /admin/ or the /api/admin/item endpoints. Public endpoints are read-only.