{
  "schema_version": "0.1",
  "name": "Shakarra",
  "homepage": "https://shop.shakarra.com",
  "description": "Shop US retailers (Amazon, Walmart, Target, Best Buy, Costco, Home Depot) from Nigeria with Naira checkout and delivery.",
  "actions": [
    {
      "name": "search_products",
      "description": "Search products across supported US retailers. Use the term query parameter; optionally filter by store slug.",
      "url": "https://shop.shakarra.com/search",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "term": {
            "type": "string",
            "description": "Free-text product search query",
            "minLength": 1,
            "maxLength": 200
          },
          "store": {
            "type": "string",
            "description": "Optional retailer slug to scope the search",
            "enum": [
              "amazon",
              "walmart",
              "target",
              "bestbuy",
              "costco",
              "homedepot"
            ]
          }
        },
        "required": ["term"]
      }
    },
    {
      "name": "browse_store",
      "description": "Open a retailer storefront on Shakarra to browse categories and products for that store.",
      "url": "https://shop.shakarra.com/stores",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "store": {
            "type": "string",
            "description": "Retailer slug appended to /stores/{store}",
            "enum": [
              "amazon",
              "walmart",
              "target",
              "bestbuy",
              "costco",
              "homedepot"
            ]
          }
        },
        "required": ["store"]
      }
    },
    {
      "name": "browse_product_catalog",
      "description": "Browse the Shakarra product hub and discover product detail pages.",
      "url": "https://shop.shakarra.com/products",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "retailer": {
            "type": "string",
            "description": "Optional retailer slug when opening a specific product path under /products/{retailer}/",
            "enum": [
              "amazon",
              "walmart",
              "target",
              "bestbuy",
              "costco",
              "homedepot"
            ]
          }
        },
        "required": []
      }
    },
    {
      "name": "list_stores",
      "description": "List all supported US retailers available on Shakarra.",
      "url": "https://shop.shakarra.com/stores",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "format": {
            "type": "string",
            "description": "Optional hint for response format; use html for the storefront page",
            "enum": ["html"]
          }
        },
        "required": []
      }
    },
    {
      "name": "fetch_catalog_index",
      "description": "Download the machine-readable JSON catalog index of public product URLs and metadata.",
      "url": "https://shop.shakarra.com/catalog.json",
      "method": "GET",
      "parameters": {
        "type": "object",
        "properties": {
          "updated": {
            "type": "string",
            "description": "Optional cache-busting token; omit to fetch the latest catalog"
          }
        },
        "required": []
      }
    }
  ]
}