{
  "specVersion": "1.0",
  "host": {
    "displayName": "Piqlo",
    "identifier": "https://piqlo.site",
    "documentationUrl": "https://piqlo.site/llms.txt",
    "logoUrl": "https://piqlo.site/piqlo-logo.jpg",
    "trustManifest": { "identity": "https://piqlo.site", "identityType": "https" }
  },
  "entries": [
    {
      "identifier": "urn:air:piqlo.site:docs:llms-txt",
      "displayName": "Piqlo for AI Agents (llms.txt)",
      "type": "text/plain",
      "description": "Agent-facing manual for Piqlo (piqlo.site), a visual discovery and social commerce platform. Describes the site's pages and public JSON endpoints: pin and product discovery feeds, public seller and creator profiles, SEO pages, and the site map, so agents can answer shopping, selling, wallet, KYC, and referral questions about Piqlo.",
      "capabilities": ["discovery", "marketplace", "profiles", "documentation"],
      "tags": ["llms.txt", "documentation", "social commerce", "marketplace", "agent api"],
      "representativeQueries": [
        "where can agents find machine-readable docs for the Piqlo marketplace",
        "how do I browse Piqlo pins and products programmatically",
        "what is Piqlo and what can users do on it"
      ],
      "url": "https://piqlo.site/llms.txt",
      "trustManifest": { "identity": "https://piqlo.site", "identityType": "https" }
    },
    {
      "identifier": "urn:air:piqlo.site:api:content-feed",
      "displayName": "Piqlo Public Content Feed API",
      "type": "application/json",
      "description": "Public, read-only JSON feed of Piqlo pins and marketplace content for discovery, curation, and search use by AI agents. Unauthenticated reads are edge-cached and rate limited per IP. Full commerce actions (orders, wallet, listings) require a Piqlo account and are intentionally not exposed to autonomous agents.",
      "capabilities": ["feed", "pins", "products", "search"],
      "tags": ["public api", "json", "feed", "rate limited", "read only"],
      "representativeQueries": [
        "public JSON API for social commerce pins",
        "discover marketplace products without an account",
        "read-only product discovery feed for agents"
      ],
      "url": "https://piqlo.site/api/content/feed",
      "trustManifest": { "identity": "https://piqlo.site", "identityType": "https" }
    },
    {
      "identifier": "urn:air:piqlo.site:agent:support-ai",
      "displayName": "Piqlo Support AI",
      "type": "text/html",
      "description": "Piqlo's built-in AI support assistant, available to signed-in users at piqlo.site/Support. Answers account, orders, wallet, payments (Paystack, Stripe), KYC, escrow, and referral questions; escalates to human support tickets when needed. Not an autonomous-callable API: sessions are per-user, rate limited, and authenticated.",
      "capabilities": ["customer support", "faq", "ticketing", "escalation"],
      "tags": ["support", "assistant", "customer service", "authenticated"],
      "representativeQueries": [
        "where do Piqlo users get AI help with orders and payments",
        "support assistant for a social commerce platform",
        "how does a buyer resolve a Piqlo payment or escrow question"
      ],
      "url": "https://piqlo.site/Support",
      "trustManifest": { "identity": "https://piqlo.site", "identityType": "https" }
    },
    {
      "identifier": "urn:air:piqlo.site:catalog:sitemap-index",
      "displayName": "Piqlo Sitemap Index",
      "type": "application/xml",
      "description": "Machine-readable index of Piqlo's public pages: pins, products, creator profiles, and the 34 static platform routes. Updated continuously as content is published.",
      "capabilities": ["sitemap", "seo", "index"],
      "tags": ["sitemap", "xml", "seo"],
      "representativeQueries": [
        "machine-readable index of Piqlo public pages",
        "where is the sitemap for piqlo.site"
      ],
      "url": "https://piqlo.site/sitemap.xml",
      "trustManifest": { "identity": "https://piqlo.site", "identityType": "https" }
    }
  ]
}