| 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.
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.
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:
{
"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 <response.total> results.
Here are the top <response.matches.length> matches:
n+1. <response.matches[n].title>
- Price: <response.matches[n].price.extracted_value> <response.matches[n].price.currency>
- Store: <response.matches[n].source>
- Link: <response.matches[n].link>
See all results at https://dupe.com/<whatever-url-the-user-gave-you>
__
____/ /_ ______ ___ _________ ____ ___
/ __ / / / / __ \/ _ \ / ___/ __ \/ __ `__ \
/ /_/ / /_/ / /_/ / __// /__/ /_/ / / / / / /
\__,_/\__,_/ .___/\___(_)___/\____/_/ /_/ /_/
/_/
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.
