Investigación de productos de Etsy
API de consulta de tiendas de Etsy MCP
Busca Tiendas Etsy por palabra clave, categoría, país, status, ratings, ventas, favoritos, comentarios, y fecha de apertura con paginación. Disponible REST API o MCP.
Prompts y casos de uso de API de consulta de tiendas 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. Encuentra tiendas que coincidan con mis criterios de investigación
Prompt: Encontrar Etsy tiendas que coincidan con mis criterios de investigación [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 Etsy tiendas que coincidan con mis criterios de investigación [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 Etsy tiendas que coincidan con mis criterios de investigación [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 ventas totales, ventas semanales, cuenta de revisión o cuenta favorita.
4. Encontrar coincidencias por Total Favoritos
Prompt: Encontrar Etsy tiendas que coincidan con mis criterios de investigación [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen total favorites range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
5. Encontrar coincidencias por favoritos semanales
Prompt: Encontrar Etsy tiendas que coincidan con mis criterios de investigación [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen weekly favorites range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
6. Encontrar coincidencias por totales críticas
Prompt: Encontrar Etsy tiendas que coincidan con mis criterios de investigación [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen total reviews range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
7. Encontrar coincidencias por reseñas semanales
Prompt: Encontrar Etsy tiendas que coincidan con mis criterios de investigación [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen weekly reviews range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
8. Buscar coincidencias por importe de ventas
Prompt: Encontrar Etsy tiendas que coincidan con mis criterios de investigación [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.
9. Encontrar coincidencias por ventas semanales
Prompt: Encontrar Etsy tiendas que coincidan con mis criterios de investigación [search phrase] dentro [target marketplace]. 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.
10. Encontrar coincidencias por la fecha de apertura de la tienda
Prompt: Encontrar Etsy tiendas que coincidan con mis criterios de investigación [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen store opening date range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
11. Resultados estrechos por categoría de tienda primaria
Prompt: Encontrar Etsy tiendas que coincidan con mis criterios de investigación [search phrase] dentro [target marketplace]. Uso [my selected primary store category] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.
12. Resultados estrechos por estado de la tienda
Prompt: Encontrar Etsy tiendas que coincidan con mis criterios de investigación [search phrase] dentro [target marketplace]. Uso [my selected store status] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.
13. Buscar Tiendas o Productos Altamente Alabados
Prompt: Encontrar Etsy tiendas que coincidan con mis criterios de investigación [search phrase] dentro [target marketplace]. Aplicar [my preference for the raving classification] al revisar los resultados. Resumir sólo los registros devueltos.
14. Encontrar Etsy Star Stores
Prompt: Encontrar Etsy tiendas que coincidan con mis criterios de investigación [search phrase] dentro [target marketplace]. Aplicar [my preference for star stores] al revisar los resultados. Resumir sólo los registros devueltos.
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_etsy_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": "etsy-store-query-1",
"method": "tools/call",
"params": {
"name": "nexscope_etsy_store_query",
"arguments": {
"page": 1,
"pageSize": 20,
"searchKey": "Lewshop1"
}
}
}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, palabra clave o tienda Etsy URL. Ejemplo: Lewshop1 |
category | string | opcional | Categoría de tiendas primarias. Ejemplo: Jewelry |
country | string | opcional | Almacene país o región. Ejemplo: US |
status | integer | opcional | Estado de la tienda: 1 activo, 0 inactivo. Ejemplo: 1 |
isRaving | integer | opcional | Bandera de la tienda de buceo: 1 sí. Ejemplo: 1 |
isStar | integer | opcional | Bandera de la tienda: 1 sí. Ejemplo: 1 |
beginFavorites | integer | opcional | El total mínimo de favoritos. Ejemplo: 0 |
endFavorites | integer | opcional | Principales favoritos. Ejemplo: 10000 |
beginFavoritesWeekly | integer | opcional | Favoritos semanales mínimos. Ejemplo: 0 |
endFavoritesWeekly | integer | opcional | Máximo semanario favoritos. Ejemplo: 1000 |
beginReviews | integer | opcional | Reseñas totales mínimas. Ejemplo: 0 |
endReviews | integer | opcional | Máximas críticas totales. Ejemplo: 10000 |
beginReviewsWeekly | integer | opcional | Reseñas semanales mínimas. Ejemplo: 0 |
endReviewsWeekly | integer | opcional | Máximas reseñas semanales. Ejemplo: 1000 |
beginSales | integer | opcional | Ventas totales mínimas. Ejemplo: 0 |
endSales | integer | opcional | Máximas ventas totales. Ejemplo: 100000 |
beginSalesWeekly | integer | opcional | Ventas semanales mínimas. Ejemplo: 0 |
endSalesWeekly | integer | opcional | Máximas ventas semanales. Ejemplo: 1000 |
beginStoreOpenedAt | string | opcional | Inicio de la fecha de apertura YYYY-MM-DD formato. Ejemplo: 2020-01-01 |
endStoreOpenedAt | string | opcional | Fecha de apertura finaliza en YYYY-MM-DD formato. Ejemplo: 2026-01-01 |
sortBy | integer | opcional | Campo de clasificación: 8 ventas totales, 9 ventas semanales, 10 críticas, 11 favoritos. Ejemplo: 8 |
sortDesc | integer | opcional | Ordenar dirección: 1 descendente, 0 ascendente. Ejemplo: 1 |
page | integer | opcional | Número de página desde 1. Ejemplo: 1 |
pageSize | integer | opcional | Artículos por página de 1 a 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 registros (número de registros devueltos en esta página) |
sourceType | string | opcional | Tipo fuente: etsy |
stores | array | opcional | Lista de tiendas |
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) |
storeNum | integer | opcional | Número total de tiendas elegibles (recurso store_num) |
title | string | opcional | Título |
type | string | opcional | Estilo de retroceso |
category | array | opcional | Lista de categorías principales |
country | array | opcional | Lista de países |
favorites | integer | opcional | Número de colecciones |
favoritesWeekly | integer | opcional | Número de nuevos favoritos por semana |
isRaving | integer | opcional | Ya sea el amor: 1=Sí |
isStar | integer | opcional | Estrella o no: 1=Sí |
logoUrl | string | opcional | Store avatar URL |
productCount | integer | opcional | Almacene la cantidad de productos |
rating | number | opcional | Valoración |
reviews | integer | opcional | Número de comentarios |
reviewsWeekly | integer | opcional | Nuevos comentarios por semana |
salesTotal | integer | opcional | ventas totales |
salesWeekly | integer | opcional | Ventas semanales |
shopWebsite | string | opcional | Store official website/external enlace |
startAt | string | opcional | Fecha de apertura de la tienda |
status | integer | opcional | Estado de la tienda: 1=activo, 0=inactivo |
storeId | string | opcional | Store ID |
storeName | string | opcional | Nombre de la tienda |
storeUrl | string | opcional | Enlace de la tienda |
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
Encuentra tiendas Etsy que coincidan con mis criterios de investigación.
Respuesta de ejemplo
En la muestra publicada, su total reportado es de 20. Su num de la tienda reportada es 3931535. 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": 20,
"sortBy": 9,
"sortDesc": 1
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"total": 20,
"sourceTool": "ehunt",
"sourceType": "etsy",
"stores": [
{
"favorites": 103819,
"country": [
"US"
],
"isRaving": 1,
"rating": 484,
"salesTotal": 2337140,
"favoritesWeekly": 278,
"salesWeekly": 37140,
"storeId": "9901413",
"productCount": 10576,
"logoUrl": "https://i.etsystatic.com/9901413/r/isla/5fb889/87829779/isla_500x500.87829779_6bvbiam9.jpg",
"shopWebsite": "/shop/Beadboat1",
"reviews": 269720,
"isStar": 1,
"storeUrl": "/shop/Beadboat1",
"reviewsWeekly": 200,
"storeName": "Beadboat1",
"category": [
"60730d8d2eef8f4f",
"565631402af79df4"
],
"startAt": "2014-08-22 03:39:19",
"status": 1
},
{
"favorites": 46484,
"country": [
"US"
],
"isRaving": 1,
"rating": 484,
"salesTotal": 1021978,
"favoritesWeekly": 331,
"salesWeekly": 21978,
"storeId": "18669781",
"productCount": 971,
"logoUrl": "https://i.etsystatic.com/18669781/r/isla/e058f8/73016339/isla_500x500.73016339_f7nxd7m4.jpg",
"shopWebsite": "/shop/SeedCult",
"reviews": 86005,
"isStar": 1,
"storeUrl": "/shop/SeedCult",
"reviewsWeekly": 280,
"storeName": "SeedCult",
"category": [
"dddaa894234df841"
],
"startAt": "2018-10-09 20:52:28",
"status": 1
},
{
"favorites": 50526,
"country": [
"US"
],
"isRaving": 0,
"rating": 500,
"salesTotal": 1200000,
"favoritesWeekly": 127,
"salesWeekly": 10248,
"storeId": "13622716",
"productCount": 1438,
"logoUrl": "https://i.etsystatic.com/13622716/r/isla/bc8ccc/71532549/isla_180x180.71532549_noeakuxe.jpg",
"shopWebsite": "https://www.etsy.com/shop/MyPorchPrints",
"reviews": 137536,
"isStar": 1,
"storeUrl": "https://www.etsy.com/shop/MyPorchPrints",
"reviewsWeekly": 275,
"storeName": "MyPorchPrints",
"category": [
"f199495489bdde6e",
"60730d8d2eef8f4f"
],
"startAt": "2016-08-31 21:40:35",
"status": 1
},
{
"favorites": 78301,
"country": [
"US"
],
"isRaving": 1,
"rating": 488,
"salesTotal": 1662421,
"favoritesWeekly": 503,
"salesWeekly": 6024,
"storeId": "20230277",
"productCount": 16673,
"logoUrl": "https://i.etsystatic.com/20230277/r/isla/30192b/45135135/isla_500x500.45135135_h48rosag.jpg",
"shopWebsite": "/shop/WarungBeads",
"reviews": 134451,
"isStar": 0,
"storeUrl": "/shop/WarungBeads",
"reviewsWeekly": 408,
"storeName": "WarungBeads",
"category": [
"60730d8d2eef8f4f",
"565631402af79df4"
],
"startAt": "2019-05-16 01:14:04",
"status": 1
},
{
"favorites": 161472,
"country": [
"GB"
],
"isRaving": 1,
"rating": 488,
"salesTotal": 2184757,
"favoritesWeekly": 1296,
"salesWeekly": 4678,
"storeId": "10967397",
"productCount": 6969,
"logoUrl": "https://i.etsystatic.com/10967397/r/isla/049d6d/27554222/isla_500x500.27554222_7tnx15id.jpg",
"shopWebsite": "/shop/SilverRainSilver",
"reviews": 436270,
"isStar": 1,
"storeUrl": "/shop/SilverRainSilver",
"reviewsWeekly": 780,
"storeName": "SilverRainSilver",
"category": [
"565631402af79df4"
],
"startAt": "2015-04-07 21:45:47",
"status": 1
},
{
"favorites": 537947,
"country": [
"US"
],
"isRaving": 1,
"rating": 482,
"salesTotal": 3847700,
"favoritesWeekly": 1741,
"salesWeekly": 4652,
"storeId": "10204022",
"productCount": 2529,
"logoUrl": "https://i.etsystatic.com/10204022/r/isla/883ac2/88813489/isla_500x500.88813489_7nbtt4gg.jpg",
"shopWebsite": "/shop/CaitlynMinimalist",
"reviews": 751160,
"isStar": 1,
"storeUrl": "/shop/CaitlynMinimalist",
"reviewsWeekly": 648,
"storeName": "CaitlynMinimalist",
"category": [
"565631402af79df4"
],
"startAt": "2014-11-02 07:08:19",
"status": 1
},
{
"favorites": 84649,
"country": [
"US"
],
"isRaving": 1,
"rating": 476,
"salesTotal": 731584,
"favoritesWeekly": 1127,
"salesWeekly": 3948,
"storeId": "21623448",
"productCount": 2639,
"logoUrl": "https://i.etsystatic.com/21623448/r/isla/77d109/58073783/isla_500x500.58073783_dhq85jyl.jpg",
"shopWebsite": "/shop/OuferJewelry",
"reviews": 127973,
"isStar": 1,
"storeUrl": "/shop/OuferJewelry",
"reviewsWeekly": 421,
"storeName": "OuferJewelry",
"category": [
"565631402af79df4"
],
"startAt": "2019-11-15 14:55:13",
"status": 1
},
{
"favorites": 37097,
"country": [
"US"
],
"isRaving": 1,
"rating": 496,
"salesTotal": 692947,
"favoritesWeekly": 509,
"salesWeekly": 3905,
"storeId": "11543088",
"productCount": 15758,
"logoUrl": "https://i.etsystatic.com/11543088/r/isla/2665a6/26883994/isla_500x500.26883994_oe9ptrie.jpg",
"shopWebsite": "/shop/CuteLittleFabricShop",
"reviews": 127088,
"isStar": 1,
"storeUrl": "/shop/CuteLittleFabricShop",
"reviewsWeekly": 500,
"storeName": "CuteLittleFabricShop",
"category": [
"60730d8d2eef8f4f"
],
"startAt": "2015-08-20 05:34:08",
"status": 1
},
{
"favorites": 50417,
"country": [
"TR"
],
"isRaving": 1,
"rating": 496,
"salesTotal": 1298384,
"favoritesWeekly": 181,
"salesWeekly": 3368,
"storeId": "5793103",
"productCount": 15084,
"logoUrl": "https://i.etsystatic.com/5793103/r/isla/25e6f2/60438582/isla_500x500.60438582_f12h61bu.jpg",
"shopWebsite": "/shop/AZsupplies",
"reviews": 149090,
"isStar": 1,
"storeUrl": "/shop/AZsupplies",
"reviewsWeekly": 421,
"storeName": "AZsupplies",
"category": [
"565631402af79df4",
"60730d8d2eef8f4f"
],
"startAt": "2010-02-05 01:59:35",
"status": 1
},
{
"favorites": 6528,
"country": [
"US"
],
"isRaving": 0,
"rating": 500,
"salesTotal": 40000,
"favoritesWeekly": 2072,
"salesWeekly": 3033,
"storeId": "49772883",
"productCount": 21,
"logoUrl": "https://i.etsystatic.com/49772883/r/isla/010345/72480394/isla_180x180.72480394_bcrxkac7.jpg",
"shopWebsite": "https://www.etsy.com/shop/MysticTarotGuide",
"reviews": 3650,
"isStar": 0,
"storeUrl": "https://www.etsy.com/shop/MysticTarotGuide",
"reviewsWeekly": 38,
"storeName": "MysticTarotGuide",
"category": [
"dddaa894234df841"
],
"startAt": "2024-05-29 00:10:41",
"status": 1
},
{
"favorites": 73579,
"country": [
"CA"
],
"isRaving": 0,
"rating": 500,
"salesTotal": 559400,
"favoritesWeekly": 706,
"salesWeekly": 2800,
"storeId": "15888388",
"productCount": 439,
"logoUrl": "https://i.etsystatic.com/15888388/r/isla/08d730/60423365/isla_180x180.60423365_sji9bndx.jpg",
"shopWebsite": "https://www.etsy.com/shop/MJsOffTheHookDesigns",
"reviews": 43340,
"isStar": 1,
"storeUrl": "https://www.etsy.com/shop/MJsOffTheHookDesigns",
"reviewsWeekly": 103,
"storeName": "MJsOffTheHookDesigns",
"category": [
"dddaa894234df841",
"60730d8d2eef8f4f",
"efe0bd2c212eceec"
],
"startAt": "2017-08-31 07:55:31",
"status": 1
},
{
"favorites": 75057,
"country": [
"US"
],
"isRaving": 1,
"rating": 487,
"salesTotal": 961258,
"favoritesWeekly": 313,
"salesWeekly": 2792,
"storeId": "10067510",
"productCount": 6911,
"logoUrl": "https://i.etsystatic.com/10067510/r/isla/709554/34852290/isla_500x500.34852290_mkcb9mua.jpg",
"shopWebsite": "/shop/stonesdirect",
"reviews": 176144,
"isStar": 1,
"storeUrl": "/shop/stonesdirect",
"reviewsWeekly": 420,
"storeName": "stonesdirect",
"category": [
"60730d8d2eef8f4f"
],
"startAt": "2014-10-02 23:38:25",
"status": 1
},
{
"favorites": 23975,
"country": [
"CN"
],
"isRaving": 0,
"rating": 500,
"salesTotal": 627500,
"favoritesWeekly": 166,
"salesWeekly": 2788,
"storeId": "19202076",
"productCount": 4624,
"logoUrl": "https://i.etsystatic.com/19202076/r/isla/df2cd2/54636778/isla_500x500.54636778_n04ucoor.jpg",
"shopWebsite": "/shop/CreationCraftStudio",
"reviews": 66250,
"isStar": 1,
"storeUrl": "/shop/CreationCraftStudio",
"reviewsWeekly": 244,
"storeName": "CreationCraftStudio",
"category": [
"60730d8d2eef8f4f",
"dddaa894234df841",
"98edb85b00d9527a"
],
"startAt": "2018-12-27 12:50:44",
"status": 1
},
{
"favorites": 63490,
"country": [
"US"
],
"isRaving": 1,
"rating": 479,
"salesTotal": 1609186,
"favoritesWeekly": 200,
"salesWeekly": 2703,
"storeId": "10162345",
"productCount": 2172,
"logoUrl": "https://i.etsystatic.com/10162345/r/isla/2b61f9/17468509/isla_500x500.17468509_inn5sqst.jpg",
"shopWebsite": "/shop/SeedGeeks",
"reviews": 146656,
"isStar": 1,
"storeUrl": "/shop/SeedGeeks",
"reviewsWeekly": 228,
"storeName": "SeedGeeks",
"category": [
"60730d8d2eef8f4f",
"0a9c8cfb7eb4d0bb"
],
"startAt": "2014-11-01 01:49:42",
"status": 1
},
{
"favorites": 9660,
"country": [
"US"
],
"isRaving": 0,
"rating": 500,
"salesTotal": 173500,
"favoritesWeekly": 272,
"salesWeekly": 2333,
"storeId": "51952023",
"productCount": 2873,
"logoUrl": "https://i.etsystatic.com/51952023/r/isla/5ee6f9/71046291/isla_180x180.71046291_1yad14na.jpg",
"shopWebsite": "https://www.etsy.com/shop/JennyKitchenShop",
"reviews": 4110,
"isStar": 0,
"storeUrl": "https://www.etsy.com/shop/JennyKitchenShop",
"reviewsWeekly": 34,
"storeName": "JennyKitchenShop",
"category": [
"4c34af4f84db571c",
"dddaa894234df841",
"efe0bd2c212eceec"
],
"startAt": "2024-04-26 09:51:33",
"status": 1
},
{
"favorites": 19301,
"country": [
"CN"
],
"isRaving": 0,
"rating": 486,
"salesTotal": 401700,
"favoritesWeekly": 134,
"salesWeekly": 2264,
"storeId": "23414921",
"productCount": 2299,
"logoUrl": "https://i.etsystatic.com/23414921/r/isla/3e3249/43362005/isla_500x500.43362005_87fmd63l.jpg",
"shopWebsite": "/shop/LoveBeadsCords",
"reviews": 58210,
"isStar": 1,
"storeUrl": "/shop/LoveBeadsCords",
"reviewsWeekly": 264,
"storeName": "LoveBeadsCords",
"category": [
"60730d8d2eef8f4f"
],
"startAt": "2020-05-27 14:26:25",
"status": 1
},
{
"favorites": 39028,
"country": [
"US"
],
"isRaving": 0,
"rating": 490,
"salesTotal": 310900,
"favoritesWeekly": 626,
"salesWeekly": 2094,
"storeId": "6612469",
"productCount": 351,
"logoUrl": "https://i.etsystatic.com/6612469/r/isla/d5607f/67532039/isla_500x500.67532039_q9spg4ov.jpg",
"shopWebsite": "/shop/BrianaKdesigns",
"reviews": 23778,
"isStar": 1,
"storeUrl": "/shop/BrianaKdesigns",
"reviewsWeekly": 63,
"storeName": "BrianaKdesigns",
"category": [
"60730d8d2eef8f4f"
],
"startAt": "2011-11-15 22:46:56",
"status": 1
},
{
"favorites": 24313,
"country": [
"GB"
],
"isRaving": 0,
"rating": 484,
"salesTotal": 538500,
"favoritesWeekly": 562,
"salesWeekly": 1984,
"storeId": "25947065",
"productCount": 1396,
"logoUrl": "https://i.etsystatic.com/25947065/r/isla/0cc238/49528375/isla_500x500.49528375_90nvyayp.jpg",
"shopWebsite": "/shop/Lamoriea",
"reviews": 82570,
"isStar": 1,
"storeUrl": "/shop/Lamoriea",
"reviewsWeekly": 203,
"storeName": "Lamoriea",
"category": [
"dddaa894234df841",
"565631402af79df4"
],
"startAt": "2020-11-09 17:10:05",
"status": 1
},
{
"favorites": 191219,
"country": [
"US"
],
"isRaving": 1,
"rating": 473,
"salesTotal": 1327698,
"favoritesWeekly": 538,
"salesWeekly": 1937,
"storeId": "5400716",
"productCount": 45504,
"logoUrl": "https://i.etsystatic.com/5400716/r/isla/4c8a71/86657365/isla_500x500.86657365_kj6vwj7w.jpg",
"shopWebsite": "/shop/Spoonflower",
"reviews": 205772,
"isStar": 0,
"storeUrl": "/shop/Spoonflower",
"reviewsWeekly": 270,
"storeName": "Spoonflower",
"category": [
"dddaa894234df841",
"60730d8d2eef8f4f"
],
"startAt": "2008-11-11 00:30:11",
"status": 1
},
{
"favorites": 43197,
"country": [
"US"
],
"isRaving": 1,
"rating": 491,
"salesTotal": 928949,
"favoritesWeekly": 110,
"salesWeekly": 1924,
"storeId": "12711311",
"productCount": 5548,
"logoUrl": "https://i.etsystatic.com/12711311/r/isla/fc29ed/78520513/isla_500x500.78520513_kalhfwut.jpg",
"shopWebsite": "/shop/CrcbeadsShop",
"reviews": 146416,
"isStar": 0,
"storeUrl": "/shop/CrcbeadsShop",
"reviewsWeekly": 134,
"storeName": "CrcbeadsShop",
"category": [
"60730d8d2eef8f4f"
],
"startAt": "2016-03-15 08:22:47",
"status": 1
}
],
"columns": [
{
"filterable": true,
"cellType": "text",
"field": "storeId",
"sortable": true,
"title": "店铺 ID"
},
{
"filterable": true,
"cellType": "text",
"field": "storeName",
"sortable": true,
"title": "店铺名称"
},
{
"filterable": true,
"cellType": "text",
"field": "logoUrl",
"sortable": true,
"title": "店铺头像 URL"
},
{
"filterable": true,
"cellType": "text",
"field": "storeUrl",
"sortable": true,
"title": "店铺链接"
},
{
"filterable": true,
"cellType": "number",
"field": "status",
"sortable": true,
"title": "店铺状态:1=活跃,0=非活跃"
},
{
"filterable": true,
"cellType": "number",
"field": "productCount",
"sortable": true,
"title": "店铺商品数量"
},
{
"filterable": true,
"cellType": "text",
"field": "startAt",
"sortable": true,
"title": "开店日期"
},
{
"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": "reviewsWeekly",
"sortable": true,
"title": "周新增评论数"
},
{
"filterable": true,
"cellType": "number",
"field": "favorites",
"sortable": true,
"title": "收藏数"
},
{
"filterable": true,
"cellType": "number",
"field": "favoritesWeekly",
"sortable": true,
"title": "周新增收藏数"
},
{
"filterable": true,
"cellType": "number",
"field": "isStar",
"sortable": true,
"title": "是否星标:1=是"
},
{
"filterable": true,
"cellType": "number",
"field": "isRaving",
"sortable": true,
"title": "是否 Raving:1=是"
},
{
"filterable": true,
"cellType": "text",
"field": "category",
"sortable": true,
"title": "主营类目列表"
},
{
"filterable": true,
"cellType": "number",
"field": "rating",
"sortable": true,
"title": "评分"
},
{
"filterable": true,
"cellType": "text",
"field": "country",
"sortable": true,
"title": "国家/地区列表"
},
{
"filterable": true,
"cellType": "text",
"field": "shopWebsite",
"sortable": true,
"title": "店铺官网/外链"
}
],
"storeNum": 3931535,
"title": "店铺查询",
"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": "etsy-store-query-example",
"method": "tools/call",
"params": {
"name": "nexscope_etsy_store_query",
"arguments": {
"page": 1,
"pageSize": 20,
"sortBy": 9,
"sortDesc": 1
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "etsy-store-query-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"title\":\"店铺查询\",\"total\":20,\"stores\":[{\"reviews\":269720,\"rating\":484,\"favorites\":103819,\"country\":[\"US\"],\"isRaving\":1,\"salesTotal\":2337140,\"favoritesWeekly\":278,\"salesWeekly\":37140,\"storeId\":\"9901413\",\"productCount\":10576,\"logoUrl\":\"https://i.etsystatic.com/9901413/r/isla/5fb889/87829779/isla_500x500.87829779_6bvbiam9.jpg\",\"shopWebsite\":\"/shop/Beadboat1\"},{\"reviews\":86005,\"rating\":484,\"favorites\":46484,\"country\":[\"US\"],\"isRaving\":1,\"salesTotal\":1021978,\"favoritesWeekly\":331,\"salesWeekly\":21978,\"storeId\":\"18669781\",\"productCount\":971,\"logoUrl\":\"https://i.etsystatic.com/18669781/r/isla/e058f8/73016339/isla_500x500.73016339_f7nxd7m4.jpg\",\"shopWebsite\":\"/shop/SeedCult\"}],\"storeNum\":3931535}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"title": "店铺查询",
"total": 20,
"stores": [
{
"reviews": 269720,
"rating": 484,
"favorites": 103819,
"country": [
"US"
],
"isRaving": 1,
"salesTotal": 2337140,
"favoritesWeekly": 278,
"salesWeekly": 37140,
"storeId": "9901413",
"productCount": 10576,
"logoUrl": "https://i.etsystatic.com/9901413/r/isla/5fb889/87829779/isla_500x500.87829779_6bvbiam9.jpg",
"shopWebsite": "/shop/Beadboat1"
},
{
"reviews": 86005,
"rating": 484,
"favorites": 46484,
"country": [
"US"
],
"isRaving": 1,
"salesTotal": 1021978,
"favoritesWeekly": 331,
"salesWeekly": 21978,
"storeId": "18669781",
"productCount": 971,
"logoUrl": "https://i.etsystatic.com/18669781/r/isla/e058f8/73016339/isla_500x500.73016339_f7nxd7m4.jpg",
"shopWebsite": "/shop/SeedCult"
}
],
"storeNum": 3931535
}
},
"isError": false
}
}