{"openapi":"3.1.0","info":{"title":"Everything4WD Read-only Product Discovery","version":"1.9.0","description":"Public D1 keyword search and MCP plus private Neto lookup. Selling price from Neto DefaultPrice and RRP from Neto RRP; compare to store pricing before relying on discounts."},"servers":[{"url":"https://e4wd-ai-discovery.shopperdais.workers.dev"}],"x-mcp-server":"https://e4wd-ai-discovery.shopperdais.workers.dev/mcp","components":{"securitySchemes":{"DiscoveryToken":{"type":"apiKey","in":"header","name":"X-Test-Token"}}},"paths":{"/api/public/search":{"get":{"operationId":"searchEverything4WDPublicProducts","summary":"Public keyword search of available Everything4WD products","description":"Read-only D1 search. No Neto or private token required. Returns up to 10 active, approved, visible products with storefront links; cached briefly; rate-limited per Cloudflare location.","security":[],"parameters":[{"name":"q","in":"query","required":true,"description":"Product keywords, 2 to 60 characters","schema":{"type":"string","minLength":2,"maxLength":60},"example":"Anderson"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"query":{"type":"string"},"count":{"type":"integer"},"products":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string"},"name":{"type":"string"},"brand":{"type":["string","null"]},"model":{"type":["string","null"]},"price":{"type":["string","null"]},"currency":{"type":"string"},"url":{"type":"string","format":"uri"},"image_url":{"type":["string","null"],"format":"uri"},"description":{"type":["string","null"],"maxLength":250},"category":{"type":["string","null"]},"sale_price":{"type":["string","null"]},"rrp":{"type":["string","null"]},"availability":{"type":["string","null"],"enum":["In Stock","Out of Stock","Preorder",null]}}}}}}}}},"400":{"description":"Invalid query"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Search unavailable"}}}},"/api/products":{"post":{"operationId":"lookupNetoProduct","summary":"Lookup Neto products by SKU, name or brand","security":[{"DiscoveryToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sku":{"type":"string"},"name":{"type":"string"},"brand":{"type":"string"}},"anyOf":[{"required":["sku"]},{"required":["name"]},{"required":["brand"]}]}}}},"responses":{"200":{"description":"Public products"},"401":{"description":"Unauthorized"}}}},"/api/search":{"post":{"operationId":"keywordSearchD1","summary":"Search indexed public products by keywords","security":[{"DiscoveryToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","example":"Anderson cable"}}}}}},"responses":{"200":{"description":"Matching products"},"401":{"description":"Unauthorized"}}}}}}