find_similar

Given a product ID, find similar products across the entire catalog. Uses vector similarity to surface products that share visual style, materials, price point, and category with the source product.

Parameters

Parameter	Type	Required	Default	Description
`product_id`	`string`	Yes	—	The product ID to find similar products for
`limit`	`number`	No	`10`	Max similar products per page
`page`	`number`	No	`1`	Page number (max 3)

Response

{
  "page": 1,
  "totalPages": 3,
  "totalResults": 24,
  "products": [
    {
      "id": "665b2a...",
      "title": "Suede Ankle Boot",
      "summary": "A modern take on the ankle boot in soft brown suede...",
      "price": 265,
      "currency": "USD",
      "category": "Footwear",
      "subcategory": "boots",
      "images": ["https://..."],
      "productUrl": "https://other-store.com/suede-ankle-boot",
      "brand": "Madewell",
      "similarityScore": 0.87
    }
  ]
}

Response fields

Field	Description
`page`	Current page number
`totalPages`	Total number of pages available
`totalResults`	Total number of similar products found
`similarityScore`	Vector similarity score (0–1) — how similar this product is to the source
`brand`	May differ from the source product — results span the entire catalog

Example

{
  "name": "find_similar",
  "arguments": {
    "product_id": "665a1f2b3c4d5e6f7a8b9c0d",
    "limit": 5,
    "page": 1
  }
}

When to use

Use find_similar for "more like this" scenarios — the user liked a product but wants to see alternatives, compare prices across stores, or explore the same style from different brands.