Search Shopify store
shopify_search_listSearch a Shopify store's products, articles, and pages by store and query, with filters, facets, and result counts; returns a cursor-paginated list.
Instructions
Search a Shopify store's products, articles and pages, with the store's facets and result count. Requires store and query. Returns a list (use cursor when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"store": "<store>",
"query": "<query>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "shopify_search_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Restrict the search to `product`, `article` or `page`. Default: all three. | |
| limit | No | Rows per page, 1 to 250. Default: 50. | |
| query | Yes | Required. What to search for in the store. | |
| store | Yes | Required. The store's domain, for example `allbirds.com`, `www.allbirds.com` or `weareallbirds.myshopify.com`. A full URL is accepted and reduced to its host. Only public storefront hosts are accepted. | |
| cursor | No | Cursor from `page.nextCursor` of the previous response. It only works with the same filters. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| country | No | ISO 3166-1 alpha-2 country used for prices, currency and language, e.g. `GB`. Default: the store's own market. | |
| language | No | Two-letter language code, e.g. `EN`. Default: the store's own language. | |
| priceMax | No | Highest product price to include. | |
| priceMin | No | Lowest product price to include. | |
| available | No | Only products with an available variant. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. |