Generación de contenido con IA

API de generación de descripciones de productos MCP

Crea una tarea de generación de texto de instrucciones de copia de producto e imagen URLs, o consultas de una tarea conocida ID.

CosteRecent 10 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de generación de descripciones de productos

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. Escribe una descripción del producto

Prompt: Escriba una descripción del producto [verified product facts], siguiente [tone and audience brief]. Uso [supported text model] con [supported reasoning level] y ninguna imagen de referencia para este solo texto.

2. Escriba copia de los medios de producto

Prompt: Escriba una descripción [product brief] y [reference images or reference video], utilizando [supported model and reasoning level]. No inferir las especificaciones que los medios de comunicación no pueden establecer.

3. Recuperar un borrador de copia existente

Prompt: Revise la tarea existente de generación de copias [task ID]. Mostrar el texto completado si está disponible; si todavía está procesando, mantener esa tarea en lugar de crear otro borrador.

Qué debes proporcionar

Proporciona recursos que tengas derecho a usar y que cumplan los límites documentados de formato, dimensiones y cantidad de archivos de esta herramienta.

Una tarea pendiente todavía no ofrece un resultado final de imagen, vídeo o texto. Consulta la tarea existente en vez de enviar otra solicitud idéntica.

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_product_description_generator

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": "product-description-generator-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_product_description_generator",
    "arguments": {
      "imageUrls": [],
      "model": "GEM_3_FLASH",
      "operation": "create",
      "prompt": "Write a product description for a wireless speaker.",
      "thinkingLevel": "minimal"
    }
  }
}

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
`operation`	`string`	opcional	crear (por defecto) o consulta. Ejemplo: create
`prompt`	`string`	opcional	Instrucción de generación de copia de producto; requerida por crear. Ejemplo: Write a product description for a wireless speaker.
`imageUrls`	`array`	opcional	Media URLs utilizado como contexto. Pase un array vacío para la generación de solo texto; utilice hasta 10 imágenes o normalmente un vídeo. Ejemplo: []
`thinkingLevel`	`string`	opcional	Nivel de resonancia requerido por crear. GEM_3_1_PRO no soporta mínima. Ejemplo: minimal
`model`	`string`	opcional	Modelo de generación de texto. GEM_3_FLASH es el predeterminado. Ejemplo: GEM_3_FLASH
`memberId`	`string`	opcional	Identificador miembro del proveedor opcional utilizado por creación y consulta. Ejemplo:
`taskId`	`string`	opcional	Tareas del proveedor ID devuelto por crear; requerido por operación=query. Ejemplo: 123456789

Campos de respuesta

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

Nombre	Tipo	Obligatorio	Descripción
`code`	`integer`	obligatorio	0 indica que la solicitud se ha aceptado o se ha completado correctamente; cualquier valor distinto de cero indica un error de la plataforma.
`cost`	`string`	obligatorio	Milliseconds pasados, nunca créditos; -1 solicitudes fuera de la web.
`data`	`any`	obligatorio	Valor de Data usado por esta operación de API.
`msg`	`string \| null`	obligatorio	Valor de Msg usado por esta operación de API.
`time`	`string`	obligatorio	Tiempo local del servidor: yyyy-MM- No. HH:mm:ss.
`traceId`	`string \| null`	obligatorio	Valor de Trace id usado por esta operación de API.
`ts`	`string`	obligatorio	Época milisegundos.

Opción 1 de cualquier alternativa

Nombre	Tipo	Obligatorio	Descripción
`data`	`object`	obligatorio	Valor de Data usado por esta operación de API.
`data.completionTokens`	`integer`	opcional	La señal de salida cuenta cuando la tarea tiene éxito. Ejemplo: 350
`data.content`	`string`	opcional	Copia de producto generada cuando la tarea tiene éxito. Ejemplo: Example product description.
`data.costTime`	`integer`	opcional	Tiempo de ejecución reportado por el proveedor de corriente. Ejemplo: null
`data.costToken`	`integer`	opcional	Costo de señal de proveedor. Ejemplo: 1
`data.dataSnapshotMonth`	`string`	opcional	Data snapshot month returned by the upstream provider. Ejemplo: null
`data.page`	`integer`	opcional	Página actual devuelta por el proveedor de corriente. Ejemplo: null
`data.pageItemCount`	`integer`	opcional	El artículo cuenta con la página actual devuelta por el proveedor de corriente. Ejemplo: null
`data.pageSize`	`integer`	opcional	Tamaño de página devuelto por el proveedor de corriente. Ejemplo: null
`data.promptTokens`	`integer`	opcional	Input token cuenta cuando la tarea tiene éxito. Ejemplo: 120
`data.sourceTool`	`string`	opcional	Nombre de la herramienta de fuente específico del proveedor. Ejemplo: null
`data.sourceType`	`string`	opcional	Tipo de plataforma de fuente específica del proveedor. Ejemplo: null
`data.status`	`string`	opcional	Situación de la tarea, como PROCESSING, SUCCESSo FAILED. Ejemplo: PROCESSING
`data.taskId`	`string`	opcional	Tareas de generación asincrónica ID. Ejemplo: 123456789
`data.title`	`string`	opcional	Título de respuesta específico del proveedor. Ejemplo: null
`data.totalPage`	`integer`	opcional	Conteo total de página devuelto por el proveedor de corriente. Ejemplo: null
`data.totalTokens`	`integer`	opcional	Total token cuenta cuando la tarea tiene éxito. Ejemplo: 470
`data.type`	`string`	opcional	Tipo de renderizado o carga de pago específico del proveedor. Ejemplo: null

Opción 2 de cualquier alternativa

Nombre	Tipo	Obligatorio	Descripción
`data`	`null`	obligatorio	Valor de Data usado por esta operación de API.

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

Recuperar la tarea existente de generación de copias 2549906.

Respuesta de ejemplo

La muestra reporta una tarea exitosa cuyo contenido dice que la descripción del producto suministrado carece de instrucciones de uso. No devuelve pasos de uso. Esta es una respuesta completa de texto, no evidencia que las instrucciones faltantes fueron encontradas en otros lugares.

Sobre esta muestra: Extracto de una muestra de la documentación publicada; no son datos actuales ni el resultado de una llamada en vivo. La muestra publicada conserva los datos originales completos; aquí pueden abreviarse las listas y los textos largos. Los valores de negocio se conservan de la muestra publicada. Los tiempos y metadatos de trazabilidad que exige la envoltura externa son marcadores ilustrativos porque la fuente publicada no los incluye.

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

{
  "operation": "query",
  "taskId": "2549906"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "promptTokens": 441,
    "taskId": "2549906",
    "content": "```json\n{\n  \"sufficient\": false,\n  \"steps\": [],\n  \"missingInstructions\": \"Ürün açıklamasında ürünün özellikleri, faydaları ve hangi köpek türleri için uygun olduğu belirtilmiş; ancak ürünün nasıl kullanılacağına dair (örneğin: kullanım sıklığı, temizleme talimatı veya gözetim altında tutulması gibi) herhangi bir uygulama adımı veya kullanım talimatı bulunmamaktadır.\"\n}\n```",
    "completionTokens": 97,
    "status": "SUCCESS",
    "points": 0
  }
}

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": "product-description-generator-example",
  "method": "tools/call",
  "params": {
    "name": "nexscope_product_description_generator",
    "arguments": {
      "operation": "query",
      "taskId": "2549906"
    }
  }
}

Formato de respuesta MCP

{
  "jsonrpc": "2.0",
  "id": "product-description-generator-example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"code\":0,\"msg\":null,\"data\":{\"taskId\":\"2549906\",\"content\":\"```json\\n{\\n  \\\"sufficient\\\": false,\\n  \\\"steps\\\": [],\\n  \\\"missingInstructions\\\": \\\"Ürün açıklamasında ürünün özellikleri, faydaları ve hangi köpek türleri için uygun olduğu belirtilmiş; ancak ürünün nasıl kullanılacağına dair (örneğin: kullanım sıklığı, temizleme talimatı veya gözetim altında tutulması gibi) herhangi bir uygulama adımı veya kullanım talimatı bulunmamaktadır.\\\"\\n}\\n```\",\"status\":\"SUCCESS\"},\"cost\":\"-1\",\"time\":\"2026-01-01 00:00:00\",\"traceId\":null,\"ts\":\"0\"}"
      }
    ],
    "structuredContent": {
      "code": 0,
      "msg": null,
      "data": {
        "taskId": "2549906",
        "content": "```json\n{\n  \"sufficient\": false,\n  \"steps\": [],\n  \"missingInstructions\": \"Ürün açıklamasında ürünün özellikleri, faydaları ve hangi köpek türleri için uygun olduğu belirtilmiş; ancak ürünün nasıl kullanılacağına dair (örneğin: kullanım sıklığı, temizleme talimatı veya gözetim altında tutulması gibi) herhangi bir uygulama adımı veya kullanım talimatı bulunmamaktadır.\"\n}\n```",
        "status": "SUCCESS"
      },
      "cost": "-1",
      "time": "2026-01-01 00:00:00",
      "traceId": null,
      "ts": "0"
    },
    "isError": false
  }
}