JEV
API de evaluación de JEV MCP
Elija el modo preset (useCase + entrada) o modo personalizado (estado + preguntas); nunca mezclar los dos. Modo personalizado admite ruido, elección y puntuación, con respuestas independientes en result.answersModelo, identidad, aguas arriba URL, y los umbrales de ejecución siguen siendo propiedad del servidor. El contexto y las preguntas se envían a TypeSafe. Las decisiones son consultivas; el juez de preconfiguración de palabras clave sólo suministraba negocios, SERP, candidato y evidencia de producto. Requiere un activo Nexscope suscripción. Cada ruta o evaluar deducciones de llamadas 1 Nexscope credit; cualquier dato seleccionado API conserva su facturación existente. Ruta y evaluación de límites de acciones de 20 solicitudes por usuario por minuto, 200 solicitudes a nivel mundial por minuto, y 5.000 solicitudes a nivel mundial por día de rodaje; cada ruta o evaluación de llamadas cuenta como una solicitud. La admisión Quota es secuencial: minuto por usuario, minuto global, luego día de rodadura global; un mostrador admitido anteriormente sigue aumentado si un cheque posterior rechaza la solicitud.
Prompts y casos de uso de API de evaluación de JEV
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. Revisar un borrador de respuesta
Prompt: Comprueba [draft response] contra el preset de seguridad de respuesta. Explicar la decisión devuelta sin enviar ni publicar el proyecto.
2. Triage Supplied IP Pruebas
Prompt: Evaluate [supplied product and IP evidence] con el IP- Predeterminado de riesgo. Mantener la incertidumbre explícita; no convertir el resultado en una autorización legal.
3. Evaluate SEO Relevancia
Prompt: Evaluate [page content and search intent] con el SEO- preset de resistencia, reportando sólo dimensiones apoyadas.
4. Comprobar una reclamación contra pruebas suplementadas
Prompt: Evaluate [claim or quotation] contra la [supplied source evidence]. Informe evidencia faltante en lugar de llenarlo de memoria.
5. Consultar la palabra clave Relevancia del negocio
Prompt: Evaluate [candidate keywords with IDs] contra la [business facts]. Tomar decisiones vinculadas a los suministrados IDs y hechos.
6. Comprobar si las palabras clave se prolongan juntos
Prompt: Evaluate [candidate keywords and supplied SERP evidence] para agrupar la misma página. Explicar las decisiones que se devuelven sin inventar resultados de búsqueda.
7. Comprueba Product and Keyword Fit
Prompt: Evaluate [candidate keywords with IDs] contra la [Amazon product facts]. Mantenga cualquier decisión de ajuste limitada a la evidencia de producto suministrada.
8. Evaluar la evidencia con preguntas sí o no
Prompt: Evaluate [shared evidence] utilizando [one to 32 questions] que soliciten evaluaciones sí o no. Dar a cada pregunta un identificador corto y una pregunta específica; incluir mis definiciones de sí y no cuando se suministra. Utilice la evaluación personalizada sin un preset, e informe las respuestas devueltas sin ejecutar una acción.
9. Hacer preguntas de elección personalizada
Prompt: Evaluate [shared evidence] utilizando [one to 32 questions] que te pide que elijas entre mis opciones suministradas. Dar cada pregunta un identificador y dos a 255 opciones etiquetadas, con descripciones donde sea necesario. Utilice la evaluación personalizada sin un preset y reporte sólo las opciones devueltas.
10. Hacer preguntas de puntuación personalizada
Prompt: Evaluate [shared evidence] utilizando [one to 32 questions] en mis escalas de puntuación suministradas. Dar cada pregunta un identificador y dos a 32 descripciones de nivel ordenadas, comenzando a cero. Explique que la puntuación devuelta es un promedio ponderado por probabilidad, no un hecho medido. Utilice la evaluación personalizada sin un preset.
Qué debes proporcionar
Elija un modo: un preset con su entrada de coincidencia, o contexto compartido con preguntas personalizadas tipo. Nunca mezcle los dos modos.
Las entradas y estructuras de preguntas personalizadas deben seguir el esquema anidado. La evaluación es asesora y no ejecuta otra API o publicar contenido.
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_jev_evaluatehttps://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": "jev-evaluate-1",
"method": "tools/call",
"params": {
"name": "nexscope_jev_evaluate",
"arguments": {
"input": {
"content": "Never share passwords. Contact customer support through the official website."
},
"useCase": "response_guardrails"
}
}
}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 |
|---|---|---|---|
input | object | opcional | Los campos dependen del preset seleccionado; vea los esquemas de modo a continuación. |
questions | object | opcional | Se requiere en modo personalizado. 1–32 preguntas independientes, claves por llamada IDs. |
state | string | object | array | opcional | Se requiere en modo personalizado. Contexto no vacío compartido por cada pregunta; los datos suministrados se envían a TypeSafe. Longitud mínima: 1 Cantidad mínima de elementos: 1 |
useCase | string | opcional | Se requiere con entrada en modo preestablecido. Uno de los siete presets de propiedad del servidor. Permitidos: response_guardrails, ip_risk_triage, seo_relevance, evidence_check, keyword_business_relevance, keyword_cluster_fit, amazon_keyword_product_fit |
Preset mode
response_guardrails
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
input | object | opcional | Checks credential_exposure, harmful_instruction, deceptive_claim, instruction_overrideY severidad. La política de servidor fijo mapea los comprobaciones para pasar, revisar o bloquear. |
input.content | string | obligatorio | Respuesta autorizada o proyecto de contenido. Longitud mínima: 1 Longitud máxima: 6000 |
useCase | string | opcional | Se requiere con entrada en modo preestablecido. Uno de los siete presets de propiedad del servidor. Constante: response_guardrails |
ip_risk_triage
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
input | object | opcional | Marcas registradas, derechos de autor, patente, otros IP, e insuficientes señales de contexto más tipo de riesgo y gravedad. El resultado siempre requiere un examen humano y no es una autorización legal. |
input.text | string | obligatorio | Texto autorizado del producto o descripción para asesorar IP- Triage de riesgo. Longitud mínima: 1 Longitud máxima: 4000 |
useCase | string | opcional | Se requiere con entrada en modo preestablecido. Uno de los siete presets de propiedad del servidor. Constante: ip_risk_triage |
seo_relevance
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
input | object | opcional | Requiere consulta y al menos un título suministrado, metaDescriptiono contentExcerpt. Partituras relevantes solamente; no predice rankings, tráfico, volumen de búsqueda, o datos de intención. |
input.contentExcerpt | string | opcional | Valor de Content excerpt usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 4000 |
input.metaDescription | string | opcional | Valor de Meta description usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 1000 |
input.query | string | obligatorio | Valor de Query usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 500 |
input.title | string | opcional | Valor de Title usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 300 |
useCase | string | opcional | Se requiere con entrada en modo preestablecido. Uno de los siete presets de propiedad del servidor. Constante: seo_relevance |
Opción 1 de cualquier alternativa — requiere title
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
input | any | opcional | Requerido con useCase en modo preestablecido. Entrada estricta específica para presets. Presets de palabras clave aceptan sólo la palabra clave encuadernada, candidato, SERP- Evidencia y campos de productos. |
Opción 2 de cualquier alternativa — requiere metaDescription
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
input | any | opcional | Requerido con useCase en modo preestablecido. Entrada estricta específica para presets. Presets de palabras clave aceptan sólo la palabra clave encuadernada, candidato, SERP- Evidencia y campos de productos. |
Opción 3 de cualquier alternativa — requiere contentExcerpt
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
input | any | opcional | Requerido con useCase en modo preestablecido. Entrada estricta específica para presets. Presets de palabras clave aceptan sólo la palabra clave encuadernada, candidato, SERP- Evidencia y campos de productos. |
evidence_check
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
input | object | opcional | Assesses the claim only against sourceText. Si la cita suministrada está ausente después de la normalización del espacio blanco, el servidor devuelve determinístico quote_not_found sin una llamada modelo. |
input.claim | string | obligatorio | Valor de Claim usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 1000 |
input.quote | string | opcional | Cita opcional que debe ocurrir en sourceText después de la normalización del espacio blanco. Longitud mínima: 1 Longitud máxima: 1000 |
input.sourceText | string | obligatorio | Valor de Source text usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 6000 |
useCase | string | opcional | Se requiere con entrada en modo preestablecido. Uno de los siete presets de propiedad del servidor. Constante: evidence_check |
keyword_business_relevance
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
input | object | opcional | Requerido con useCase en modo preestablecido. Entrada estricta específica para presets. Presets de palabras clave aceptan sólo la palabra clave encuadernada, candidato, SERP- Evidencia y campos de productos. |
input.businessDescription | string | obligatorio | Valor de Business description usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 4000 |
input.exclusions | array | obligatorio | Valor de Exclusions usado por esta operación de API. Cantidad máxima de elementos: 50 |
input.exclusions[] | string | obligatorio | Elemento de input exclusions. Longitud mínima: 1 Longitud máxima: 200 |
input.keywords | array | obligatorio | Valor de Keywords usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 10 |
input.keywords[] | object | obligatorio | Elemento de input keywords. |
input.keywords[].id | string | obligatorio | Valor de Id usado por esta operación de API. Patrón: ^[A-Za-z0-9_-]{1,64}$ |
input.keywords[].keyword | string | obligatorio | Valor de Keyword usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 500 |
input.serpEvidence | array | opcional | Valor de Serp evidence usado por esta operación de API. Cantidad máxima de elementos: 30 |
input.serpEvidence[] | object | obligatorio | Elemento de input serpEvidence. |
input.serpEvidence[].id | string | obligatorio | Valor de Id usado por esta operación de API. Patrón: ^[A-Za-z0-9_-]{1,64}$ |
input.serpEvidence[].keywordId | string | obligatorio | Valor de Keyword id usado por esta operación de API. Patrón: ^[A-Za-z0-9_-]{1,64}$ |
input.serpEvidence[].source | string | obligatorio | Valor de Source usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 200 |
input.serpEvidence[].text | string | obligatorio | Valor de Text usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 2000 |
useCase | string | opcional | Se requiere con entrada en modo preestablecido. Uno de los siete presets de propiedad del servidor. Constante: keyword_business_relevance |
keyword_cluster_fit
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
input | object | opcional | Requerido con useCase en modo preestablecido. Entrada estricta específica para presets. Presets de palabras clave aceptan sólo la palabra clave encuadernada, candidato, SERP- Evidencia y campos de productos. |
input.candidates | array | obligatorio | Valor de Candidates usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 5 |
input.candidates[] | object | obligatorio | Elemento de input candidates. |
input.candidates[].id | string | obligatorio | Valor de Id usado por esta operación de API. Patrón: ^[A-Za-z0-9_-]{1,64}$ |
input.candidates[].keyword | string | obligatorio | Valor de Keyword usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 500 |
input.keywords | array | obligatorio | Valor de Keywords usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 10 |
input.keywords[] | object | obligatorio | Elemento de input keywords. |
input.keywords[].id | string | obligatorio | Valor de Id usado por esta operación de API. Patrón: ^[A-Za-z0-9_-]{1,64}$ |
input.keywords[].keyword | string | obligatorio | Valor de Keyword usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 500 |
useCase | string | opcional | Se requiere con entrada en modo preestablecido. Uno de los siete presets de propiedad del servidor. Constante: keyword_cluster_fit |
amazon_keyword_product_fit
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
input | object | opcional | Requerido con useCase en modo preestablecido. Entrada estricta específica para presets. Presets de palabras clave aceptan sólo la palabra clave encuadernada, candidato, SERP- Evidencia y campos de productos. |
input.keywords | array | obligatorio | Valor de Keywords usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 10 |
input.keywords[] | object | obligatorio | Elemento de input keywords. |
input.keywords[].id | string | obligatorio | Valor de Id usado por esta operación de API. Patrón: ^[A-Za-z0-9_-]{1,64}$ |
input.keywords[].keyword | string | obligatorio | Valor de Keyword usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 500 |
input.marketplace | string | obligatorio | Valor de Marketplace usado por esta operación de API. Permitidos: US, UK, DE, FR, JP, CA, IT, ES, MX, IN |
input.productFacts | array | obligatorio | Valor de Product facts usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 30 |
input.productFacts[] | object | obligatorio | Elemento de input productFacts. |
input.productFacts[].id | string | obligatorio | Valor de Id usado por esta operación de API. Patrón: ^[A-Za-z0-9_-]{1,64}$ |
input.productFacts[].source | string | obligatorio | Valor de Source usado por esta operación de API. Permitidos: title, bullet, attribute, description |
input.productFacts[].value | string | obligatorio | Valor de Value usado por esta operación de API. Longitud mínima: 1 Longitud máxima: 2000 |
useCase | string | opcional | Se requiere con entrada en modo preestablecido. Uno de los siete presets de propiedad del servidor. Constante: amazon_keyword_product_fit |
Custom mode
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 | Cero sobre el éxito; no cero para errores de validación, acceso, cuota o disponibilidad. |
data | object | obligatorio | Las políticas de servidor fijas cubren la seguridad de respuesta, IP Triage, SEO relevancia, comprobaciones de evidencia, relevancia de palabras de negocio, agrupación de palabras clave de la misma página, y Amazon palabras clave del producto encajan. Los presets de la palabra clave devuelven filas encuadernadas llave sólo por caller-supplied IDs. |
data.checks | object | obligatorio | Vacío en modo personalizado; las respuestas están en result.answers. Controles fijos de Noul, Score o Choice para el preset: riesgos de respuesta y gravedad; IP señales, risk_type, gravedad y insufficient_context; suministrada SEO dimensiones; o veredicto de evidencia. Deterministic quote_not_found devuelve un objeto vacío. |
data.decision | string | obligatorio | Regreso de Presets pass/review/block. Devuelve el modo personalizado evaluado, lo que significa que las respuestas están disponibles, no que se apruebe una acción. Permitidos: pass, review, block, evaluated |
data.model | string | null | obligatorio | Versión modelo resuelta, o nula para determinista quote_not_found. |
data.policyVersion | string | obligatorio | jev-evaluation-v1 para presets originales; jev-keyword-tools-v1 para presets de palabras clave; jev-custom-v1 para preguntas personalizadas. |
data.reasonCodes | array | obligatorio | Códigos de razón fijos sin texto presentado. |
data.reasonCodes[] | string | obligatorio | Códigos de razón fijos sin texto presentado. |
data.result | object | obligatorio | Resultado consolidado específico de Preset. Los presets de la palabra clave regresan result.rows con caller-supplied IDs, etiquetas fijas, confianza y referencias de razones fijas o pruebas. |
data.result.answers | object | opcional | Modo personalizado solamente. Respuestas clave por pregunta ID: retornos noul {type, noul}; retornos de elección {type, choice, confidence, probabilities}; rendimientos de puntuación {type, score, confidence, probabilities, legend}. No se devuelve la política automática ni el uso de token. |
data.result.rows | array | opcional | Valor de Rows usado por esta operación de API. Cantidad máxima de elementos: 10 |
data.result.rows[] | any | obligatorio | Elemento de data result rows. |
data.useCase | string | obligatorio | Valor de Use case usado por esta operación de API. Permitidos: response_guardrails, ip_risk_triage, seo_relevance, evidence_check, keyword_business_relevance, keyword_cluster_fit, amazon_keyword_product_fit, custom |
msg | string | obligatorio | Mensaje de respuesta. |
Business relevance row
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.rows[] | object | obligatorio | Elemento de data result rows. |
data.result.rows[].confidence | number | obligatorio | Valor de Confidence usado por esta operación de API. Mínimo: 0 Máximo: 1 |
data.result.rows[].evidenceRefs | array | obligatorio | Valor de Evidence refs usado por esta operación de API. |
data.result.rows[].evidenceRefs[] | string | obligatorio | Elemento de data result rows[] evidenceRefs. |
data.result.rows[].id | string | obligatorio | Valor de Id usado por esta operación de API. Patrón: ^[A-Za-z0-9_-]{1,64}$ |
data.result.rows[].label | string | obligatorio | Valor de Label usado por esta operación de API. Permitidos: relevant, irrelevant, uncertain |
data.result.rows[].reasonCodes | array | obligatorio | Valor de Reason codes usado por esta operación de API. |
data.result.rows[].reasonCodes[] | string | obligatorio | Elemento de data result rows[] reasonCodes. |
Keyword cluster fit row
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.rows[] | object | obligatorio | Elemento de data result rows. |
data.result.rows[].candidateId | string | null | obligatorio | Valor de Candidate id usado por esta operación de API. |
data.result.rows[].confidence | number | obligatorio | Valor de Confidence usado por esta operación de API. Mínimo: 0 Máximo: 1 |
data.result.rows[].id | string | obligatorio | Valor de Id usado por esta operación de API. Patrón: ^[A-Za-z0-9_-]{1,64}$ |
data.result.rows[].label | string | obligatorio | Valor de Label usado por esta operación de API. Permitidos: same_page, separate_page, uncertain |
data.result.rows[].reasonCodes | array | obligatorio | Valor de Reason codes usado por esta operación de API. |
data.result.rows[].reasonCodes[] | string | obligatorio | Elemento de data result rows[] reasonCodes. |
data.result.rows[].samePage | boolean | obligatorio | Valor de Same page usado por esta operación de API. |
data.result.rows[].sameTopic | boolean | obligatorio | Valor de Same topic usado por esta operación de API. |
Amazon keyword product fit row
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.rows[] | object | obligatorio | Elemento de data result rows. |
data.result.rows[].confidence | number | obligatorio | Valor de Confidence usado por esta operación de API. Mínimo: 0 Máximo: 1 |
data.result.rows[].evidenceRefs | array | obligatorio | Valor de Evidence refs usado por esta operación de API. |
data.result.rows[].evidenceRefs[] | string | obligatorio | Elemento de data result rows[] evidenceRefs. |
data.result.rows[].id | string | obligatorio | Valor de Id usado por esta operación de API. Patrón: ^[A-Za-z0-9_-]{1,64}$ |
data.result.rows[].label | string | obligatorio | Valor de Label usado por esta operación de API. Permitidos: match, partial, conflict, unknown |
data.result.rows[].reasonCodes | array | obligatorio | Valor de Reason codes usado por esta operación de API. |
data.result.rows[].reasonCodes[] | string | obligatorio | Elemento de data result rows[] reasonCodes. |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Compruebe la declaración “Nunca comparta contraseñas. Contacte con el servicio de atención al cliente a través del sitio web oficial.
Explicación ilustrativa de la respuesta
El resultado ilustrativo vuelve a pasar con la razón de que ninguna regla fue activada. Esta decisión consultiva no envía el texto ni aprueba otra medida.
Sobre esta muestra: Ejemplo de formato ilustrativo con valores ficticios, no una llamada de herramienta en vivo. Sustitúyase entradas de ejemplo con sus propios activos permitidos o identificadores públicos. Las etiquetas modelo y catálogo en esta ilustración son ficticias, no identificadores para seleccionar para una solicitud en vivo.
No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.
Ver el formato de solicitud y respuesta MCP
Ejemplos
Ejemplo ilustrativo con datos ficticios, no 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": "jev-evaluate-example",
"method": "tools/call",
"params": {
"name": "nexscope_jev_evaluate",
"arguments": {
"input": {
"content": "Never share passwords. Contact customer support through the official website."
},
"useCase": "response_guardrails"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "jev-evaluate-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"data\":{\"checks\":{},\"decision\":\"pass\",\"model\":\"example-model\",\"policyVersion\":\"jev-evaluation-v1\",\"reasonCodes\":[\"no_rule_triggered\"],\"result\":{},\"useCase\":\"response_guardrails\"},\"msg\":\"success\"}"
}
],
"structuredContent": {
"code": 0,
"data": {
"checks": {},
"decision": "pass",
"model": "example-model",
"policyVersion": "jev-evaluation-v1",
"reasonCodes": [
"no_rule_triggered"
],
"result": {},
"useCase": "response_guardrails"
},
"msg": "success"
},
"isError": false
}
}