Investigación de productos de Etsy

API de detalles de productos de Etsy MCP

Recuperar públicos Etsy listado detalles de un mercado validado URL para productos, precios, tienda e investigación competitiva. Disponible REST API o MCP.

CosteRecent 11 crédito por llamadaPrueba en línea

Prompts y casos de uso de API de detalles de productos de Etsy

Después de conectar esta herramienta MCP a tu asistente de IA, puedes plantear las preguntas siguientes. Sustituye los marcadores entre corchetes por tus datos y usa los valores admitidos en Argumentos.

¿Es tu primera vez con Nexscope MCP? Sigue la guía de conexión, y después usa los prompts siguientes. Las pestañas Integración y Parámetros y respuesta contienen los pasos de conexión, un ejemplo de llamada y la referencia técnica.

1. Inspeccione una lista de productos Etsy

Prompt: Inspeccione un listado de productos Etsy [product link]. Mostrar los resultados disponibles e identificar claramente la información que falta.

2. Revisión Etsy Listar Contenido

Prompt: Inspeccione un listado de productos Etsy [product link]. Mostrar los resultados disponibles e identificar claramente la información que falta. Extraiga el título, descripción, imágenes y resaltar las etiquetas en un resumen de contenido. Separar hechos citados de mejoras sugeridas y no inventar especificaciones.

3. Examinar las señales de confianza de una tienda Etsy

Prompt: Inspeccione un listado de productos Etsy [product link]. Mostrar los resultados disponibles e identificar claramente la información que falta. Resumir la edad de las tiendas, las ventas, los indicadores de revisión y las insignias disponibles. Conserva el alcance de la fuente y no interpretes una insignia como garantía sobre este producto.

4. Examinar variantes y datos de cumplimiento en Etsy

Prompt: Inspeccione un listado de productos Etsy [product link]. Mostrar los resultados disponibles e identificar claramente la información que falta. Mostrar las variantes devueltas, cantidad máxima, origen de envío y moneda. No inferir fechas de entrega, costo de envío o precios de variante no disponibles.

Qué debes proporcionar

Sustituye las entradas entre corchetes por tus propios valores. Usa únicamente los mercados, períodos y formatos de entrada documentados.

Las estimaciones y clasificaciones devueltas corresponden a los datos y al período seleccionados. Un valor ausente no equivale a cero y una página de resultados no representa todo el mercado.

Paso 1 · Conectar

Conecta tu asistente de IA

Conecta un cliente MCP compatible a Nexscope y selecciona esta herramienta en tu asistente. Completa la autenticación en la configuración de conexión del cliente.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json

Autenticación

Usa el código de autorización OAuth 2.1 con PKCE y el ámbito mcp:tools. Las claves de API siguen siendo una opción de compatibilidad admitida.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

¿Usas una clave de API? Obtén tu clave en Acceso a la API e inclúyela en el encabezado Authorization que se muestra arriba.

Llamar a esta herramienta MCP

Nombre de la herramienta MCP

nexscope_etsy_product_detail

Punto de conexión MCP

https://api.nexscope.ai/mcp

Método JSON-RPC

tools/call

Inicializa una sesión HTTP Streamable MCP 2025-11-25 en https://api.nexscope.ai/mcp y después usa 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 HTTP

La respuesta SSE del POST inicial comunica el progreso. El flujo SSE por GET transmite notificaciones; si se restablece la conexión, consulta la tarea asíncrona existente en vez de enviarla de nuevo.

Argumentos

Nombre	Tipo	Obligatorio	Descripción
`productUrl`	`string`	obligatorio	HTTPS Etsy listado URL contiene un listado numérico ID Ejemplo: https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt

Campos de respuesta

Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.

Nombre	Tipo	Obligatorio	Descripción
`errcode`	`integer`	opcional	Código de estado de las empresas; `200` indica que el éxito
`errmsg`	`string`	opcional	Mensaje del estado de las empresas; `ok` sobre el éxito
`data`	`array`	opcional	Array of product objects; fixed to 1 item when successful
`total`	`integer`	opcional	Corregido `1` cuando tenga éxito
`costToken`	`integer`	opcional	Consume token
`type`	`string`	opcional	Corregido `tableListWorkbenches`
`columns`	`array`	opcional	Definición de columna de rendering generada basada en campos de alto nivel de producto
`productId`	`string`	opcional	Etsy listado ID
`shopId`	`string`	opcional	Store ID
`shopUrl`	`string`	opcional	Store URL; puede estar vacío o mal identificado cuando la página es anormal.
`shopSales`	`string`	opcional	Almacene texto de ventas públicas
`shopName`	`string`	opcional	Nombre de la tienda; puede estar vacío o mal identificado cuando la página es anormal.
`productUrl`	`string`	opcional	Producto URL
`searchPosition`	`string`	opcional	Localización de búsqueda de fuentes; generalmente vacía para consultas directas
`image`	`string`	opcional	Imagen principal URL
`images`	`array`	opcional	Imagen URL lista
`maxQuantity`	`integer`	opcional	Cantidad máxima disponible en la página
`variants`	`array`	opcional	Variaciones de productos; matriz vacía si no hay variaciones
`title`	`string`	opcional	Título del producto
`description`	`array`	opcional	lista de párrafos de la descripción
`shopReviews`	`integer`	opcional	Número de opiniones de la tienda
`reviews`	`integer`	opcional	Número actual de comentarios
`star`	`string`	opcional	Valoración actual, puede ser una cadena vacía
`highlightsTags`	`array`	opcional	Tag
`reviewsTags`	`array`	opcional	Etiquetas de comentarios y objetos de frecuencia
`yearsOnEtsy`	`string`	opcional	¿Cuánto tiempo llevas en Etsy?
`hasRatingsBadge`	`boolean`	opcional	¿Hay una placa de clasificación?
`hasConvosBadge`	`boolean`	opcional	¿Hay una placa de comunicación?
`hasShippingBadge`	`boolean`	opcional	¿Hay una placa de entrega?
`reviewsScores`	`object`	opcional	Especificaciones de revisión dinámica; claves y valores cambian de página a página
`category`	`string`	opcional	Categoría de migas de pan
`countryShippingFrom`	`string`	opcional	Envío country/region
`currency`	`string`	opcional	código de divisas
`moreLikeUrl`	`string`	opcional	Enlace de recomendación similar, puede estar vacío

Preguntas y respuestas de ejemplo

Se basa en una muestra de la documentación publicada, no en una llamada en vivo a la herramienta.

Tu pregunta

Inspeccione un listado de productos Etsy.

Respuesta de ejemplo

En la muestra publicada, el primer registro que se muestra es “Black Skull Lace Trim: 35mm Gothic Halloween Decor por el patio o por mayor”. Sus exámenes notificados son 37. Su cantidad máxima reportada es 10. Estas observaciones se aplican únicamente al ámbito de registro y presentación de informes mostrados.

Sobre esta muestra: Extracto de la documentación publicada, no de una consulta en vivo. Las listas muestran como máximo dos registros y algunos textos largos pueden estar abreviados. Si faltan unidades, fechas o datos sobre la cobertura, el extracto no permite determinarlos ni representa el conjunto de datos completo.

Ver los datos de ejemplo publicados (JSON)

Ejemplo de datos REST publicado. Para llamar a esta herramienta, consulta los argumentos MCP en Parámetros y respuesta.

Ejemplo de datos

Ejemplo de solicitud y respuesta

Parámetros de solicitud

{
  "productUrl": "https://www.etsy.com/listing/4309946455/black-skull-lace-trim-35mm-gothic"
}

Respuesta

{
  "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"
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos