Search like a customer
storefront_searchSearch a Shopware sales channel exactly as a customer to return Store API results with real visibility, stock, ranking, and prices; optionally explain a product's rank or absence.
Instructions
Run a search in a sales channel exactly as a customer would, through Shopware's Store API: same visibility, stock and closeout rules, same ranking and prices. Optionally explain one product: its position in the results, or why it does not show up (inactive, not visible in the channel, link-only visibility, closeout without stock, not in the search index, no search keyword matching the term). Read-only. Returns { salesChannel, term, total, items[], explain? }.
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": {
"term": "<term>"
},
"name": "storefront_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| term | Yes | What the customer types | |
| limit | No | Results to return | |
| explain | No | Product number to explain: where it ranks, or why it is missing | |
| salesChannel | No | Sales channel id or name; default: the first active storefront |