nima

Search Products

Search the product catalog. Use this for any product lookup by free-text name, category, collection, price range, or attribute values. Returns a page of products plus the attribute facets (drill-down) available to narrow the search further, and the price range across all matches. Running in anonymous/public mode: only published, customer-visible products are returned, same as an unauthenticated storefront visitor would see. Products whose category or brand collection is hidden via metadata are n

Get Product

Get a single product by id: its variants, assigned attributes, brand, category breadcrumb, image, page link, and the brand's FAQ if it has one — everything the product page shows a visitor. Use search_products first to find the id if you don't already have it. Anonymous/public mode: unpublished products, and products the storefront hides, are reported as not found — same as the site.

List Categories

List the category tree. Use to find a categoryId for search_products, or to see the taxonomy structure. A category with `hidden: true` is hidden from the storefront, as are its descendants, and so is a top-level category left with no visible children. Entities the storefront hides are never returned — this server runs in anonymous/public mode and sees what a visitor sees. Ordering matches the site: `metadata.order`, then sortOrder, then name.

List Collections

List all collections (curated product groupings, e.g. "Summer Sale"). Use to find a collectionId for search_products. Includes brand collections too — use list_brands instead if you specifically want brands. Hidden collections have `hidden: true`. Entities the storefront hides are never returned — this server runs in anonymous/public mode and sees what a visitor sees. Sorted by `metadata.order` then name, as the site sorts them.

List Brands

List brands. A brand is just a collection tagged with metadata.type === "brand" — there is no dedicated brand endpoint, so this filters list_collections client-side. Returns each brand's collectionId, which is what search_products' collectionId expects to filter products by that brand, plus its page link and whether it has an FAQ. Entities the storefront hides are never returned — this server runs in anonymous/public mode and sees what a visitor sees.

List Attributes

List all attribute definitions (e.g. "material", "color"). Use get_attribute_values for a given attribute's possible values, or resolve_attribute_value to go straight from a human name to a value id. `displayName` is what the storefront actually renders — `metadata.label` when set, otherwise the name — and `filterableInStorefront`/`visibleInStorefront` say whether visitors ever see the attribute.

Get Attribute Values

List the possible values of a single attribute (there is no flat "list all values" endpoint — values are always scoped to an attribute). Use this to translate a human value ("red") into the numeric valueId that search_products' attributeValueIds expects.

Resolve Attribute Value

Resolve a human-readable attribute value name (e.g. "red", "cotton") to its numeric {attributeId, valueId} pair, as needed by search_products' attributeValueIds. Optionally scope by attributeSlug (e.g. "color") if the same word could apply to more than one attribute. Returns the best matches, best first.