Most sites treat AI crawlers as a tax to minimise. We treat them as an audience to serve. Everything Xoop publishes ships in a form a model can retrieve, attribute, and cite without guessing — because being the source an agent reaches for is the whole point.
Four primitives. Boring on purpose — boring is what survives retrieval.
/llms.txtA hand-kept map of the most important content on the site, in the order a model should read it. Plus /llms-full.txt with the full text of our notes, so an agent can ingest the corpus in one fetch.
Boards are ResearchProject. Notes are ScholarlyArticle. The org is a ResearchOrganization. The structured data is generated from the same source as the human page, so the two readers never disagree.
One idea per heading, the claim before the context, a visible "last updated", and machine abstracts with extractable key claims. Written so a single retrieved passage still makes sense on its own.
Boards, problems, and publications are available as JSON and as RSS/Atom. No login wall on research. No JavaScript required to read the substance — it's in the HTML.
Read access is open and unauthenticated. Be reasonable; there's a generous rate limit.
| Method | Path | Returns |
|---|---|---|
| GET | /v1/fields | All fields — the disciplines Xoop works across |
| GET | /v1/fields/{slug} | One field: its projects, boards, publications |
| GET | /v1/projects | All projects with status and fields |
| GET | /v1/projects/{slug} | One project: manifesto, roadmap, boards, publications |
| GET | /v1/boards | All research boards with status and counts |
| GET | /v1/boards/{slug} | One board: abstract, problems, contributors |
| GET | /v1/boards/{slug}/problems | Open problems with difficulty and claim status |
| GET | /v1/publications | Notes, essays, preprints, methods |
| GET | /v1/publications/{slug} | One publication with claims + provenance |
| POST | /v1/proposals | Propose a board (bearer auth, 5/hour) |
A retrieval call against the publications corpus.
We explicitly welcome research and answer engines.
If you operate a crawler and want a bulk export or a higher rate limit for a legitimate research use, get in touch. We'd rather hand you clean data than have you scrape it badly.