Investigación de productos de Etsy

API de búsqueda de categorías de Etsy MCP

Buscar categoría Etsy IDs por nombre de categoría, ID, o padre ID para filtrado de productos y tiendas. Llamada vía REST API o MCP con tu clave de API de Nexscope.

CosteRecent 10 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de búsqueda de categorías 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 Etsy Categorías

Prompt: Encontrar Etsy Categorías para [search phrase]. 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 Categorías para [search phrase]. 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. Resolver la jerarquía de la categoría

Prompt: Encontrar Etsy Categorías para [search phrase]. Mostrar los resultados disponibles e identificar claramente la información que falta. Mostrar la categoría de juego IDs, niveles y cadenas de padres para que pueda seleccionar la rama correcta. No seleccione una categoría únicamente porque su etiqueta coincide con la palabra clave.

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_category_search

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-category-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_etsy_category_search",
    "arguments": {
      "keyword": "phone case",
      "page": 1,
      "pageSize": 1
    }
  }
}

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
`keyword`	`string`	obligatorio	Palabras clave, a la mayoría de 200 caracteres; coincidencias nombre de categoría, categoría IDo parentIds por subestring Ejemplo: phone case
`page`	`integer`	opcional	Número de página, a partir de 1; predeterminados a 1 Ejemplo: 1
`pageSize`	`integer`	opcional	Artículos por página, de 1 a 200; predeterminados a 50 Ejemplo: 50

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
`costToken`	`integer`	opcional	Tokens de consumo (no se factura la recuperación local)
`categories`	`array`	opcional	Lista de categorías coincidentes
`title`	`string`	opcional	Título
`categoryLevel`	`integer`	opcional	Categoría
`id`	`string`	opcional	categoría id
`name`	`string`	opcional	Categoría nombre
`parentId`	`string`	opcional	Categoría principal canónica id
`parentIds`	`string`	opcional	Todos los niños de la categoría de padres no vacíos (comma separados)

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

Buscar categoría Etsy IDs por nombre de categoría, ID, o padre ID para filtrado de productos y tiendas. Use “hogar”.

Respuesta de ejemplo

En la muestra publicada, el primer registro mostrado es “Home Temples ' Shrines”. Su nivel de categoría notificado es 4. Sus ids padres reportados son 23db76b0a2d0600e. 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

{
  "keyword": "home",
  "pageSize": 1
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 1,
    "categories": [
      {
        "categoryLevel": 4,
        "name": "Home Temples & Shrines",
        "parentIds": "23db76b0a2d0600e",
        "id": "32a0e0610922b5ff",
        "parentId": "23db76b0a2d0600e"
      }
    ],
    "title": "Etsy 品类检索"
  }
}

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-category-search-example",
  "method": "tools/call",
  "params": {
    "name": "nexscope_etsy_category_search",
    "arguments": {
      "keyword": "home",
      "pageSize": 1
    }
  }
}

Formato de respuesta MCP

{
  "jsonrpc": "2.0",
  "id": "etsy-category-search-example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"code\":0,\"msg\":null,\"data\":{\"categories\":[{\"name\":\"Home Temples & Shrines\",\"id\":\"32a0e0610922b5ff\",\"categoryLevel\":4,\"parentIds\":\"23db76b0a2d0600e\",\"parentId\":\"23db76b0a2d0600e\"}],\"title\":\"Etsy 品类检索\",\"total\":1}}"
      }
    ],
    "structuredContent": {
      "code": 0,
      "msg": null,
      "data": {
        "categories": [
          {
            "name": "Home Temples & Shrines",
            "id": "32a0e0610922b5ff",
            "categoryLevel": 4,
            "parentIds": "23db76b0a2d0600e",
            "parentId": "23db76b0a2d0600e"
          }
        ],
        "title": "Etsy 品类检索",
        "total": 1
      }
    },
    "isError": false
  }
}