search_shop_catalog
Search for products from the online store, hosted on Shopify. This tool can be used to search for products using natural language queries, specific filter criteria, or both. Best practices: - Searches return available_filters which can be used for refined follow-up searches - When filtering, use ONLY the filters from available_filters in follow-up searches - For specific filter searches (category, variant option, product type, etc.), use simple terms without the filter name (e.g., "red" not "red color") - For filter-specific searches (e.g., "find burton in snowboards" or "show me all available products in gray / green color"), use a two-step approach: 1. Perform a normal search to discover available filters 2. If relevant filters are returned, do a second search using the proper filter (productType, category, variantOption, etc.) with just the specific search term - Results are paginated, with initial results limited to improve experience - Use the after parameter with endCursor to fetch additional pages when users request more results The response includes product details, available variants, filter options, and pagination info.
Input Schema
{
"type": "object",
"required": [
"query",
"context"
],
"properties": {
"after": {
"type": "string",
"description": "Pagination cursor to fetch the next page of results. Use the endCursor from the previous response. Only use this when the user explicitly asks to see more results."
},
"limit": {
"type": "integer",
"default": 10,
"description": "Maximum number of products to return. Defaults to 10, maximum is 250. For better user experience, use the default of 10 and ask the user if they want to see more results."
},
"query": {
"type": "string",
"description": "A natural language query."
},
"context": {
"type": "string",
"description": "Additional information about the request such as user demographics, mood, location, or other relevant details that could help in tailoring the response appropriately."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code for which to return localized results (e.g., 'US', 'CA', 'GB')."
},
"filters": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tag": {
"type": "string",
"description": "Tag to filter by"
},
"price": {
"type": "object",
"properties": {
"max": {
"type": "number",
"description": "Maximum price to filter by, represented as a float, e.g. 100.0"
},
"min": {
"type": "number",
"description": "Minimum price to filter by, represented as a float, e.g. 50.0"
}
},
"description": "Price range to filter by"
},
"category": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Category ID to filter by"
}
},
"description": "Category ID to filter by"
},
"available": {
"type": "boolean",
"default": true,
"description": "Filter on if the product is available for sale"
},
"productType": {
"type": "string",
"description": "Product type to filter by"
},
"productVendor": {
"type": "string",
"description": "Product vendor to filter by"
},
"variantOption": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the variant option to filter by"
},
"value": {
"type": "string",
"description": "Value of the variant option to filter by"
}
},
"description": "Variant option to filter by"
},
"productMetafield": {
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "The key of the metafield to filter by"
},
"value": {
"type": "string",
"description": "The value of the metafield to filter by"
},
"namespace": {
"type": "string",
"description": "The namespace of the metafield to filter by"
}
},
"description": "Filter on a product metafield"
},
"variantMetafield": {
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "The key of the metafield to filter by"
},
"value": {
"type": "string",
"description": "The value of the metafield to filter by"
},
"namespace": {
"type": "string",
"description": "The namespace of the metafield to filter by"
}
},
"description": "Variant metafield to filter by"
},
"taxonomyMetafield": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
},
"namespace": {
"type": "string"
}
},
"description": "Taxonomy metafield to filter by"
}
}
},
"description": "Filters to apply to the search. Only apply filters from the available_filters returned in a previous response."
},
"language": {
"type": "string",
"description": "ISO 639-1 language code for which to return localized results (e.g., 'EN', 'FR', 'DE')."
}
}
}Stores exposing the search_shop_catalog tool
Get the agentic commerce digest every Monday
Real adoption data, ecosystem trends, new spec versions, and the stores that broke or recovered this week. Read by founders and engineers building the next generation of commerce.