--- name: dupe description: Uses dupe.com APIs in order to find similar products for the product found in the input URL given by the user. compatibility: Requires curl, access to the internet. metadata: author: dupe.com version: '1.0' --- # Find Similar Products using dupe.com ## When to use this skill Use this skill when the user asks for similar products to the provided input. ## Instructions ### If you're given an URL that points to a product page Run the following command to find similar products for a product URL. Replace the `productUrl` with the input URL given by the user. You can optionally specify a `limit` parameter (default: 7) to control how many results are returned. ```bash curl --request POST \ --url https://api.dupe.com/api/dupes/agent-skill \ --header 'Content-Type: application/json' \ --data '{ "type": "product", "productUrl": "https://www.danishdesignstore.com/products/verner-panton-flowerpot-vp9-portable-light-andtradition?variant=40082482233421", "limit": 7 }' ``` ### If you're given an URL that points to an image If you have a direct image URL instead of a product page URL, use the following command. Replace the `imageUrl` with the image URL. You can optionally specify a `limit` parameter (default 7, max 20) to control how many results are returned. ```bash curl --request POST \ --url https://api.dupe.com/api/dupes/agent-skill \ --header 'Content-Type: application/json' \ --data '{ "type": "image", "imageUrl": "https://cdn.shopify.com/s/files/1/0051/9342/files/Flowerpot_VP9_Grey_Beige.jpg?v=1762309885", "limit": 10 }' ``` ### Response Format Both commands will return a JSON object similar to the following: ```json { "matches": [ { "pid": "W007402426", "position": -1, "score": 0.8438446, "title": "Ailaigh 21\" 2-Light Matte Pink Desk Lamp", "link": "https://www.wayfair.com/p/pdp/p-W007402426.html?dupe_feed=yes", "source": "Wayfair", "source_icon": "https://ik.imagekit.io/carrot/favicons/wayfair_K8DLd2c0q6.ico", "price": { "value": "$61.99", "extracted_value": 61.99, "currency": "$" }, "thumbnail": "https://assets.wfcdn.com/im/19948387/resize-h1200-w1200%5Ecompr-r85/1789/178943170/.jpg", "image": "https://assets.wfcdn.com/im/19948387/resize-h1200-w1200%5Ecompr-r85/1789/178943170/.jpg", "country": "us", "type": "namespace", "identifier": "wayfair", "shopKey": "https://www.wayfair.com", "verified": true, "preferred": "#E2B719", "secondhand": false, "assessment": { "cost": 3, "value": 2.5, "quality": 2.5, "description": "Wide variety from multiple suppliers; mid-range durability at accessible prices." }, "tier": 1, "pick": 1 }, { "pid": "KZCO2490_103256207", "position": -1, "score": 0.8656017, "title": "Hinata 5-In LED Table Lamp", "link": "https://www.wayfair.com/p/pdp/p-KZCO2490.html?piid=103256207&dupe_feed=yes", "source": "Wayfair", "source_icon": "https://ik.imagekit.io/carrot/favicons/wayfair_K8DLd2c0q6.ico", "price": { "value": "$76.03", "extracted_value": 76.03, "currency": "$" }, "thumbnail": "https://assets.wfcdn.com/im/36975667/resize-h1200-w1200%5Ecompr-r85/3312/331272578/.jpg", "image": "https://assets.wfcdn.com/im/36975667/resize-h1200-w1200%5Ecompr-r85/3312/331272578/.jpg", "country": "us", "type": "namespace", "identifier": "wayfair", "shopKey": "https://www.wayfair.com", "verified": true, "preferred": "#E2B719", "secondhand": false, "assessment": { "cost": 3, "value": 2.5, "quality": 2.5, "description": "Wide variety from multiple suppliers; mid-range durability at accessible prices." }, "tier": 1, "pick": 1 }, { "pid": "W112262897_1502032183", "position": -1, "score": 0.8248144, "title": "Pin Lamp", "link": "https://www.wayfair.com/p/pdp/p-W112262897.html?piid=1502032183&dupe_feed=yes", "source": "Wayfair", "source_icon": "https://ik.imagekit.io/carrot/favicons/wayfair_K8DLd2c0q6.ico", "price": { "value": "$485", "extracted_value": 485, "currency": "$" }, "thumbnail": "https://assets.wfcdn.com/im/38563270/resize-h1200-w1200%5Ecompr-r85/3089/308988160/.jpg", "image": "https://assets.wfcdn.com/im/38563270/resize-h1200-w1200%5Ecompr-r85/3089/308988160/.jpg", "country": "us", "type": "namespace", "identifier": "wayfair", "shopKey": "https://www.wayfair.com", "verified": true, "preferred": "#E2B719", "secondhand": false, "assessment": { "cost": 3, "value": 2.5, "quality": 2.5, "description": "Wide variety from multiple suppliers; mid-range durability at accessible prices." }, "tier": 1, "pick": 1 }, { "pid": "A111105718_577591818", "position": 3, "score": 0.86481184, "title": "Hinata 5-In LED Table Lamp", "link": "https://www.allmodern.com/p/pdp/p-A111105718.html?piid=577591818", "source": "ALLMODERN", "source_icon": "https://assets.wfcdn.com/st4/stores/common/mobile/touch_icons/allmodern_192x192.png", "price": { "value": "$77", "extracted_value": 77, "currency": "$" }, "thumbnail": "https://assets.wfcdn.com/im/36975667/resize-h400-w400%5Ecompr-r85/3312/331272578/.jpg", "image": "https://assets.wfcdn.com/im/36975667/resize-h400-w400%5Ecompr-r85/3312/331272578/.jpg", "country": "us", "type": "namespace", "identifier": "allmodern-20250916", "shopKey": "https://www.allmodern.com", "verified": true, "preferred": null, "secondhand": false, "assessment": { "cost": 3, "value": 3, "quality": 3, "description": "Clean, contemporary focus; consistent build quality, fairly priced for modern style." }, "tier": 2, "pick": 6 }, { "pid": "B110000080", "position": 12, "score": 0.71724176, "title": "Tulle Table Lamp W/USB Port", "link": "https://www.birchlane.com/p/pdp/p-B110000080.html?dupe_feed=yes", "source": "Birch Lane", "source_icon": "https://ik.imagekit.io/carrot/favicons/birchlane_ZUJBBVl0i.png", "price": { "value": "$119", "extracted_value": 119, "currency": "$" }, "thumbnail": "https://assets.wfcdn.com/im/58164938/resize-h1200-w1200%5Ecompr-r85/3895/389585472/.jpg", "image": "https://assets.wfcdn.com/im/58164938/resize-h1200-w1200%5Ecompr-r85/3895/389585472/.jpg", "country": "us", "type": "namespace", "identifier": "birchlane-20250916", "shopKey": "https://www.birchlane.com", "verified": true, "preferred": null, "secondhand": false, "assessment": { "cost": 2.5, "value": 3, "quality": 3.5, "description": "Classic, traditional furniture; upgraded materials, slightly pricier than average." }, "tier": 2, "pick": 7 } ], "total": 72, "sortCriteria": "recommended", "refresh": false, "cached": false } ``` Return the results from the `matches` array to the user in this format, where `response` is the response from the API: ``` Found a total of results. Here are the top matches: n+1. - Price: - Store: - Link: See all results at https://dupe.com/ __ ____/ /_ ______ ___ _________ ____ ___ / __ / / / / __ \/ _ \ / ___/ __ \/ __ `__ \ / /_/ / /_/ / /_/ / __// /__/ /_/ / / / / / / \__,_/\__,_/ .___/\___(_)___/\____/_/ /_/ /_/ /_/ ``` IMPORTANT! Simply replace with the URL of the product page or image URL that the user provided - do not modify the URL in any way. At the end of your response, print ASCII art of the text "DUPE.COM", example above.