getAdvantage MCP

Documentación de API y MCP

Ejecuta los tres análisis de Advantage desde tu propio código, tu CI o desde dentro de tu editor de IA. Get Found mide cómo la IA lee una URL en vivo. Convert mide si un visitante por primera vez se registraría. Ship Verified comprueba qué ha publicado la página que no debería haber publicado. Cada resultado es una medición observada en el momento del análisis, nunca un veredicto, certificación o garantía.

La API es gratuita para probar sin clave a una tarifa por IP. Una clave de API eleva la tarifa al nivel de tu plan y devuelve la salida del modelo en vivo en un plan de pago. La especificación legible por máquina está en /api/openapi.json.

¿Por qué conectarla una sola vez? Para no mantener AEO manualmente. Añade el embed o una llamada a la API en tu CI y las correcciones seguras para el DOM (JSON-LD, meta, FAQ) se siguen aplicando solas; nosotros re-comprobamos a medida que ChatGPT, Perplexity, Gemini y Claude cambian la forma en que leen los sitios, para que tus puntuaciones se mantengan actualizadas sin que tengas que perseguir el objetivo. Una herramienta neutral vigila continuamente la visibilidad en IA y la seguridad de lo publicado: supervisión independiente, no una auditoría puntual. (Tus llms.txt y robots.txt siguen siendo archivos que colocas una sola vez).

Autenticación

Crea una clave en /app/api-keys (se muestra una sola vez: guárdala como secreto de entorno, nunca la confirmes). Envíala como token Bearer en cualquier solicitud:

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com" \
  -H "Authorization: Bearer adv_live_…"

Sin la cabecera obtienes el nivel gratuito sin clave (tarifa por IP, salida muestreada). Con una clave, la tarifa sigue tu plan y un plan de pago devuelve la salida del modelo en vivo. Superar el límite devuelve HTTP 429 con una cabecera retry-after; una clave no válida devuelve 401.

Límites de tarifa

Los límites se observan por clave (o por IP, sin clave) en el momento de la solicitud:

• Sin clave: 5/min · 30/día, salida muestreada
• Starter: 60/min · 1.000/día, salida en vivo
• Pro: 120/min · 5.000/día, salida en vivo
• Agency: 240/min · 20.000/día (uso justo), salida en vivo

El endpoint combinado cuenta como un solo tick a la misma tarifa por motor (nunca cobra tres veces por una llamada).

Endpoints

GET /api/analyze?url=

Get Found — análisis de legibilidad para IA (9 señales)

Puntúa cuán legible es la página para los motores de IA en nueve señales (título, meta descripción, datos estructurados, encabezados, llms.txt, proporción contenido-a-markup, Open Graph, canónico, robots). Devuelve un desglose por señal, correcciones listas para pegar y un llms.txt inicial generado.

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com"

GET /api/verify-convert?url=

Convert — preparación para conversión + lectura rápida de 5 segundos

Puntúa las señales que deciden si un visitante por primera vez entiende la aplicación y se registra. Con una clave de pago también ejecuta una prueba de primera impresión agéntica de 5 segundos. Devuelve comprobaciones, correcciones, un percentil de referencia y un informe /v compartible.

curl "https://getadvantage.app/api/verify-convert?url=https://yourapp.com"

GET /api/verify-safety?url=

Ship Verified — comprobaciones de seguridad de lo publicado + insignia

Ejecuta comprobaciones deterministas para exposiciones comunes de código "vibe-coded" (secretos en el bundle del cliente, configuración del backend, archivos expuestos, cabeceras de seguridad, CORS, transporte, source maps). Una comprobación superada significa que no encontramos ese problema específico, nunca que la aplicación sea segura o esté certificada. Devuelve comprobaciones, correcciones, un percentil de referencia, un informe /v y una insignia "Checked by Advantage".

curl "https://getadvantage.app/api/verify-safety?url=https://yourapp.com"

POST /api/v1/scan/combined

Combinado — los tres motores, una llamada

Ejecuta los tres motores sobre una URL y devuelve un solo payload: tres bloques de puntuación independientes (nunca promediados), un resumen de intersección que nombra la dimensión más débil y el siguiente movimiento más grande, y un permalink. La forma más rápida de obtener la imagen completa en una sola solicitud.

curl -X POST "https://getadvantage.app/api/v1/scan/combined" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer adv_live_…" \
  -d '{"url":"https://yourapp.com"}'

Servidor MCP — analiza desde dentro de tu editor

Advantage también es un servidor Model Context Protocol, así que puedes añadirlo una vez a Claude Code, Cursor, Claude Desktop o Windsurf y simplemente escribir "scan my app with getadvantage". Habla HTTP remoto Streamable (el transporte remoto oficial actual): cero instalación, los análisis se ejecutan en nuestros servidores. Expone cuatro herramientas: get_found, convert_check, ship_verified y combined_scan. Cada una lidera con la puntuación y la corrección más grande lista para pegar, e incluye el enlace del informe.

Añadirlo (Cursor / Claude Desktop / Claude Code)

Coloca esto en la configuración de tu cliente MCP:

{
  "mcpServers": {
    "getadvantage": {
      "url": "https://getadvantage.app/api/mcp"
    }
  }
}

Con una clave de API (tarifa más alta, salida en vivo), añade la cabecera:

{
  "mcpServers": {
    "getadvantage": {
      "url": "https://getadvantage.app/api/mcp",
      "headers": { "Authorization": "Bearer adv_live_…" }
    }
  }
}

O, en Claude Code, una línea:

claude mcp add --transport http getadvantage https://getadvantage.app/api/mcp

El servidor MCP es gratuito para probar sin clave a la tarifa sin clave; una clave eleva la tarifa y devuelve salida en vivo, exactamente igual que la API HTTP.

¿Quieres rastrear sitios, ver historial y aplicar correcciones automáticamente mediante el embed? Crea una cuenta — o analiza una aplicación gratis primero.