search_products

Active

declared in 1.26.0

Search products in the connected store by keyword. Use this when a shopper's query suggests specific terms the agent can match against product titles or tags — e.g. "HEPA air purifier" or "leather wristwatch". Matches Shopify's native storefront search behavior, so results align with what customers would find on the site. Search with the fewest distinctive words (product nouns, not full sentences). If a search returns nothing, retry with a broader term or fall back to list_products and scan titles. Only sellable products are returned (drafts/archived are excluded). Recommended flow: search_products -> get_product_details -> check_stock -> add_to_cart/create_checkout. Args: query: Keyword or phrase to match. limit: Max products to return (1-50, default 10). Returns: Same shape as ``list_products``. Empty products list when no matches.

Parameters schema

{
  "type": "object",
  "title": "search_productsArguments",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 10
    },
    "query": {
      "type": "string",
      "title": "Query"
    }
  }
}

What this tool wraps· 1 endpoint

min confidence0.70 0.50

Data resourceShopify Admin API
Shopify · commerce
name mention0.65

Parent server

Graffeo Coffee Roasting

1/7 registries

View full server →