Investigación de productos de Shopify
API de consulta de tiendas de Shopify MCP
Encontrar Tiendaify stores by country, product range, sales, and audience size. Llame a la consulta Shopify Store API mediante REST o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de consulta de tiendas 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 Tiendaify Stores
Prompt: Encontrar Tiendaify Tiendas para [search phrase] dentro [target marketplace]. 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 Tiendaify Tiendas 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.
3. Priorizar los resultados para la revisión
Prompt: Encontrar Tiendaify Tiendas 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. Para esta selección, elija el recuento de productos, cuenta de categoría, visitas mensuales, seguidores de Facebook, seguidores de Instagram, conteo de anuncios, pedidos relevantes o mensuales.
4. Encontrar coincidencias por cuenta de producto
Prompt: Encontrar Tiendaify Tiendas para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen product count range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
5. Encontrar coincidencias por cuenta de anuncios
Prompt: Encontrar Tiendaify Tiendas para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen ad count range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
6. Encontrar coincidencias por visitas mensuales
Prompt: Encontrar Tiendaify Tiendas para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen monthly visits range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
7. Encontrar coincidencias por pedidos mensuales
Prompt: Encontrar Tiendaify Tiendas para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen monthly orders range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
8. Investigar tiendas según su antigüedad
Prompt: Encuentra tiendas que coincidan [search phrase] dentro [target marketplace] con [my selected store age]. Elija la banda de edad apoyada: menos de un año, uno a dos años, dos a tres años, o más de tres años. Resume las tiendas que coinciden.
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/jsonAutenticació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
nexscope_shopify_store_queryhttps://api.nexscope.ai/mcptools/callInicializa 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-store-query-1",
"method": "tools/call",
"params": {
"name": "nexscope_shopify_store_query",
"arguments": {
"page": 1,
"pageSize": 20,
"searchKey": "phone case"
}
}
}MCP 2025-11-25 · Streamable HTTPLa 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 | Nombre de la tienda o palabra clave de dominio |
country | string | opcional | Código del país (e.g., US, CN) |
year | integer | opcional | Año de creación de la tienda: 1=Último 1 año, 2=1~2 años, 3=2~3 años, 4=3+ años Ejemplo: 1 |
productNumMin | integer | opcional | Catálogo de productos de inicio Ejemplo: 1 |
productNumMax | integer | opcional | Punto de cuenta del producto Ejemplo: 1 |
advertiseCountMin | integer | opcional | Inicio de la cuenta de anuncios Ejemplo: 1 |
advertiseCountMax | integer | opcional | Fin de rango de cuenta Ejemplo: 1 |
monthlyVisitMin | integer | opcional | Curso de visitas mensuales Ejemplo: 1 |
monthlyVisitMax | integer | opcional | Final de las visitas mensuales Ejemplo: 1 |
monthOrderMin | integer | opcional | Inicio de pedidos mensuales Ejemplo: 1 |
monthOrderMax | integer | opcional | Finalización de pedidos mensuales Ejemplo: 1 |
sortBy | integer | opcional | Campo de clasificación: 0=Conteo de producto, 1=Conteo deCategoría, 2=Visitas mensuales, 3=FB seguidores, 4=Ins seguidores, 5=Conteo de anuncios, 6=Relevancia, 7=Mes (por defecto) Ejemplo: 7 |
orderBy | string | opcional | Dirección: desc (default) / asc Ejemplo: desc |
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 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 |
storeNum | integer | opcional | Número total de tiendas elegibles (recurso `store_num`) |
stores | array | opcional | Lista de tiendas |
columns | array | opcional | Rendered columns |
title | string | opcional | Título`Shopify store query`) |
sourceType | string | opcional | Tipo fuente: Shopify |
type | string | opcional | Estilo rendido: tableListWorkbenches |
storeId | `store_id` | opcional | Store ID |
shopId | `shop_id` | opcional | Shopify shop ID |
storeName | `store_name` | opcional | Nombre de la tienda |
storeDomain | `store_domain` | opcional | Nombre de dominio de la tienda |
storeLink | `store_link` | opcional | Enlace de la tienda |
country | - | opcional | país |
createdTime | `created_time` | opcional | tiempo de creación |
productNum | `product_num` | opcional | Número de productos |
categoryNum | `category_num` | opcional | Número de categorías |
categories | - | opcional | Lista de categorías (los elementos incluyen `id`, `name`) |
monthlyVisit | `monthly_visit` | opcional | Visitas mensuales (formateadas) |
monthOrderNum | `month_order_num` | opcional | Volumen de pedido mensual (formato) |
fbFollowers | `fb_followers` | opcional | Número de fans de Facebook |
insFollowers | `ins_followers` | opcional | seguidores de Instagram |
advertiseCount | `advertise_count` | opcional | Número de anuncios |
adLink | `ad_link` | opcional | Enlace de biblioteca |
email | - | opcional | Correo electrónico de contacto |
facebookUrl | `facebook_url` | opcional | Página de inicio de Facebook |
instagramUrl | `instagram_url` | opcional | Página principal de Instagram |
socialLinks | `social_links` | opcional | Social Media Links (Map) |
globalRank | `global_rank` | opcional | clasificación mundial |
logo | - | opcional | Logo Store URL |
availableStatus | `available_status` | opcional | Es activo: 1=activo |
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 Tiendaify stores by country, product range, sales, and audience size. Use “allbirds.com”.
Respuesta de ejemplo
En la muestra publicada, su total reportado es 1. Su num de la tienda reportada 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
{
"searchKey": "allbirds.com",
"page": 1,
"pageSize": 10
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"total": 1,
"sourceTool": "ehunt",
"sourceType": "shopify",
"stores": [
{
"categoryNum": 9,
"globalRank": "",
"country": "US",
"socialLinks": {
"youtube": "https://www.youtube.com/channel/UCnGErLCau5qNJ0Xwe6uEyTw",
"twitter": "https://twitter.com/allbirds",
"tiktok": "https://www.tiktok.com/@weareallbirds",
"facebook": "https://www.facebook.com/weareallbirds",
"pinterest": "http://pinterest.com/weareallbirds",
"instagram": "https://www.instagram.com/allbirds"
},
"storeDomain": "allbirds.com",
"productNum": 692,
"storeId": "5852578",
"fbFollowers": "0",
"monthOrderNum": "5.6k",
"storeLink": "https://allbirds.com",
"facebookUrl": "https://www.facebook.com/1096859176844485",
"availableStatus": 1,
"adLink": "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=ALL&view_all_page_id=1096859176844485&sort_data[direction]=desc&sort_data[mode]=relevancy_monthly_grouped",
"createdTime": "2002-01-09",
"advertiseCount": 247,
"logo": "https://www.allbirds.com/cdn/shop/files/favicon.png?v=1719584207",
"storeName": "The World’s Most Comfortable Shoes",
"instagramUrl": "https://www.instagram.com/allbirds",
"shopId": "11044168",
"categories": [
{
"name": "5",
"id": "5"
}
],
"monthlyVisit": "6250.0k",
"email": "help@allbirds.com",
"insFollowers": "0"
}
],
"columns": [
{
"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": "storeName",
"sortable": true,
"title": "店铺名称"
},
{
"filterable": true,
"cellType": "text",
"field": "storeDomain",
"sortable": true,
"title": "店铺域名"
},
{
"filterable": true,
"cellType": "text",
"field": "storeLink",
"sortable": true,
"title": "店铺链接"
},
{
"filterable": true,
"cellType": "text",
"field": "country",
"sortable": true,
"title": "国家名称"
},
{
"filterable": true,
"cellType": "text",
"field": "createdTime",
"sortable": true,
"title": "创建时间"
},
{
"filterable": true,
"cellType": "number",
"field": "productNum",
"sortable": true,
"title": "产品数量"
},
{
"filterable": true,
"cellType": "number",
"field": "categoryNum",
"sortable": true,
"title": "类目数量"
},
{
"filterable": true,
"cellType": "text",
"field": "categories",
"sortable": true,
"title": "类目列表"
},
{
"filterable": true,
"cellType": "text",
"field": "monthlyVisit",
"sortable": true,
"title": "月访问量(格式化,如 2"
},
{
"filterable": true,
"cellType": "text",
"field": "monthOrderNum",
"sortable": true,
"title": "月订单量(格式化,如 15"
},
{
"filterable": true,
"cellType": "text",
"field": "fbFollowers",
"sortable": true,
"title": "Facebook 粉丝数(格式化)"
},
{
"filterable": true,
"cellType": "text",
"field": "insFollowers",
"sortable": true,
"title": "Instagram 粉丝数(格式化)"
},
{
"filterable": true,
"cellType": "number",
"field": "advertiseCount",
"sortable": true,
"title": "广告数量"
},
{
"filterable": true,
"cellType": "text",
"field": "adLink",
"sortable": true,
"title": "广告库链接"
},
{
"filterable": true,
"cellType": "text",
"field": "email",
"sortable": true,
"title": "联系邮箱"
},
{
"filterable": true,
"cellType": "text",
"field": "facebookUrl",
"sortable": true,
"title": "Facebook 主页链接"
},
{
"filterable": true,
"cellType": "text",
"field": "instagramUrl",
"sortable": true,
"title": "Instagram 主页链接"
},
{
"filterable": true,
"cellType": "text",
"field": "socialLinks",
"sortable": true,
"title": "其他社交链接"
},
{
"filterable": true,
"cellType": "text",
"field": "globalRank",
"sortable": true,
"title": "全球排名"
},
{
"filterable": true,
"cellType": "text",
"field": "logo",
"sortable": true,
"title": "店铺 Logo URL"
},
{
"filterable": true,
"cellType": "number",
"field": "availableStatus",
"sortable": true,
"title": "店铺状态:1=活跃"
}
],
"storeNum": 1,
"title": "Shopify 店铺查询",
"type": "tableListWorkbenches"
}
}Ver el formato de solicitud y respuesta MCP
Ejemplos
Se basa en una muestra de la documentación publicada, no en una llamada en vivo a la herramienta.
La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.
Solicitud MCP
{
"jsonrpc": "2.0",
"id": "shopify-store-query-example",
"method": "tools/call",
"params": {
"name": "nexscope_shopify_store_query",
"arguments": {
"searchKey": "allbirds.com",
"page": 1,
"pageSize": 10
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "shopify-store-query-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"title\":\"Shopify 店铺查询\",\"total\":1,\"stores\":[{\"categories\":[{\"name\":\"5\",\"id\":\"5\"}],\"categoryNum\":9,\"globalRank\":\"\",\"country\":\"US\",\"socialLinks\":{\"youtube\":\"https://www.youtube.com/channel/UCnGErLCau5qNJ0Xwe6uEyTw\",\"twitter\":\"https://twitter.com/allbirds\",\"tiktok\":\"https://www.tiktok.com/@weareallbirds\",\"facebook\":\"https://www.facebook.com/weareallbirds\",\"pinterest\":\"http://pinterest.com/weareallbirds\",\"instagram\":\"https://www.instagram.com/allbirds\"},\"storeDomain\":\"allbirds.com\",\"productNum\":692,\"storeId\":\"5852578\",\"fbFollowers\":\"0\",\"monthOrderNum\":\"5.6k\",\"storeLink\":\"https://allbirds.com\",\"facebookUrl\":\"https://www.facebook.com/1096859176844485\"}],\"storeNum\":1}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"title": "Shopify 店铺查询",
"total": 1,
"stores": [
{
"categories": [
{
"name": "5",
"id": "5"
}
],
"categoryNum": 9,
"globalRank": "",
"country": "US",
"socialLinks": {
"youtube": "https://www.youtube.com/channel/UCnGErLCau5qNJ0Xwe6uEyTw",
"twitter": "https://twitter.com/allbirds",
"tiktok": "https://www.tiktok.com/@weareallbirds",
"facebook": "https://www.facebook.com/weareallbirds",
"pinterest": "http://pinterest.com/weareallbirds",
"instagram": "https://www.instagram.com/allbirds"
},
"storeDomain": "allbirds.com",
"productNum": 692,
"storeId": "5852578",
"fbFollowers": "0",
"monthOrderNum": "5.6k",
"storeLink": "https://allbirds.com",
"facebookUrl": "https://www.facebook.com/1096859176844485"
}
],
"storeNum": 1
}
},
"isError": false
}
}