Etsy

Compare 2-5 Etsy listings side-by-side. review_summaries is REQUIRED — pass one entry per listing_id, paraphrased from the review_excerpts returned earlier by prepareCompareListings (≤500 chars). Use "" for any listing that had no excerpts. badges is REQUIRED — pass one entry per listing_id with a very short label (≤20 chars) highlighting a key differentiator, e.g. {"123":"Best value","456":"Top rated"}. Returns a comparison widget with direct listing links.

Display Etsy listings as 1–3 themed carousels, one per group. Always use this tool for results from searchEtsyListings — even when all results share a single theme (use one group in that case). Each group needs a short title (≤60 chars), a one-sentence rationale (≤300 chars), and 3–16 listing IDs. Listing IDs must be unique across all groups.

Display a single coherent set of Etsy listings in a visual grid widget. Use when: (1) search returned fewer than 3 listings and displayEtsyListingGroups cannot be used, or (2) you have a manually-curated flat list not from searchEtsyListings. For search results with 3 or more listings, always use displayEtsyListingGroups instead.

Fetches review excerpts for 2–5 specific Etsy listings to prepare for compareEtsyListings. Call this when the user wants to compare listings — either after displayEtsyListingGroups or displayEtsyListings. Returns seller-provided review excerpts for you to paraphrase into compareEtsyListings.review_summaries (≤500 chars per listing). If a listing's reviews could not be fetched it will be absent from the response — pass "" in review_summaries for those listing_ids. Always call this before compareEtsyListings.

Search Etsy for listings matching keywords. Returns a text list for you to review; always follow up with displayEtsyListingGroups. Supports filtering by price, location, free shipping, and sale.