Search Seller Agent catalogs
search_catalogSearch products in Shopify stores that enabled MagicGEO Seller Agent, by keywords matched against title, vendor, product type, tags and keywords. Returns store domain, numeric product_id, title, vendor, product URL and the last synced availability with its sync time. It never returns a price or a live offer: call verify_agent_offer with the returned shop and product_id to read live price and availability and obtain a native checkout link.
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": {
"query": "<query>"
},
"name": "search_catalog"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shop | No | Restrict to one store domain, e.g. example.myshopify.com | |
| limit | No | Maximum results, 1-20 (default 10) | |
| query | Yes | Search terms, e.g. snowboard | |
| in_stock_only | No | Only products available at the last catalog sync (still verify live) |