shop-minimal
Installation
SKILL.md
Product Search API
GET https://shop.app/web/api/catalog/search?query={query}
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query |
string | Yes | — | Search keywords |
limit |
int | No | 10 | Results 1–10 |
ships_to |
string | No | US |
ISO 3166 code. Controls currency + availability. Set when you know the user's country. |
ships_from |
string | No | — | ISO 3166 code for product origin |
min_price |
decimal | No | — | Min price (currency from ships_to) |
max_price |
decimal | No | — | Max price |
available_for_sale |
int | No | 1 | 1 = in-stock only |
include_secondhand |
int | No | 1 | 0 = new only |
categories |
string | No | — | Comma-delimited Shopify taxonomy IDs |
shop_ids |
string | No | — | Filter to specific shops |
products_limit |
int | No | 10 | Variants per product, 1–10 |