dupe.com

Dupe MCP provides tools for searching products by text, images, and URLs using Dupe.com's search capabilities. ## Tools Available ### search_products_by_text Search for products using text description or keywords. This tool searches through various shopping platforms to find products matching your query. {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","description":"Text query to search for products. Use the user's exact input with only spelling/grammar corrections. Do not modify the query in any way. Do not add attributes, price ranges, or features."},"search_category":{"default":"all","description":"Categorize the user's search intent into one of the following categories: all, Fashion, Furniture, Home Decor, Electronics, Beauty, Toys, Sporting, Pets, Baby & Kids, Auto, Food, Hardware, Office, Media, Other. Pick all for All categories. Pick Fashion for Clothing, footwear, jewelry, eyewear, handbags, and accessories worn on the body (e.g. shirts, shoes, rings, sunglasses, purses). DOES NOT include cosmetics (those are Beauty), device accessories (phone cases are Electronics), or watches that are primarily smart devices (Electronics).. Pick Furniture for Real, physical furniture: sofas, chairs, tables, beds, desks, cribs, dressers, bookshelves. DOES NOT include furniture accessories like seat cushions, neck pillows, chair mats, or slipcovers — those are Home Decor if decorative, Other otherwise.. Pick Home Decor for Decorative or soft-goods home items: art prints, candles, mirrors, vases, rugs, bedding, throw pillows, curtains, kitchenware, dinnerware. DOES NOT include functional appliances (those are Electronics if powered, Other otherwise), hardware/tools, or cleaning supplies.. Pick Electronics for Powered devices and their accessories: phones, laptops, tablets, gaming consoles, cameras, headphones, smartwatches, phone cases, chargers, cables, monitors, PC components (RAM, SSDs, GPUs), smart home devices, 3D printers, appliances like toasters/fans/air purifiers, and water filtration systems.. Pick Beauty for Cosmetics, skincare, haircare, fragrance, and personal grooming products: foundation, setting powder, blush, lipstick, serums, moisturizer, cleansers, shampoo, hair tools (dryers, curling irons, straighteners), perfume, nail polish, electric razors, shavers, trimmers.. Pick Toys for Toys, games, puzzles, fidgets, stress balls, squishies, plushies, action figures, board games, children's playsets, and collectibles designed for play. DOES NOT include video games or game software — those are Media.. Pick Sporting for Athletic and outdoor equipment: bikes and e-bikes, treadmills, yoga mats, dumbbells, camping gear, ski equipment, fishing rods, golf clubs, sports balls. Activewear clothing is Fashion, not Sporting.. Pick Pets for Pet food, supplies, accessories, and care: dog/cat food, treats, litter, leashes, collars, pet beds, carriers, pet toys, aquarium and reptile supplies, pet grooming. DOES NOT include veterinary medicines or service-animal certification gear.. Pick Baby & Kids for Baby and child gear, clothing, and consumables: strollers, car seats, baby/kids clothing and shoes, diapers, bottles, school supplies, kids' backpacks. Cribs and changing tables are Furniture; play toys are Toys; powered baby devices (baby monitors, smart cameras, electric warmers) are Electronics.. Pick Auto for Automotive parts, accessories, tools, and care products: car parts, tires, batteries, motor oil, dashcams, jump starters, car detailing supplies, roof racks, floor mats. DOES NOT include vehicles themselves, bicycles (Sporting), or motorcycle gear if primarily protective apparel (Fashion).. Pick Food for Food, beverages, snacks, specialty groceries, meal kits, alcohol, coffee/tea, tobacco/vape, and consumables. DOES NOT include kitchenware/dinnerware (Home Decor), dietary supplements or vitamins (Beauty), or pet food (Pets).. Pick Hardware for Hardware, tools, building materials, plumbing, electrical fixtures: power tools, hand tools, fasteners, lumber, paint, pipes, electrical outlets, recessed lighting fixtures (the fixture itself, not the decorative lamp). DOES NOT include decorative lighting / lamps (Home Decor), appliances (Electronics), or kitchenware (Home Decor).. Pick Office for Office supplies and stationery: paper, pens, notebooks, printer ink and toner, binders, calendars, planners, desk organizers, label makers. DOES NOT include office furniture like desks or chairs (Furniture) or office electronics like laptops or monitors (Electronics).. Pick Media for Books, magazines, music, movies, video games, software, audiobooks, e-books, digital subscriptions, and downloadable content. DOES NOT include physical media playback devices (Electronics) or board / tabletop games (Toys).. Pick Other for Reserved catch-all for genuinely ambiguous or low-volume traffic: industrial / business supplies (B2B equipment), religious / ceremonial items, mature / adult-only products, and queries that can't be confidently bucketed. Most shopping queries should land in one of the named categories above — use Other only when no concrete category fits.. If you are not sure, use 'all'.","type":"string","enum":["all","Fashion","Furniture","Home Decor","Electronics","Beauty","Toys","Sporting","Pets","Baby & Kids","Auto","Food","Hardware","Office","Media","Other"]},"refresh":{"default":false,"description":"Force refresh to bypass cache and get latest results. Use sparingly for performance.","type":"boolean"}},"required":["query","search_category","refresh"],"additionalProperties":false} ### search_products_by_image Search for visually similar products using an image. Provide an image URL (or hash of existing result) and find visually similar products. {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"image_url":{"default":"","description":"Direct image URL for new visual search. Must be accessible publicly. If you are refining a previous search, use the hash parameter instead and leave this blank. Otherwise, this parameter is required.","type":"string"},"refresh":{"default":false,"description":"Force cache bypass for fresh results. (default: false)","type":"boolean"},"load_more":{"default":false,"description":"Load more results for pagination (default: false)","type":"boolean"},"is_refinement":{"default":false,"description":"Set to true when refining a previous search with new criteria. MUST be true when q is provided with a hash. (default: false, required true when q is not empty)","type":"boolean"},"hash":{"default":"","description":"Hash from a previous URL or image search result. CRITICAL: When you have a hash from ANY previous URL or image search and the user has, you MUST use it here for ALL subsequent refinements (even text-only refinements from the user). The hash keeps the visual context while allowing text refinements via the q parameter.","type":"string"},"q":{"default":"","description":"Text refinement for visual search. CRITICAL: When user provides text refinement after a URL or image search (like \"in black\", \"cheaper version\", \"without sleeves\"), put that refinement text here along with the hash. Use to add context or filters. Can reword user input to improve results like color, style, price. Examples: \"in blue\", \"under $50\", \"casual style\". Leave empty ONLY for initial image-only searches. Do NOT pass a value if you are not confident about the product or the user's intent. Leave this blank if the user has only provided an image url, and it is the starting point of the search.","type":"string"}},"required":["image_url","refresh","load_more","is_refinement","hash","q"],"additionalProperties":false} ### get_product_details Fetch enriched product details — description, brand, specifications, images, and typical price range — for one or more products from a previous search. Pass product_id values returned by search_products_by_text or search_products_by_image. Use this when the user wants to know more about a specific product or when you need a product description to display. Processes up to 5 products per call in parallel. {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"product_ids":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string"},"description":"Array of product_id values from previous search results. Maximum 5 per call."}},"required":["product_ids"],"additionalProperties":false} ### search_products_by_url Extract and search for alternatives to a specific product from its URL. Use ONLY for complete product page URLs. {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"product_url":{"type":"string","description":"Full product page URL. Must be a specific product, not a category or search results page"},"hash":{"default":"","description":"If you already have a product hash, you can search it again instead of a url. This is useful with an image override","type":"string"},"image_override":{"default":"","description":"Alternative image URL if product page image is unsuitable for visual matching. (default: empty)","type":"string"},"refresh":{"default":false,"description":"Force refresh of cached data (default: false)","type":"boolean"}},"required":["product_url","hash","image_override","refresh"],"additionalProperties":false} ## Tool Usage - Follow each tool's schema exactly, and do not add any additional arguments or parameters. - All tool inputs are required fields, but empty values specific to the type of input ("" for strings, 0 for numbers, false for booleans, etc.) are allowed for "optional" fields. ### CRITICAL: Refinement Rules - **After URL search (search_products_by_url):** ALL text refinements must use search_products_by_image with the hash and q parameter. NEVER use search_products_by_text for refinements after a URL search. - **After image search (search_products_by_image):** ALL text refinements must use search_products_by_image with the hash and q parameter in refinement mode (is_refinement=true). - **After text-only search (search_products_by_text):** Continue using search_products_by_text for refinements, combining context from previous searches. ### Hash Usage - Once you receive a hash from a URL or image search, store it and use it for ALL subsequent refinements - The hash value "prompt" is a special value that should NOT be treated as a hash. You must use the hash of the latest user provided url or image in the conversation, and it must not be "prompt". - When you have a hash and the user provides text refinement, use search_products_by_image with that hash and set the q parameter to the user's refinement text ### Other Rules - The refresh flag should be set to true if you want to bypass the cache and get the latest results. It should be set to false by default, as this will perform faster. - When handling URLs it is paramount to pass the url exactly as-is in input, do not modify it in any way to maintain accuracy and correctness. ## Example Usage ### Text Search ```json { "name": "search_products_by_text", "arguments": { "query": "white sneakers", "search_category": "Fashion", "refresh": false } } ``` ### Image Search Initial search: ```json { "name": "search_products_by_image", "arguments": { "image_url": "https://example.com/assets/product.jpg", "is_refinement": false, "hash": "", "q": "", "refresh": false, "load_more": false, } } ``` Refinement: The hash will come from a prior search result, and the q parameter will be the user's refinement query. ```json { "name": "search_products_by_image", "arguments": { "image_url": "https://example.com/assets/product.jpg", "is_refinement": true, "hash": "1234567890", "q": "in blue", "refresh": false, "load_more": false, } } ``` ### URL Search Initial search: ```json { "name": "search_products_by_url", "arguments": { "product_url": "https://example.com/products/product-name", "hash": "", "image_override": "", "refresh": false, } } ``` Refinement: ```json { "name": "search_products_by_url", "arguments": { "product_url": "https://example.com/products/product-name", "hash": "1234567890", "image_override": "https://example.com/assets/other-product.jpg", "refresh": false, } } ```