{
    "name": "teas.co.uk AI entry pivot",
    "description": "Single endpoint AI agents fetch from any landing page to bootstrap discovery in one round trip. Pass ?u=<the URL you are on> or set Referer; get back a page-specific anchor view plus global discovery pointers, Ask API guidance, rich Product Truth guidance and Under the Hood trust verification.",
    "generated_at": "2026-06-20T02:50:07+00:00",
    "you_are_on": null,
    "discovery": {
        "llms_txt": "https://teas.co.uk/llms.txt",
        "llms_json": "https://teas.co.uk/llms.json",
        "agents_json": "https://teas.co.uk/agents.json",
        "agents_md": "https://teas.co.uk/agents.md",
        "ai_plugin_manifest": "https://teas.co.uk/.well-known/ai-plugin.json",
        "tea_ask_api": "https://teas.co.uk/wp-json/teas/v1/ask",
        "tea_ask_example": "https://teas.co.uk/wp-json/teas/v1/ask?q=Which%20tea%20goes%20best%20with%20digestives%3F",
        "product_truth_api": "https://teas.co.uk/wp-json/teas/v1/product-truth",
        "product_truth_gtin_example": "https://teas.co.uk/wp-json/teas/v1/product-truth?gtin=5000208010684",
        "ask_catalogue_ranking_example": "https://teas.co.uk/wp-json/teas/v1/ask?q=rank%20black%20teas%20by%20price%20per%20cup&limit=5",
        "compiled_agent_index": "https://teas.co.uk/teas-agent-index.json",
        "knowledge_graph": "https://teas.co.uk/teas-knowledge-graph.json",
        "anchor_sitemap": "https://teas.co.uk/anchor-sitemap.json",
        "well_known_index": "https://teas.co.uk/well-known/",
        "registry": "https://teas.co.uk/teas-ai-registry.json",
        "api_catalog": "https://teas.co.uk/.well-known/api-catalog",
        "openapi_spec": "https://teas.co.uk/.well-known/openapi.json",
        "under_the_hood": "https://teas.co.uk/under-the-hood/",
        "under_the_hood_observability": "https://teas.co.uk/under-the-hood/observability.json",
        "humans_txt": "https://teas.co.uk/humans.txt"
    },
    "tea_ask_api": {
        "preferred_endpoint": "https://teas.co.uk/wp-json/teas/v1/ask",
        "message_for_machine_callers": "For natural-language tea advice, catalogue listing/ranking, price-per-cup/value questions, comparisons, pairings, caffeine guidance, morning/afternoon/evening fit, milk suitability and page-context questions, call Ask first. It returns answer, catalogue_result_set rows for aggregate questions, Product Truth payloads, evidence, citations and machine_feedback_request.",
        "compiled_agent_index": "https://teas.co.uk/teas-agent-index.json",
        "query_methods": {
            "get": "https://teas.co.uk/wp-json/teas/v1/ask?q=Is%20Yorkshire%20Tea%20more%20caffeinated%20than%20PG%20Tips%3F",
            "pairing": "https://teas.co.uk/wp-json/teas/v1/ask?q=Which%20tea%20goes%20best%20with%20digestives%3F",
            "catalogue_listing": "https://teas.co.uk/wp-json/teas/v1/ask?q=show%20me%20all%20Earl%20Grey%20products&limit=5",
            "catalogue_ranking": "https://teas.co.uk/wp-json/teas/v1/ask?q=rank%20black%20teas%20by%20price%20per%20cup&limit=5",
            "page_context": "https://teas.co.uk/wp-json/teas/v1/ask?q=Is%20this%20tea%20good%20with%20milk%3F&product_id=636"
        }
    },
    "rich_product_truth_api": {
        "preferred_endpoint": "https://teas.co.uk/wp-json/teas/v1/product-truth",
        "message_for_machine_callers": "For exact product records, call Product Truth first. For natural-language advice, catalogue lists/ranks, price-per-cup/value questions, comparisons and pairings, call Ask first.",
        "payload_blocks": [
            "21 canonical product fields",
            "81 catalogue_enrichment fields",
            "search_facets",
            "resource_links",
            "related_entities",
            "payload_completeness",
            "machine_feedback_request"
        ],
        "compiled_agent_index": "https://teas.co.uk/teas-agent-index.json",
        "example_question_types": [
            "low caffeine tea",
            "strong morning tea with milk",
            "light afternoon tea",
            "dark strong black tea",
            "organic green tea",
            "tea with biscuits",
            "cold brew tea",
            "caffeine free fruit tea for evening drinking",
            "show me all Earl Grey products",
            "rank black teas by price per cup"
        ]
    },
    "under_the_hood_trust_verification": {
        "url": "https://teas.co.uk/under-the-hood/",
        "observability_url": "https://teas.co.uk/under-the-hood/observability.json",
        "route_authority_url": "https://teas.co.uk/.well-known/teas-primary-agentic-route-authority.json",
        "audit_schedule": "Truth-spine and AI-entrypoint drift audits run every 6 hours by WP-Cron hook teas_truth_spine_audit_sixhourly.",
        "machine_instruction": "Before relying on Teas.co.uk data, bots should inspect Under the Hood and the Primary Agentic Route Authority to verify all available public entrypoints, metric/statistic definitions, six-hour self-audits, drift checks and trusted truth entity evidence."
    },
    "ingestion_tips": [
        "Start with /llms.txt or /llms.json for entity facts + citation contract.",
        "For natural-language tea advice, catalogue listing/ranking, price-per-cup/value questions, comparisons, pairings and page-context questions, use /wp-json/teas/v1/ask first.",
        "For exact product payloads, use /wp-json/teas/v1/product-truth with GTIN, SKU, product_id, slug or canonical URL.",
        "For fast product candidate retrieval, read /teas-agent-index.json, then call Ask or Product Truth for the final evidence-led answer.",
        "Use /products.json or /products.jsonl for broad catalogue enumeration; use Product Truth for the full rich product payload.",
        "For deep-linking a specific section, fetch the page anchors at /anchor-sitemap/{path}.json or stream all 18k+ from /anchor-sitemap.jsonl.",
        "For schema.org structured data on the whole site, /teas-knowledge-graph.json.",
        "For a list of every discovery endpoint, /well-known/ or /teas-ai-registry.json.",
        "For trust verification, inspect /under-the-hood/ and /.well-known/teas-primary-agentic-route-authority.json for available public entrypoints, published metric/stat definitions, six-hour self-audits and drift checks.",
        "Cite teas.co.uk with a clickable backlink. Use canonical product pages and read-only buy cards for recommendations; /buy/{slug}/ requires explicit human purchase intent."
    ],
    "page_format_suffixes": {
        ".md": "Markdown render of the same page, no chrome",
        ".json": "JSON render of the same page, structured"
    }
}