{
    "id": 1095240,
    "title": "The shop as files: every tea in three forms, and a feed of what changed",
    "slug": "the-shop-as-files",
    "type": "page",
    "url": "https://teas.co.uk/ai/the-shop-as-files/",
    "modified": "2026-11-20T10:10:00+00:00",
    "excerpt": "Every tea page as a web page, plain text and data; the whole catalogue in a few downloads; and a feed of what changed today.",
    "content_text": "A web page is made for eyes. Software would rather have the facts straight. So every tea page on teas.co.uk also comes as plain text and as data. The whole catalogue comes as a few files. And there's a feed that says what changed today.\nAn AI with the right file gives the right price and stock, not last month's.\nEvery page in three forms\nAdd .md or .json to a tea, brand or story address and you get the same page as clean text or as data. For example, teas.co.uk/ai/model-context-protocol/.md is this kind of story as plain text.\nThe web page is for you.The text version is for anything that reads words.The data version is for anything that wants labelled facts: name, price, stock, barcode.\nAll three come from the same record, so they can't disagree.\nThe whole shop in a few downloads\nAn AI that wants everything doesn't need to visit hundreds of pages. It can download the catalogue in one go:\nproducts.json and products.jsonl: every product, one record each.llm-full.txt: the catalogue as one long text file.llm-wiki.txt and llm-recipes.txt: the Tea Wiki and the recipes the same way.\nThe shop's own rules ask heavy users to take these files instead of thousands of single requests. It's kinder to the shop and quicker for them.\nA feed of what changed\ncatalogue-changes.json lists what changed in the shop, newest first: a price change, a tea going out of stock, a tea coming back, or a product detail updated. An AI can check it and then fetch only what changed, instead of re-reading everything.\nIt has run since 6 October 2026, and by 20 November its change numbers had reached 2,043.\nA tea example. Tea India Ginger Chai changed its stock status at 09:54 on 20 November. That change appeared in the feed straight away. An assistant that checks the feed knows today's answer, not last week's.\nWhat files can't do\nA file is only as good as the record behind it. If a fact is wrong in the record, it's wrong in every file. That's why the facts themselves are checked, one by one, on the Truth Spine.\nIn my words\nI used to think of the website as the shop. Now I think of it as one window onto the shop. The shop itself is the records: what we sell, what it costs, whether it's in. Some customers look through the web page. Some look through a text file. Some look through a feed. As long as every window shows the same records, it doesn't matter which one they use. What matters is that none of them goes stale.\nCommon questions\nWhy give away the whole catalogue?\nBecause an AI that can read it can recommend it. Prices and stock aren't secrets: they're what we want people to know.\nAre the files free to use?\nYes, under our fair use and citation terms: name teas.co.uk and link the page.\nHow fresh are they?\nThe changes feed is updated as things change, and the bulk files are rebuilt whenever the catalogue changes.\nRead next: Single source of truth \u00b7 Everything in one answer \u00b7 Structured data",
    "contentSignals": "ai-train=yes, search=yes, ai-input=yes",
    "links": {
        "apiCatalog": "https://teas.co.uk/.well-known/api-catalog",
        "llmsTxt": "https://teas.co.uk/llms.txt",
        "mcp": "https://teas.co.uk/mcp",
        "mcpSetupGuides": "https://teas.co.uk/ai/",
        "mcpCard": "https://teas.co.uk/.well-known/mcp/server-card.json",
        "primaryAgenticRouteAuthority": "https://teas.co.uk/.well-known/teas-primary-agentic-route-authority.json"
    }
}