Investigación de productos de Shopify

API de consulta de productos de Shopify MCP

Encuentre productos Shopify por palabra clave, precio, ventas y otros filtros de producto. Llame a la consulta de productos Shopify API mediante REST o MCP con tu clave de API de Nexscope.

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

Prompts y casos de uso de API de consulta de productos de Shopify

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 Shopify

Prompt: Encontrar productos Shopify [search phrase] envío a [destination country]. Mostrar los resultados disponibles e identificar claramente la información que falta.

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

Prompt: Encontrar productos Shopify [search phrase] envío a [destination country]. 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.

3. Priorizar los resultados para la revisión

Prompt: Encontrar productos Shopify [search phrase] envío a [destination country]. 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.

4. Buscar productos dentro de un rango de precios

Prompt: Encontrar Shopify productos que coincidan [search phrase] esa nave [destination country] y costo entre [minimum price in USD] y [maximum price in USD]. Resume los productos que coincidan y mantén todos los precios en USD.

5. Encontrar coincidencias por ventas semanales

Prompt: Encontrar productos Shopify [search phrase] envío a [destination country]. Limitación de los resultados [my chosen weekly sales range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

6. Encontrar coincidencias por fecha de lista

Prompt: Encontrar productos Shopify [search phrase] envío a [destination country]. Limitación de los resultados [my chosen listing date range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

7. Encontrar coincidencias por competencia

Prompt: Encontrar productos Shopify [search phrase] envío a [destination country]. Limitación de los resultados [my chosen competition range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

8. Buscar productos con publicidad en Facebook

Prompt: Encontrar productos Shopify [search phrase] envío a [destination country]. Limita la búsqueda según [my Facebook advertising preference]. Informe sólo lo que los registros seleccionados soportan.

9. Buscar productos con información de proveedores

Prompt: Encontrar productos Shopify [search phrase] envío a [destination country]. Limita la búsqueda a los productos con información del proveedor. Informe sólo lo que los registros seleccionados soportan.

10. Revisión Listas eliminadas

Prompt: Encontrar productos Shopify [search phrase] envío a [destination country]. Incluye listados eliminados en la búsqueda para poder distinguirlos de productos activos. 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_shopify_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": "shopify-product-query-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_shopify_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
`searchKey`	`string`	opcional	Palabras clave o Shopify product/store URL
`priceMin`	`number`	opcional	Inicio de rango de precios (USD), combinado con priceMax para formar precio aguas arriba Ejemplo: 1
`priceMax`	`number`	opcional	Fin de rango de precios (USD) Ejemplo: 1
`salesWeeklyMin`	`integer`	opcional	Gama de ventas semanales Ejemplo: 1
`salesWeeklyMax`	`integer`	opcional	Fin del rango de ventas semanales Ejemplo: 1
`publishedTimeBegin`	`string`	opcional	Lista de fecha de inicio
`publishedTimeEnd`	`string`	opcional	Lista de fecha límite
`facebookAd`	`integer`	opcional	Tiene Facebook anuncio: 1=Sí Ejemplo: 1
`competitionMin`	`integer`	opcional	Competición (número de tiendas que venden) Ejemplo: 1
`competitionMax`	`integer`	opcional	Competencia (número de tiendas que venden) gama final Ejemplo: 1
`hasSupplier`	`integer`	opcional	Tiene proveedor: 1=Sí, 0=No Ejemplo: 1
`showDeleted`	`integer`	opcional	Mostrar productos delistados: 1=Sí, 0=No Ejemplo: 1
`country`	`string`	opcional	País de envío (código de dos letras, e.g., US)
`sortBy`	`integer`	opcional	Campo de clasificación (predeterminado 14=Producción de las ventas bajas; también incluye price/ad count/competition/revenue etc. valores, véase la enumeración a continuación) Ejemplo: 14
`page`	`integer`	opcional	Número de página (a partir de 1) Ejemplo: 1
`pageSize`	`integer`	opcional	Resultados por página, predeterminado 20, max 100, recomendado no exceder 50 Ejemplo: 20

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 artículos devueltos en esta página
`productNum`	`integer`	opcional	Número total de artículos elegibles (incorporación `product_num`)
`products`	`array`	opcional	Shopify product list
`columns`	`array`	opcional	Rendered columns
`title`	`string`	opcional	Título`Shopify Product Query`)
`sourceType`	`string`	opcional	Tipo fuente: Shopify
`type`	`string`	opcional	Estilo rendido: tableListWorkbenches
`productId`	`product_id`	opcional	Producto ID
`title`	`-`	opcional	Título del producto
`productLink`	`product_link`	opcional	Enlace de producto
`previewImageUrl`	`preview_image_url`	opcional	Imagen principal URL
`country`	`-`	opcional	País de origen
`minPrice`	`min_price`	opcional	precio más bajo
`maxPrice`	`max_price`	opcional	precio más alto
`storeId`	`store_id`	opcional	Store ID
`shopId`	`shop_id`	opcional	Shopify shop ID
`storeLink`	`store_link`	opcional	Enlace de la tienda
`storeRank`	`store_rank`	opcional	nivel de las tiendas
`competitorCount`	`competitor_count`	opcional	Competencia (número de tiendas en venta)
`facebookAdCount`	`facebook_ad_count`	opcional	Número de anuncios de Facebook
`weekOrderCount`	`week_order_count`	opcional	Ventas semanales
`weekRevenueCount`	`week_revenue_count`	opcional	ventas semanales
`weekRevenueGrowth`	`week_revenue_growth`	opcional	Tasa de crecimiento semanal de ventas (%)
`shelfTime`	`shelf_time`	opcional	Tiempo de estante
`isDeleted`	`is_deleted`	opcional	Ya sea para quitarlo del estante: 0=en el estante, 1= de la estantería
`isFavourite`	`is_favourite`	opcional	¿Lo han recogido?

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

Encuentre productos Shopify por palabra clave, precio, ventas y otros filtros de producto. Use “baby”.

Respuesta de ejemplo

En la muestra publicada, el primer registro mostrado es “Baby Feeding Bottle Covers Pack de 3”. El valor indicado de el país es IN. Su recuento de competidores reportado es 1. 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

{
  "page": 1,
  "pageSize": 5,
  "searchKey": "baby",
  "sortBy": 14
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 5,
    "sourceTool": "ehunt_shopify",
    "sourceType": "shopify",
    "columns": [
      {
        "filterable": true,
        "cellType": "text",
        "field": "productId",
        "sortable": true,
        "title": "商品 ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "title",
        "sortable": true,
        "title": "商品标题"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "productLink",
        "sortable": true,
        "title": "商品链接"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "previewImageUrl",
        "sortable": true,
        "title": "商品主图 URL"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "country",
        "sortable": true,
        "title": "发货国家"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "minPrice",
        "sortable": true,
        "title": "最低价格（USD）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "maxPrice",
        "sortable": true,
        "title": "最高价格（USD）"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "storeId",
        "sortable": true,
        "title": "店铺 ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopId",
        "sortable": true,
        "title": "商店 ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "storeLink",
        "sortable": true,
        "title": "店铺链接"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "storeRank",
        "sortable": true,
        "title": "店铺等级"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "competitorCount",
        "sortable": true,
        "title": "竞争度（同类店铺数量）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "facebookAdCount",
        "sortable": true,
        "title": "Facebook 广告数量"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "weekOrderCount",
        "sortable": true,
        "title": "周销量（格式化字符串，如 1,234）"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "weekRevenueCount",
        "sortable": true,
        "title": "周销售额（格式化字符串）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "weekRevenueGrowth",
        "sortable": true,
        "title": "周销售额增长率（%）"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shelfTime",
        "sortable": true,
        "title": "上架时间"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "isDeleted",
        "sortable": true,
        "title": "是否下架：0=上架，1=下架"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "isFavourite",
        "sortable": true,
        "title": "是否已收藏"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceType",
        "sortable": true,
        "title": "来源类型：shopify"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceTool",
        "sortable": true,
        "title": "工具类型：ehunt"
      }
    ],
    "productNum": 65977,
    "title": "Shopify 商品查询",
    "type": "tableListWorkbenches",
    "products": [
      {
        "country": "IN",
        "competitorCount": 1,
        "productId": "368801967",
        "facebookAdCount": 47,
        "weekOrderCount": "6,383",
        "shelfTime": "2025-09-30",
        "title": "Baby Feeding Bottle Covers Pack of 3",
        "storeId": "5863728",
        "weekRevenueGrowth": 0,
        "storeLink": "superbottoms.com",
        "weekRevenueCount": "39,638",
        "sourceTool": "ehunt_shopify",
        "isDeleted": 0,
        "storeRank": "1",
        "sourceType": "shopify",
        "previewImageUrl": "https://cdn.shopify.com/s/files/1/0402/7370/7171/files/1_8780f6c9-db5c-4e07-8ff3-00f62bc2c3d3.webp?v=1759228144",
        "minPrice": 6.21,
        "productLink": "https://superbottoms.com/products/baby-bottle-cover-for-feeding-bottles-pack-of-3",
        "maxPrice": 0,
        "shopId": "5863728",
        "isFavourite": 0
      },
      {
        "country": "IN",
        "competitorCount": 1,
        "productId": "367917024",
        "facebookAdCount": 533,
        "weekOrderCount": "1,908",
        "shelfTime": "2023-03-29",
        "title": "Plant Powered Laundry Detergent for Babies & Adults - 200ml",
        "storeId": "5263201",
        "weekRevenueGrowth": 0,
        "storeLink": "mothersparsh.com",
        "weekRevenueCount": "2,976",
        "sourceTool": "ehunt_shopify",
        "isDeleted": 0,
        "storeRank": "2",
        "sourceType": "shopify",
        "previewImageUrl": "https://cdn.shopify.com/s/files/1/0257/2091/3991/files/Plant-Powered-Baby-Laundry-Detergent-Best-baby-laundry-detergent-In-India-200ml-1.webp?v=1712037716",
        "minPrice": 1.56,
        "productLink": "https://mothersparsh.com/products/plant-powered-laundry-detergent-for-babies-travel-pack",
        "maxPrice": 0,
        "shopId": "5263201",
        "isFavourite": 0
      },
      {
        "country": "GB",
        "competitorCount": 1,
        "productId": "360154769",
        "facebookAdCount": 43,
        "weekOrderCount": "1,316",
        "shelfTime": "2025-02-13",
        "title": "BioGaia Aldermis BABY Ointment",
        "storeId": "6367030",
        "weekRevenueGrowth": 0,
        "storeLink": "uk.biogaia.com",
        "weekRevenueCount": "43,520",
        "sourceTool": "ehunt_shopify",
        "isDeleted": 0,
        "storeRank": "1",
        "sourceType": "shopify",
        "previewImageUrl": "https://cdn.shopify.com/s/files/1/0592/0682/8220/files/Aldermis_UK_535b0547-52a8-4052-bd76-4f85704ff9ed.png?v=1790085319",
        "minPrice": 33.07,
        "productLink": "https://uk.biogaia.com/products/aldermis",
        "maxPrice": 0,
        "shopId": "6367030",
        "isFavourite": 0
      },
      {
        "country": "US",
        "competitorCount": 1,
        "productId": "371583587",
        "facebookAdCount": 748,
        "weekOrderCount": "1,181",
        "shelfTime": "2025-04-08",
        "title": "Dirty Martini Baby Tee",
        "storeId": "6423970",
        "weekRevenueGrowth": 0,
        "storeLink": "threadheads.com",
        "weekRevenueCount": "37,792",
        "sourceTool": "ehunt_shopify",
        "isDeleted": 0,
        "storeRank": "17",
        "sourceType": "shopify",
        "previewImageUrl": "https://cdn.shopify.com/s/files/1/0045/7349/5389/files/DrinkCapsule-16.jpg?v=1747390071",
        "minPrice": 32,
        "productLink": "http://threadheads.com/products/dirty-martini-crop-tee",
        "maxPrice": 0,
        "shopId": "6423970",
        "isFavourite": 0
      },
      {
        "country": "US",
        "competitorCount": 1,
        "productId": "350051559",
        "facebookAdCount": 165,
        "weekOrderCount": "972",
        "shelfTime": "2024-06-20",
        "title": "Skin Brightening Baby Ubtan",
        "storeId": "6339999",
        "weekRevenueGrowth": 0,
        "storeLink": "omumsie.com",
        "weekRevenueCount": "4,811",
        "sourceTool": "ehunt_shopify",
        "isDeleted": 0,
        "storeRank": "31",
        "sourceType": "shopify",
        "previewImageUrl": "https://cdn.shopify.com/s/files/1/0565/7503/3504/files/skin-brightening-baby-ubtan-ayurvedic..jpg?v=1740479329",
        "minPrice": 4.95,
        "productLink": "https://omumsie.com/products/skin-brightening-baby-ubtan",
        "maxPrice": 14.13,
        "shopId": "6339999",
        "isFavourite": 0
      }
    ]
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos