{
  "name": "REFLUX Official Merch Store",
  "version": "2.0.0",
  "updated": "2026-02-21",
  "canonical": "https://platphormnews.com",
  "etsy": "https://www.etsy.com/shop/REFLUXStore",
  "mcp_hub": "https://mcp.platphormnews.com",
  "coinbase": "0x30589F2e1B8E9a48BBb2c66Ac012FE7ED2A7eB85",
  "locales": ["en", "es", "fr", "de", "ja"],
  "default_locale": "en",
  "entry_points": {
    "api": {
      "/api/catalog": { "method": "GET", "description": "List all products with optional query, category, and sort params" },
      "/api/catalog/{slug}": { "method": "GET", "description": "Get product details by slug" },
      "/api/search": { "method": "GET", "description": "Full-text search: ?query=keyword" },
      "/api/mcp": { "method": "POST", "description": "JSON-RPC 2.0 MCP endpoint. GET returns server card." },
      "/api/health": { "method": "GET", "description": "Service health and catalog stats" },
      "/api/etsy/sync": { "method": "GET", "description": "Preview Etsy listing sync (requires ETSY_API_KEY)" },
      "/api/spotify/token": { "method": "GET", "description": "Spotify playback token status" },
      "/api/spotify/authorize": { "method": "GET", "description": "Initiate Spotify PKCE OAuth flow" }
    },
    "pages": {
      "/{lang}": { "description": "Landing page with hero, featured merch, album, and band story" },
      "/{lang}/shop": { "description": "Full product catalog with category filters and search" },
      "/{lang}/shop/{slug}": { "description": "Product detail page with pricing and Buy on Etsy link" },
      "/{lang}/music": { "description": "Album page with Spotify Web Playback SDK and tracklist" },
      "/{lang}/story": { "description": "Band history timeline" },
      "/{lang}/docs": { "description": "Developer documentation" }
    },
    "discovery": {
      "/llms.txt": { "description": "LLM entry points (summary)" },
      "/llms-full.txt": { "description": "Extended index with full product catalog" },
      "/llms-index.json": { "description": "Machine-parseable JSON index (this file)" },
      "/sitemap.xml": { "description": "XML sitemap with hreflang alternates" },
      "/rss.xml": { "description": "RSS feed of products" },
      "/robots.txt": { "description": "Crawler directives" },
      "/manifest.webmanifest": { "description": "PWA manifest" },
      "/.well-known/mcp.json": { "description": "MCP well-known endpoint" },
      "/.well-known/mcp/server-card.json": { "description": "MCP Server Card v1.0" }
    }
  },
  "mcp": {
    "endpoint": "/api/mcp",
    "protocol_version": "2024-11-05",
    "transport": "http",
    "method": "POST",
    "content_type": "application/json",
    "server_card": "/.well-known/mcp/server-card.json",
    "tools": [
      { "name": "catalog_list", "description": "List all products in the catalog" },
      { "name": "catalog_get", "description": "Get product by slug", "params": ["slug"] },
      { "name": "catalog_search", "description": "Search products by keyword", "params": ["query"] },
      { "name": "catalog_categories", "description": "List all categories with counts" },
      { "name": "catalog_by_category", "description": "Get products in a category", "params": ["category"] },
      { "name": "band_info", "description": "Get band biography, discography, and member info" }
    ],
    "jsonrpc_example": {
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/call",
      "params": { "name": "catalog_search", "arguments": { "query": "skull hoodie" } }
    }
  },
  "spotify": {
    "integration": "Web Playback SDK with PKCE OAuth",
    "authorize_endpoint": "/api/spotify/authorize",
    "token_endpoint": "/api/spotify/token",
    "callback_endpoint": "/api/spotify/callback",
    "fallback": "Spotify iframe embed when not configured"
  },
  "etsy": {
    "store_url": "https://www.etsy.com/shop/REFLUXStore",
    "sync_endpoint": "/api/etsy/sync",
    "configured": false,
    "note": "Set ETSY_API_KEY to enable live product sync with images and individual listing URLs"
  },
  "json_ld_schemas": [
    "Organization",
    "MusicGroup",
    "MusicAlbum",
    "MusicRecording",
    "Product",
    "WebSite",
    "FAQPage",
    "BreadcrumbList",
    "ItemList",
    "SiteNavigationElement",
    "OfferCatalog"
  ],
  "categories": ["T-Shirts", "Hoodies", "Hats", "Posters", "Accessories", "Stickers", "Footwear", "Outerwear"],
  "products": {
    "reflux-camo-skull-crest-jacket": { "title": "REFLUX - Camo Skull Crest Jacket", "price": 99.00, "currency": "USD", "category": "Outerwear" },
    "reflux-black-tie-dye-hoodie-with-floral-script-embroidery-champion-style": { "title": "REFLUX - Black Tie-Dye Hoodie w/ Floral Embroidery", "price": 98.00, "currency": "USD", "category": "Hoodies" },
    "reflux-skull-floral-embroidery-hoodie-tie-dye-pullover": { "title": "REFLUX - Skull Floral Embroidery Hoodie", "price": 80.00, "currency": "USD", "category": "Hoodies" },
    "reflux-black-marble-tie-dye-hoodie-embroidered-logo-hoodie": { "title": "REFLUX Black Marble Tie-Dye Hoodie", "price": 79.99, "currency": "USD", "category": "Hoodies" },
    "reflux-abstract-graffiti-spiral-sneakers-by-mila-womens-low-top-sneakers": { "title": "REFLUX Graffiti Spiral Sneakers by MILA", "price": 55.99, "currency": "USD", "category": "Footwear" },
    "reflux-skull-crest-logo-zip-hoodie-w-roses-full-zip-hooded-sweatshirt": { "title": "REFLUX - Skull Crest Zip Hoodie w/ Roses", "price": 55.00, "currency": "USD", "category": "Hoodies" },
    "reflux-skull-cluster-zip-hoodie-gothic-skull-graphic-black-full-zip-sweatshirt": { "title": "REFLUX - Skull Cluster Zip Hoodie", "price": 52.00, "currency": "USD", "category": "Hoodies" },
    "reflux-poster-w-john-and-favorite-hat": { "title": "REFLUX Poster w/ John and Favorite Hat", "price": 57.00, "currency": "USD", "category": "Posters" },
    "reflux-ufo-hoodie-hooded-sweatshirt": { "title": "REFLUX - UFO Hoodie", "price": 45.00, "currency": "USD", "category": "Hoodies" },
    "reflux-drip-t-shirt": { "title": "REFLUX DRIP T-SHIRT", "price": 30.00, "currency": "USD", "category": "T-Shirts" },
    "reflux-skull-cluster-tee-barbed-wire-graphic-shirt": { "title": "REFLUX Skull Cluster Barbed Wire Tee", "price": 24.00, "currency": "USD", "category": "T-Shirts" },
    "skull-cluster-iron-on-patch-gothic-rocker-patch": { "title": "Skull Cluster Iron-On Patch", "price": 15.99, "currency": "USD", "category": "Accessories" },
    "skull-cluster-mug-gothic-skull-coffee-mug-11oz-or-15oz-ceramic": { "title": "Skull Cluster Gothic Coffee Mug", "price": 11.77, "currency": "USD", "category": "Accessories" },
    "skull-cluster-pin-button-skull-art-button-pin-gothic-badge": { "title": "Skull Cluster Pin Button Badge", "price": 6.05, "currency": "USD", "category": "Accessories" },
    "band-photo-with-abstract-barbed-wire-design-kiss-cut-sticker-square-music-sticker": { "title": "Barbed Wire Design Kiss-Cut Sticker", "price": 4.75, "currency": "USD", "category": "Stickers" },
    "reflux-5-skull-sticker": { "title": "REFLUX 5 SKULL STICKER", "price": 4.75, "currency": "USD", "category": "Stickers" }
  }
}