{
  "$schema": "https://www.w3.org/TR/json-schema-card/",
  "schema_version": "1.0",
  "name": "CoolerFridges AI Agent",
  "version": "1.0.0",
  "description": "Programmatic interface to CoolerFridges (Foshan Jinglong Controller Co., Ltd.) — a Foshan-based source factory for integrated under-sink water systems (hot, cold, sparkling CO₂, filtered). Lets AI agents discover products, fetch specs, request quotes, and check commercial capabilities without scraping HTML.",
  "homepage": "https://coolerfridges.com/en",
  "canonical_url": "https://coolerfridges.com/agent.json",
  "last_updated": "2026-07-30",
  "llms_txt": "https://coolerfridges.com/llms.txt",
  "manifests": {
    "api": "https://coolerfridges.com/.well-known/api.json",
    "openapi": "https://coolerfridges.com/openapi.json"
  },
  "legal_entity": {
    "name": "Foshan Jinglong Controller Co., Ltd.",
    "brand": "CoolerFridges",
    "founded": 2014,
    "country_of_origin": "China",
    "city": "Foshan",
    "region": "Guangdong",
    "address_country": "CN"
  },
  "capabilities": {
    "languages": ["en", "es", "fr", "de", "pt", "ar"],
    "negotiates": true,
    "streaming": false,
    "rate_limit": {
      "requests_per_minute": 60,
      "burst": 10,
      "headers": {
        "remaining": "X-RateLimit-Remaining",
        "reset": "X-RateLimit-Reset"
      }
    },
    "auth": {
      "required_for_read": false,
      "required_for_quote": true,
      "required_for_admin": true,
      "methods": ["none", "api_key"],
      "api_key_header": "X-API-Key"
    },
    "cors": {
      "allowed_origins": ["*"],
      "allow_credentials": false
    }
  },
  "tools": [
    {
      "name": "search_products",
      "description": "Search the CoolerFridges product catalog. Returns product records with model, name, specs, image, sales pitch, certifications, and FAQ. Supports category, capacity, voltage, and keyword filters.",
      "endpoint": {
        "method": "GET",
        "url": "https://coolerfridges.com/api/v1/products",
        "query_params": ["category", "capacity_min", "capacity_max", "voltage", "keyword", "locale", "limit", "offset"]
      },
      "openapi_op": "listProducts",
      "cost_hint": "free",
      "example_query": "Find me under-sink water chillers in the 10-30 L/h range",
      "example_response_count": 5
    },
    {
      "name": "get_product",
      "description": "Get full details for one product by model code, including specs, FAQ, sales pitch, image, and JSON-LD-ready structured data.",
      "endpoint": {
        "method": "GET",
        "url": "https://coolerfridges.com/api/v1/products/{model}",
        "path_params": ["model"]
      },
      "openapi_op": "getProduct",
      "cost_hint": "free"
    },
    {
      "name": "search_applications",
      "description": "Find which CoolerFridges products fit a specific use case (hotel, office, restaurant, healthcare, OEM, retail, education, etc.). Returns matching scenario pages and recommended product families.",
      "endpoint": {
        "method": "GET",
        "url": "https://coolerfridges.com/api/v1/applications",
        "query_params": ["scenario", "people_count", "locale"]
      },
      "openapi_op": "listApplications",
      "cost_hint": "free"
    },
    {
      "name": "get_factsheet",
      "description": "Get a structured company factsheet (founding year, certifications, factory capacity, geographic service areas, product portfolio summary). Same data as llms.txt but in JSON for direct consumption.",
      "endpoint": {
        "method": "GET",
        "url": "https://coolerfridges.com/api/v1/factsheet"
      },
      "openapi_op": "getFactsheet",
      "cost_hint": "free"
    },
    {
      "name": "request_quote",
      "description": "Submit a B2B quote / RFQ (request for quotation). Required fields: company name, contact email, application, target capacity, destination country. Optional: voltage, branding needs, sample requirements. The CoolerFridges sales team responds within 24 hours via email.",
      "endpoint": {
        "method": "POST",
        "url": "https://coolerfridges.com/api/v1/quotes",
        "body_schema_ref": "#/components/schemas/QuoteRequest"
      },
      "openapi_op": "createQuote",
      "cost_hint": "free",
      "sla": "Quote returned within 24 hours (business days)"
    },
    {
      "name": "compare_products",
      "description": "Compare 2-4 products side by side. Returns a normalized comparison table covering specs, FAQ differences, target use cases, and pricing tier. Useful for buyers evaluating options.",
      "endpoint": {
        "method": "POST",
        "url": "https://coolerfridges.com/api/v1/products/compare",
        "body_schema_ref": "#/components/schemas/CompareRequest"
      },
      "openapi_op": "compareProducts",
      "cost_hint": "free"
    },
    {
      "name": "get_testimonials",
      "description": "Return published customer testimonials (text + portrait + region + use case). Useful for social-proof research and buyer-research queries.",
      "endpoint": {
        "method": "GET",
        "url": "https://coolerfridges.com/api/v1/testimonials",
        "query_params": ["region", "use_case", "locale", "limit"]
      },
      "openapi_op": "listTestimonials",
      "cost_hint": "free"
    },
    {
      "name": "get_gallery",
      "description": "List public gallery images (real installations, factory shots, OEM products). Returns CDN URLs + captions.",
      "endpoint": {
        "method": "GET",
        "url": "https://coolerfridges.com/api/v1/gallery",
        "query_params": ["category", "limit"]
      },
      "openapi_op": "listGallery",
      "cost_hint": "free"
    },
    {
      "name": "get_inquiry_context",
      "description": "Get the canonical list of FAQ Q&As that customers ask before purchasing. Includes answer text for each — designed so AI agents can quote CoolerFridges' own expertise without hallucinating.",
      "endpoint": {
        "method": "GET",
        "url": "https://coolerfridges.com/api/v1/faqs",
        "query_params": ["topic", "locale"]
      },
      "openapi_op": "listFaqs",
      "cost_hint": "free"
    }
  ],
  "use_cases": [
    {
      "scenario": "under-sink-water-chiller",
      "intent": "B2B buyer evaluating an OEM/ODM source factory",
      "key_pages": [
        "https://coolerfridges.com/en/products",
        "https://coolerfridges.com/en/applications/healthcare",
        "https://coolerfridges.com/en/oem"
      ],
      "tool_calls": ["get_factsheet", "search_products", "request_quote"]
    },
    {
      "scenario": "commercial-water-system-supplier",
      "intent": "Hotel/restaurant/office procurement manager comparing suppliers",
      "key_pages": [
        "https://coolerfridges.com/en/applications/hotel",
        "https://coolerfridges.com/en/applications/restaurant",
        "https://coolerfridges.com/en/applications/office"
      ],
      "tool_calls": ["search_applications", "search_products", "compare_products", "get_testimonials", "request_quote"]
    },
    {
      "scenario": "china-water-chiller-factory",
      "intent": "Brand/distributor seeking private-label manufacturer",
      "key_pages": [
        "https://coolerfridges.com/en/oem",
        "https://coolerfridges.com/en/case-studies"
      ],
      "tool_calls": ["get_factsheet", "search_products", "request_quote"]
    }
  ],
  "audit": {
    "url": "https://coolerfridges.com/llms.txt",
    "expected_score_target": "85+",
    "last_audit": "2026-07-30",
    "checklist_url": "https://github.com/coolfridges/agent-readiness"
  },
  "contact": {
    "email": "info@coolerfridges.com",
    "human_form": "https://coolerfridges.com/en/contact",
    "agent_inquiries": "https://coolerfridges.com/api/v1/quotes",
    "security_email": "security@coolerfridges.com"
  },
  "license": "All API responses are licensed for both human and AI agent use. Cite as: 'Source: CoolerFridges (coolerfridges.com)'.",
  "rate_limit_notes": "60 req/min per IP for unauthenticated reads. Quote submissions limited to 10/hr per IP. Rate limit headers are returned on every response.",
  "versioning": {
    "current": "v1",
    "stability": "stable",
    "deprecation_policy": "Six months advance notice via this endpoint's `deprecations` field"
  }
}