Investigación de productos de Etsy

API de consulta de productos de Etsy MCP

Filtrar productos Etsy por palabra clave, URL, precio, ventas, favoritos, comentarios, fecha de la lista, categoría, tipo de producto, y marketplace. Disponible REST API o MCP.

CosteRecent Avg. 85 · Range 10–375 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de consulta 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. Encontrar productos Etsy que coincidan con mis criterios de selección

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta.

2. Investigación en una moneda seleccionada

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Presentar los valores monetarios disponibles [my selected currency], utilizando [my supplied conversion rate] sólo si la herramienta requiere uno. No compare las cantidades en diferentes monedas.

3. Continuar los resultados dentro de un límite de página

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Inicio [my selected page] y retorno [my requested page size] dentro de los límites documentados. Pregunte antes de solicitar otra página y no describa una página como conjunto de datos completo.

4. Priorizar los resultados para la revisión

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Prioridad [my chosen ranking metric] dentro [my chosen order]. Mantenga la clasificación limitada a los filtros seleccionados y el período de presentación de informes.

5. Buscar productos por cuenta favorita

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Mantener los productos dentro [my favorite count range] y resumir los registros coincidentes.

6. Encontrar coincidencias por Favoritos Semanal

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen favorites weekly range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

7. Buscar productos por precio

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Mantener los productos dentro [my price range] y resumir los registros coincidentes.

8. Buscar productos por cuenta de revisión

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Mantener los productos dentro [my review count range] y resumir los registros coincidentes.

9. Encontrar coincidencias por opiniones semanales

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen reviews weekly range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

10. Buscar coincidencias por importe de ventas

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen sales amount range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

11. Buscar productos por ventas semanales

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Mantener los productos dentro [my weekly sales range] y resumir los registros coincidentes.

12. Buscar productos en una categoría de Etsy

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Uso [my selected product category id , see the category query api] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

13. Encontrar Etsy Bestsellers

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Uso [my selected the product is a bestseller] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

14. Buscar artículos de Etsy Pick

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Uso [my selected the product is a pick item] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

15. Buscar Tiendas o Productos Altamente Alabados

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Aplicar [my preference for the raving classification] al revisar los resultados. Resumir sólo los registros devueltos.

16. Buscar Productos Listados recientemente

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Uso [my selected listing time no earlier than this date] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

17. Elija un tipo de producto Etsy

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Encontrar [handmade, vintage, digital, custom or other] productos, utilizando los tipos de productos que seleccione. Resumir sólo los registros devueltos.

18. Buscar productos por estado de lista

Prompt: Encontrar productos Etsy que coincidan con mis criterios de selección para [search phrase] dentro [target marketplace]. Uso [my selected product status (example] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

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_query

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-query-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_etsy_product_query",
    "arguments": {
      "page": 1,
      "pageSize": 20,
      "searchKey": "phone case"
    }
  }
}

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
`beginFavorites`	`integer`	opcional	Conteo favorito (start), combinado con el valor final para formar la gama de favoritos upstream Ejemplo: 1
`beginFavoritesWeekly`	`integer`	opcional	Nuevos favoritos semanales (start), combinado con el valor final para formar la corriente favorites_weekly rango Ejemplo: 1
`beginPrice`	`number`	opcional	Precio (inicio), combinado con el precio final para formar el rango de precio de arriba (e.g., 20~100). Cuando sólo se proporciona un lado, el río arriba devuelve principio~ o ~end Ejemplo: 1
`beginReviews`	`integer`	opcional	Cuenta de revisión (start), combinado con el valor final para formar el rango de revisiones aguas arriba Ejemplo: 1
`beginReviewsWeekly`	`integer`	opcional	Nuevos exámenes semanales (start), combinados con el valor final para formar la corriente reviews_weekly rango Ejemplo: 1
`beginSales`	`integer`	opcional	Total ventas (start), combinado con el valor final para formar el rango de ventas aguas arriba Ejemplo: 1
`beginSalesWeekly`	`integer`	opcional	Ventas semanales (start), combinadas con el valor final para formar la corriente sales_weekly rangoe.g., 1~100) Ejemplo: 1
`category`	`string`	opcional	Categoría de productos ID (categoría única), ver la Consulta de Categoría API
`country`	`string`	opcional	País de origen
`currencyCode`	`string`	opcional	Código de moneda, predeterminado USD Ejemplo: USD
`endFavorites`	`integer`	opcional	Cuenta favorita (fin) Ejemplo: 1
`endFavoritesWeekly`	`integer`	opcional	Nuevos favoritos semanales (fin) Ejemplo: 1
`endPrice`	`number`	opcional	Precio (fin), combinado con el precio inicial para formar la gama de precios de arriba Ejemplo: 1
`endReviews`	`integer`	opcional	Cuenta de revisión (final) Ejemplo: 1
`endReviewsWeekly`	`integer`	opcional	Nuevos exámenes semanales (fin) Ejemplo: 1
`endSales`	`integer`	opcional	Total de ventas (final) Ejemplo: 1
`endSalesWeekly`	`integer`	opcional	Ventas semanales (fin) Ejemplo: 1
`isBestsell`	`integer`	opcional	Ya sea que el producto es un bestseller Ejemplo: 1
`isPick`	`integer`	opcional	Ya sea que el producto sea un elemento Pick Ejemplo: 1
`isRaving`	`integer`	opcional	Ya sea que el producto es un elemento Raving Ejemplo: 1
`listedTime`	`string`	opcional	Hora de enumerar no antes de esta fecha (YYYY-MM-DD)
`page`	`integer`	opcional	Número de página (a partir de 1) Ejemplo: 1
`pageSize`	`integer`	opcional	Artículos por página, predeterminado 20, max 100, recomendado no exceder 50 Ejemplo: 20
`productType`	`string`	opcional	Tipo de producto, separado para varios: 1=Handmade 2=Vintage 3=Digital 4=Custom 9=
`searchKey`	`string`	opcional	Buscar palabra clave o producto Etsy URL
`sortBy`	`integer`	opcional	Campo de clasificación (corresponds to upstream sort_by, valores 1~6) Ejemplo: 1
`sortDesc`	`integer`	opcional	Ordenar dirección (corresponds to upstream desc). Ejemplo de esquema: descendiendo 1, ascendiendo 2 (la codificación difiere de la consulta de la tienda sortDesc) Ejemplo: 1
`status`	`integer`	opcional	Estado del producto (ejemplo: 1=activo, 0=inactivo) Ejemplo: 1

Campos de respuesta

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

Nombre	Tipo	Obligatorio	Descripción
`total`	`integer`	opcional	Número de registros (esta página devuelve el número de registros para facilitar la alineación con la longitud de la lista)
`sourceType`	`string`	opcional	Tipo fuente: etsy
`columns`	`array`	opcional	Rendered columns
`costToken`	`integer`	opcional	Consumo de fichas (estimado sobre la base del número de artículos devueltos en esta página)
`productNum`	`integer`	opcional	Número total de productos elegibles product_num)
`title`	`string`	opcional	Título
`type`	`string`	opcional	Estilo de retroceso
`products`	`array`	opcional	Listado de productos Etsy
`category`	`string`	opcional	Categoría nombre
`favorites`	`integer`	opcional	Número de colecciones
`favoritesWeekly`	`integer`	opcional	Número de nuevos favoritos por semana
`imageUrl`	`string`	opcional	Imagen principal URL
`isBestsell`	`integer`	opcional	Mejor vendedor o no: 1=sí
`isPick`	`integer`	opcional	Ya sea para elegir: 1=Sí
`isRaving`	`integer`	opcional	Ya sea el amor: 1=Sí
`price`	`number`	opcional	precio
`productUrl`	`string`	opcional	Enlace de producto
`releaseTime`	`string`	opcional	Shelf/release tiempo
`reviews`	`integer`	opcional	Número de comentarios
`reviewsWeekly`	`integer`	opcional	Nuevos comentarios por semana
`salesTotal`	`integer`	opcional	ventas totales
`salesWeekly`	`integer`	opcional	Ventas semanales
`shipsFrom`	`string`	opcional	País de origen
`status`	`integer`	opcional	Estado del producto: 1=en los estantes, 0=de los estantes
`storeName`	`string`	opcional	Nombre de la tienda
`tags`	`string`	opcional	etiqueta
`title`	`string`	opcional	Título del producto

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

Encontrar productos Etsy que coincidan con mis criterios de selección. Use “kitchen organizer”.

Respuesta de ejemplo

En la muestra publicada, el primer registro mostrado es “Goldfish Bag Holder Crochet Pattern PDF \u2013 Dispensador de bolsa de plástico colgado, organizador de cocina, instrucciones paso a paso”. Su precio comunicado es 2.21. Sus exámenes notificados son 5. 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

{
  "searchKey": "kitchen organizer",
  "pageSize": 4
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 4,
    "sourceTool": "ehunt_etsy",
    "sourceType": "etsy",
    "columns": [
      {
        "filterable": true,
        "cellType": "text",
        "field": "title",
        "sortable": true,
        "title": "商品标题"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "category",
        "sortable": true,
        "title": "类目名称"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "price",
        "sortable": true,
        "title": "价格"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "status",
        "sortable": true,
        "title": "商品状态：1=上架，0=下架"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "salesWeekly",
        "sortable": true,
        "title": "周销量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "salesTotal",
        "sortable": true,
        "title": "总销量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "reviews",
        "sortable": true,
        "title": "评论数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "favorites",
        "sortable": true,
        "title": "收藏数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "isBestsell",
        "sortable": true,
        "title": "是否畅销：1=是"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "isPick",
        "sortable": true,
        "title": "是否 Pick：1=是"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "isRaving",
        "sortable": true,
        "title": "是否 Raving：1=是"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "tags",
        "sortable": true,
        "title": "标签"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shipsFrom",
        "sortable": true,
        "title": "发货国家"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "releaseTime",
        "sortable": true,
        "title": "上架/发布时间"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "storeName",
        "sortable": true,
        "title": "店铺名称"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "productUrl",
        "sortable": true,
        "title": "商品链接"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "imageUrl",
        "sortable": true,
        "title": "主图 URL"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "reviewsWeekly",
        "sortable": true,
        "title": "周新增评论数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "favoritesWeekly",
        "sortable": true,
        "title": "周新增收藏数"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceType",
        "sortable": true,
        "title": "来源类型：etsy"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceTool",
        "sortable": true,
        "title": "工具类型：ehunt"
      }
    ],
    "productNum": 38375,
    "title": "商品查询",
    "type": "tableListWorkbenches",
    "products": [
      {
        "favorites": 39,
        "releaseTime": "2026-10-04",
        "isRaving": 0,
        "salesTotal": 35,
        "favoritesWeekly": 11,
        "salesWeekly": 16,
        "title": "Goldfish Bag Holder Crochet Pattern PDF \\u2013 Hanging Plastic Bag Dispenser, Kitchen Organizer, Step-by-Step Instructions",
        "isPick": 0,
        "tags": "crochet, bag holder pattern, plastic bag holder, grocery bag holder, bag dispenser, fish crochet pattern",
        "sourceTool": "ehunt_etsy",
        "reviews": 5,
        "isBestsell": 1,
        "sourceType": "etsy",
        "price": 2.21,
        "imageUrl": "https://i.etsystatic.com/27927724/r/il/5e197b/8669214893/il_120xN.8669214893_qgci.jpg",
        "reviewsWeekly": 0,
        "shipsFrom": "United States",
        "storeName": "MinimalistPagesshop",
        "category": "",
        "productUrl": "https://www.etsy.com/listing/4588270304/goldfish-bag-holder-crochet-pattern-pdf",
        "status": 1
      },
      {
        "favorites": 249,
        "releaseTime": "2026-09-09",
        "isRaving": 0,
        "salesTotal": 26,
        "favoritesWeekly": 47,
        "salesWeekly": 13,
        "title": "3D Vegetable Fridge Magnet Set, Miniature Fake Food Decor, Cute Cottagecore Kitchen Pin, Realistic Farmhouse Whiteboard Accessory, 12-pack",
        "isPick": 0,
        "tags": "Vegetable Magnet, 3D Fake Food Magnet, Miniature Veggie Pin, Cottagecore Kitchen, Cute Whiteboard Pin, Farmhouse Desk Art, Realistic Food Decor, Foodie Gift Set, Resin Fridge Magnet, Kitchen Organizer, Mini Pumpkin Garlic, Garden Lover Gift",
        "sourceTool": "ehunt_etsy",
        "reviews": 1,
        "isBestsell": 1,
        "sourceType": "etsy",
        "price": 15.08,
        "imageUrl": "https://i.etsystatic.com/65247252/r/il/4bc2f0/8545845559/il_120xN.8545845559_a0pv.jpg",
        "reviewsWeekly": 0,
        "shipsFrom": "United States",
        "storeName": "IslaMagicHaven",
        "category": "",
        "productUrl": "https://www.etsy.com/listing/4571829107/3d-vegetable-fridge-magnet-set-miniature",
        "status": 1
      },
      {
        "favorites": 292,
        "releaseTime": "2026-08-18",
        "isRaving": 0,
        "salesTotal": 14,
        "favoritesWeekly": 0,
        "salesWeekly": 13,
        "title": "Taco Bell Sauce Packet Organizer with Removable Label and Optional Lid",
        "isPick": 0,
        "tags": "kitchen utensils, chef tool, taco bell, tacos, hot sauce, sauce packet, cooking organizer, snack tray, snack lid, chip tray, sauce boss, get saucy, viva mas",
        "sourceTool": "ehunt_etsy",
        "reviews": 2,
        "isBestsell": 1,
        "sourceType": "etsy",
        "price": 15,
        "imageUrl": "https://i.etsystatic.com/62911095/r/il/039c54/8447680237/il_120xN.8447680237_blgd.jpg",
        "reviewsWeekly": 0,
        "shipsFrom": "United States",
        "storeName": "PlexiPrintsStudio",
        "category": "",
        "productUrl": "https://www.etsy.com/listing/4558253831/taco-bell-sauce-packet-organizer-with",
        "status": 1
      },
      {
        "favorites": 14764,
        "releaseTime": "2024-09-24",
        "isRaving": 0,
        "salesTotal": 787,
        "favoritesWeekly": 107,
        "salesWeekly": 12,
        "title": "Whale spoon rest, Kitchen gift, Kitchen decor, Weird spoon rest, Fish spoon rest, Ceramic spoon rest, Handmade spoon rest, Whale decor",
        "isPick": 0,
        "tags": "kitchen decor, spoon rest, kitchen organizer, ceramic spoon rest, ravioli spoon rest, weird spoon rest, handmade spoon rest, speckled spoon rest, kitchen gift, utensil holder, handmade pottery, egg spoon rest, Whale Fish shark",
        "sourceTool": "ehunt_etsy",
        "reviews": 265,
        "isBestsell": 1,
        "sourceType": "etsy",
        "price": 37,
        "imageUrl": "https://i.etsystatic.com/23081770/r/il/4414d3/6298649494/il_120xN.6298649494_kae9.jpg",
        "reviewsWeekly": 2,
        "shipsFrom": "United States",
        "storeName": "LeilyCloud",
        "category": "",
        "productUrl": "https://www.etsy.com/listing/1799823289/whale-spoon-rest-kitchen-gift-kitchen",
        "status": 1
      }
    ]
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos