Etsy Product Research
Etsy Product Detail MCP
Retrieve public Etsy listing details from a validated marketplace URL for product, pricing, shop, and competitive research. Available via REST API or MCP.
Etsy Product Detail AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Inspect An Etsy Product Listing
Prompt: Inspect an Etsy product listing for [product link]. Show the available results and clearly identify missing information.
2. Review Etsy Listing Content
Prompt: Inspect an Etsy product listing for [product link]. Show the available results and clearly identify missing information. Extract the title, description, images and highlight tags into a listing-content brief. Separate quoted facts from suggested improvements and do not invent specifications.
3. Inspect Etsy Shop Trust Signals
Prompt: Inspect an Etsy product listing for [product link]. Show the available results and clearly identify missing information. Summarize shop age, sales, review indicators and available badges. Preserve source scope and do not treat a badge as a guarantee about this product.
4. Inspect Etsy Variants And Fulfillment Context
Prompt: Inspect an Etsy product listing for [product link]. Show the available results and clearly identify missing information. Show the returned variants, maximum quantity, shipping origin and currency. Do not infer delivery dates, shipping cost or unavailable variant prices.
What You Need to Provide
Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.
Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_etsy_product_detailhttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "etsy-product-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_etsy_product_detail",
"arguments": {
"productUrl": "https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
productUrl | string | required | HTTPS Etsy listing URL containing a numeric listing ID Example: https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
errcode | integer | optional | Business status code; `200` indicates success |
errmsg | string | optional | Business status message; `ok` on success |
data | array | optional | Array of product objects; fixed to 1 item when successful |
total | integer | optional | Fixed to `1` when successful |
costToken | integer | optional | Consume token |
type | string | optional | Fixed to `tableListWorkbenches` |
columns | array | optional | Rendering column definition generated based on product top-level fields |
productId | string | optional | Etsy listing ID |
shopId | string | optional | Store ID |
shopUrl | string | optional | Store URL; it may be empty or misidentified when the page is abnormal. |
shopSales | string | optional | Store public sales text |
shopName | string | optional | Store name; it may be empty or misidentified when the page is abnormal. |
productUrl | string | optional | Product URL |
searchPosition | string | optional | Source search location; usually empty for direct queries |
image | string | optional | Main image URL |
images | array | optional | Image URL list |
maxQuantity | integer | optional | Maximum available quantity reported on the page |
variants | array | optional | Product variations; empty array if no variations |
title | string | optional | Product title |
description | array | optional | list of description paragraphs |
shopReviews | integer | optional | Number of store reviews |
reviews | integer | optional | Current number of listing comments |
star | string | optional | Current rating, may be an empty string |
highlightsTags | array | optional | Buyer Feedback Highlights Tag |
reviewsTags | array | optional | Comment tags and frequency objects |
yearsOnEtsy | string | optional | How long your store has been public on Etsy |
hasRatingsBadge | boolean | optional | Is there a rating badge? |
hasConvosBadge | boolean | optional | Is there a communication badge? |
hasShippingBadge | boolean | optional | Is there a delivery badge? |
reviewsScores | object | optional | Dynamic review itemization; keys and values change from page to page |
category | string | optional | Category breadcrumbs |
countryShippingFrom | string | optional | Shipping country/region |
currency | string | optional | currency code |
moreLikeUrl | string | optional | Similar recommendation link, may be empty |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Inspect an Etsy product listing.
Example Answer
In the published sample, the first shown record is “Black Skull Lace Trim: 35mm Gothic Halloween Decor by the yard or wholesale”. Its reported reviews is 37. Its reported max quantity is 10. These observations apply only to the shown record and reporting scope.
About this sample: Published documentation excerpt, not a live query. Arrays show at most two records and long text may be shortened. Missing units, dates or coverage remain unspecified; the excerpt does not represent the complete dataset.
View the Published Sample Data (JSON)
Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.
Data Example
Sample request and response
Request parameters
{
"productUrl": "https://www.etsy.com/listing/4309946455/black-skull-lace-trim-35mm-gothic"
}Response
{
"code": 0,
"msg": null,
"data": {
"total": 1,
"data": [
{
"maxQuantity": 10,
"reviewsScores": {
"love_it": "5.0",
"helpful_seller": "100%",
"fast_delivery": "5.0",
"great_quality": "5.0",
"as_described": "What buyers say, summarised by AI:"
},
"deliveryDaysMax": 12,
"shopName": "shadow.bc8764b664a75d.css",
"description": [
"Highlights",
":host(:not(:defined)) {opacity: 1 !important;}*, *::before, *::after {box-sizing: inherit;}svg {display: block;fill: var(--clg-icon-fill-color, currentColor);height: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));width: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));aspect-ratio: 1;}",
"Sourced by",
"Lindacustom",
":host(:not(:defined)) {opacity: 1 !important;}*, *::before, *::after {box-sizing: inherit;}svg {display: block;fill: var(--clg-icon-fill-color, currentColor);height: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));width: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));aspect-ratio: 1;}",
"Supplies for making crafts",
":host(:not(:defined)) {opacity: 1 !important;}*, *::before, *::after {box-sizing: inherit;}svg {display: block;fill: var(--clg-icon-fill-color, currentColor);height: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));width: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));aspect-ratio: 1;}",
"Read the full description",
"Materials: polyester",
"This good quality skull lace can be use for Halloween design, decor and other project. When order 2 yares or more you will get it at one piece, over 14 yards you will get 2 pieces.",
"Width: about 35mm wide",
"Length: 1yard,5 yard,14.5 yard"
],
"variants": [],
"title": "Black Skull Lace Trim: 35mm Gothic Halloween Decor by the yard or wholesale",
"reviewsTags": [
{},
{},
{},
{},
{}
],
"shopReviews": 1261,
"reviews": 37,
"lowPrice": "",
"deliveryDaysMin": 11,
"price": "",
"highPrice": "",
"currency": "USD",
"shopId": "19023055",
"shopSales": "",
"image": "https://i.etsystatic.com/19023055/r/il/866080/6932975567/il_fullxfull.6932975567_58r3.jpg",
"images": [
"https://i.etsystatic.com/19023055/r/il/866080/6932975567/il_fullxfull.6932975567_58r3.jpg",
"https://i.etsystatic.com/19023055/r/il/4ad67a/6884997320/il_fullxfull.6884997320_q6bj.jpg",
"https://i.etsystatic.com/19023055/r/il/ccd71a/6932975369/il_fullxfull.6932975369_4skb.jpg",
"https://i.etsystatic.com/19023055/r/il/8d56af/6932975425/il_fullxfull.6932975425_f3kt.jpg",
"https://i.etsystatic.com/19023055/r/il/f2aea1/6932974989/il_fullxfull.6932974989_48yj.jpg",
"https://i.etsystatic.com/19023055/r/il/f860c7/6932975535/il_fullxfull.6932975535_gfs4.jpg",
"https://i.etsystatic.com/19023055/r/il/9aa87f/6932975363/il_fullxfull.6932975363_odxu.jpg",
"https://i.etsystatic.com/19023055/r/il/7667f2/6884997800/il_fullxfull.6884997800_1de2.jpg",
"https://i.etsystatic.com/19023055/r/il/68d0fb/6884997838/il_fullxfull.6884997838_ly95.jpg",
"https://i.etsystatic.com/19023055/r/il/1a3b34/6884997852/il_fullxfull.6884997852_k2sf.jpg"
],
"moreLikeUrl": "",
"hasConvosBadge": true,
"productId": "4309946455",
"star": "",
"oldPrice": "",
"hasRatingsBadge": true,
"searchPosition": "",
"shopUrl": "https://www.etsy.com/ac/sasquatch/css/collage/shadow.bc8764b664a75d.css",
"highlightsTags": [
"Looks great",
"As described",
"Love it",
"Fast shipping",
"Great quality",
"Helpful seller",
"Well packaged"
],
"hasShippingBadge": true,
"countryShippingFrom": "CN",
"yearsOnEtsy": "7 years",
"productUrl": "https://www.etsy.com/listing/4309946455/black-skull-lace-trim-35mm-gothic",
"category": "Craft Supplies & Tools < Fabric & Notions < Lace & Trims"
}
],
"columns": [
{
"filterable": true,
"cellType": "text",
"field": "productId",
"sortable": true,
"title": "商品 ID"
},
{
"filterable": true,
"cellType": "text",
"field": "shopId",
"sortable": true,
"title": "店铺 ID"
},
{
"filterable": true,
"cellType": "text",
"field": "shopUrl",
"sortable": true,
"title": "店铺链接"
},
{
"filterable": true,
"cellType": "text",
"field": "shopSales",
"sortable": true,
"title": "店铺销量文本"
},
{
"filterable": true,
"cellType": "text",
"field": "shopName",
"sortable": true,
"title": "店铺名称"
},
{
"filterable": true,
"cellType": "text",
"field": "productUrl",
"sortable": true,
"title": "商品链接"
},
{
"filterable": true,
"cellType": "text",
"field": "searchPosition",
"sortable": true,
"title": "搜索位置"
},
{
"filterable": true,
"cellType": "text",
"field": "image",
"sortable": true,
"title": "主图链接"
},
{
"filterable": true,
"cellType": "text",
"field": "images",
"sortable": true,
"title": "商品图片列表"
},
{
"filterable": true,
"cellType": "number",
"field": "maxQuantity",
"sortable": true,
"title": "最大可购数量"
},
{
"filterable": true,
"cellType": "text",
"field": "variants",
"sortable": true,
"title": "商品变体"
},
{
"filterable": true,
"cellType": "text",
"field": "title",
"sortable": true,
"title": "商品标题"
},
{
"filterable": true,
"cellType": "text",
"field": "description",
"sortable": true,
"title": "商品描述段落"
},
{
"filterable": true,
"cellType": "number",
"field": "deliveryDaysMin",
"sortable": true,
"title": "最短配送天数"
},
{
"filterable": true,
"cellType": "number",
"field": "deliveryDaysMax",
"sortable": true,
"title": "最长配送天数"
},
{
"filterable": true,
"cellType": "number",
"field": "shopReviews",
"sortable": true,
"title": "店铺评论数"
},
{
"filterable": true,
"cellType": "number",
"field": "reviews",
"sortable": true,
"title": "商品评论数"
},
{
"filterable": true,
"cellType": "text",
"field": "star",
"sortable": true,
"title": "商品评分"
},
{
"filterable": true,
"cellType": "text",
"field": "highlightsTags",
"sortable": true,
"title": "评论亮点标签"
},
{
"filterable": true,
"cellType": "text",
"field": "reviewsTags",
"sortable": true,
"title": "评论主题统计"
},
{
"filterable": true,
"cellType": "text",
"field": "yearsOnEtsy",
"sortable": true,
"title": "入驻 Etsy 年限"
},
{
"filterable": true,
"cellType": "text",
"field": "hasRatingsBadge",
"sortable": true,
"title": "是否有评分徽章"
},
{
"filterable": true,
"cellType": "text",
"field": "hasConvosBadge",
"sortable": true,
"title": "是否有沟通徽章"
},
{
"filterable": true,
"cellType": "text",
"field": "hasShippingBadge",
"sortable": true,
"title": "是否有配送徽章"
},
{
"filterable": true,
"cellType": "text",
"field": "reviewsScores",
"sortable": true,
"title": "动态评论评分摘要"
},
{
"filterable": true,
"cellType": "text",
"field": "category",
"sortable": true,
"title": "商品分类路径"
},
{
"filterable": true,
"cellType": "text",
"field": "price",
"sortable": true,
"title": "商品价格"
},
{
"filterable": true,
"cellType": "text",
"field": "lowPrice",
"sortable": true,
"title": "最低价格"
},
{
"filterable": true,
"cellType": "text",
"field": "highPrice",
"sortable": true,
"title": "最高价格"
},
{
"filterable": true,
"cellType": "text",
"field": "countryShippingFrom",
"sortable": true,
"title": "发货国家或地区"
},
{
"filterable": true,
"cellType": "text",
"field": "currency",
"sortable": true,
"title": "货币代码"
},
{
"filterable": true,
"cellType": "text",
"field": "oldPrice",
"sortable": true,
"title": "原价"
},
{
"filterable": true,
"cellType": "text",
"field": "moreLikeUrl",
"sortable": true,
"title": "相似商品链接"
}
],
"type": "tableListWorkbenches"
}
}View the MCP Request & Response Format
Examples
Based on a published documentation sample, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "etsy-product-detail-example",
"method": "tools/call",
"params": {
"name": "nexscope_etsy_product_detail",
"arguments": {
"productUrl": "https://www.etsy.com/listing/4309946455/black-skull-lace-trim-35mm-gothic"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "etsy-product-detail-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"reviews\":37,\"title\":\"Black Skull Lace Trim: 35mm Gothic Halloween Decor by the yard or wholesale\",\"productId\":\"4309946455\",\"price\":\"\",\"maxQuantity\":10,\"reviewsScores\":{\"love_it\":\"5.0\",\"helpful_seller\":\"100%\",\"fast_delivery\":\"5.0\",\"great_quality\":\"5.0\",\"as_described\":\"What buyers say, summarised by AI:\"},\"deliveryDaysMax\":12,\"shopName\":\"shadow.bc8764b664a75d.css\",\"description\":[\"Highlights\",\":host(:not(:defined)) {opacity: 1 !important;}*, *::before, *::after {box-sizing: inherit;}svg {display: block;fill: var(--clg-icon-fill-color, currentColor);height: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));width: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));aspect-ratio: 1;}\"],\"variants\":[],\"reviewsTags\":[{},{}],\"shopReviews\":1261}],\"total\":1}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"reviews": 37,
"title": "Black Skull Lace Trim: 35mm Gothic Halloween Decor by the yard or wholesale",
"productId": "4309946455",
"price": "",
"maxQuantity": 10,
"reviewsScores": {
"love_it": "5.0",
"helpful_seller": "100%",
"fast_delivery": "5.0",
"great_quality": "5.0",
"as_described": "What buyers say, summarised by AI:"
},
"deliveryDaysMax": 12,
"shopName": "shadow.bc8764b664a75d.css",
"description": [
"Highlights",
":host(:not(:defined)) {opacity: 1 !important;}*, *::before, *::after {box-sizing: inherit;}svg {display: block;fill: var(--clg-icon-fill-color, currentColor);height: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));width: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));aspect-ratio: 1;}"
],
"variants": [],
"reviewsTags": [
{},
{}
],
"shopReviews": 1261
}
],
"total": 1
}
},
"isError": false
}
}