back
loading skill details...
Uses dupe.com APIs in order to find similar products for the product found in the input URL given by the user.
---
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 <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 <whatever-url-the-user-gave-you> 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.
don't have the plugin yet? install it then click "run inline in claude" again.