CompetLab

Plataforma de inteligencia competitiva con 24 herramientas: monitorea precios de la competencia, contenido, posicionamiento, stacks tecnológicos y cómo ChatGPT, Claude y Gemini clasifican tu marca.

Documentación

CompetLab MCP Server — Competitive Intelligence for AI Agents

Servidor MCP de CompetLab

MCP TypeScript License: MIT 48 Tools

Glama

Inteligencia competitiva para agentes de IA: mira hacia dónde la IA envía a tus compradores y qué hacer al respecto.

Cada vez más compradores B2B consultan a la IA antes de buscar en Google. CompetLab monitorea a los competidores en 6 dimensiones, incluida la Visibilidad en IA, que rastrea qué marcas recomiendan ChatGPT, Claude, Gemini, Perplexity y los resúmenes de Google AI, y las Fuentes de IA, las páginas que Perplexity y los resúmenes de Google AI leen cuando responden las preguntas de tus compradores. Este servidor MCP le da a tu agente de IA acceso a todo: paneles, datos históricos, alertas, el Informe Estratégico y el tablero de Tickets Estratégicos del proyecto.

Clientes Compatibles

Funciona con cualquier cliente compatible con MCP:

Inicio Rápido

Dos formas de conectarte: elige la que se adapte a tu configuración:

Servidor RemotoServidor Local
TransporteHTTP Streamablestdio
ConfiguraciónSin instalación: solo agrega la URLnpm install && npm run build
Ideal paraLa mayoría de los usuarios: Claude Code, Cursor, VS Code, Windsurf, ClineClaude Desktop, Glama, o ejecutar el proceso tú mismo

Obtén tu clave API: app.competlab.com > Configuración de la organización > Claves API

Opción 1: Servidor Remoto (recomendado)

URL del servidor: https://mcp.competlab.com/mcp Autenticación: Clave API mediante el encabezado CL-API-Key (o el parámetro de consulta api_key)

Claude Code

claude mcp add --transport http \
  --header "CL-API-Key: YOUR_COMPETLAB_API_KEY" \
  competlab https://mcp.competlab.com/mcp

Cursor

Agrégalo a .cursor/mcp.json:

{
  "mcpServers": {
    "competlab": {
      "url": "https://mcp.competlab.com/mcp",
      "headers": {
        "CL-API-Key": "YOUR_COMPETLAB_API_KEY"
      }
    }
  }
}

VS Code

Agrégalo a .vscode/mcp.json:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "competlab-api-key",
      "description": "CompetLab API Key (starts with cl_live_)",
      "password": true
    }
  ],
  "servers": {
    "competlab": {
      "type": "http",
      "url": "https://mcp.competlab.com/mcp",
      "headers": {
        "CL-API-Key": "${input:competlab-api-key}"
      }
    }
  }
}

Nota: VS Code usa "servers" (no "mcpServers") y admite indicaciones de entrada seguras mediante ${input:id}.

Windsurf

Agrégalo a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "competlab": {
      "serverUrl": "https://mcp.competlab.com/mcp",
      "headers": {
        "CL-API-Key": "YOUR_COMPETLAB_API_KEY"
      }
    }
  }
}

Nota: Windsurf usa "serverUrl" (no "url").

Cline

Agrégalo a cline_mcp_settings.json (o configúralo mediante la interfaz de Cline > Instalado > Configuración avanzada de MCP):

{
  "mcpServers": {
    "competlab": {
      "url": "https://mcp.competlab.com/mcp",
      "headers": {
        "CL-API-Key": "YOUR_COMPETLAB_API_KEY"
      },
      "disabled": false
    }
  }
}

Claude Desktop / Claude Web

Claude Desktop y Claude Web solo admiten autenticación basada en URL (sin encabezados personalizados). Usa el parámetro de consulta api_key:

Ve a Configuración > MCP y agrega el servidor con esta URL:

https://mcp.competlab.com/mcp?api_key=YOUR_COMPETLAB_API_KEY

Opción 2: Servidor Local (stdio)

Ejecuta el servidor localmente mediante stdin/stdout. Útil para Claude Desktop, Glama o entornos que prefieren el transporte stdio.

git clone https://github.com/competlab/competlab-mcp-server.git
cd competlab-mcp-server
npm install
npm run build

Claude Code

claude mcp add --transport stdio \
  --env COMPETLAB_API_KEY=YOUR_COMPETLAB_API_KEY \
  competlab node dist/index.js

Claude Desktop

Agrégalo a tu configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "competlab": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/competlab-mcp-server",
      "env": {
        "COMPETLAB_API_KEY": "YOUR_COMPETLAB_API_KEY"
      }
    }
  }
}

stdio genérico

COMPETLAB_API_KEY=YOUR_COMPETLAB_API_KEY node dist/index.js

El servidor lee JSON-RPC desde stdin y escribe las respuestas en stdout.

Consulta examples/ para ver archivos de configuración listos para copiar y pegar en cada cliente.

¿Qué es CompetLab?

Inteligencia competitiva para la era de la IA: 14 dimensiones (6 monitoreadas continuamente, más 8 dimensiones de vanguardia investigadas para el Informe Estratégico mensual). Las seis dimensiones monitoreadas:

DimensiónQué rastrea
Visibilidad en IAQué empresas recomiendan ChatGPT, Claude, Gemini, Perplexity y los resúmenes de Google AI en tu categoría, con qué frecuencia se menciona cada una y dónde te ubicas
Fuentes de IALas páginas que Perplexity y los resúmenes de Google AI leen cuando responden las preguntas de tus compradores, y si apareces en ellas
PosicionamientoMensajes de la página de inicio, propuestas de valor, llamados a la acción, público objetivo, diferenciadores
PreciosPlanes, modelos de facturación, niveles gratuitos, estadísticas de precios de mercado, análisis de brechas
ContenidoAnálisis del mapa del sitio, categorización de contenido (12 categorías), registro de cambios de URL, brechas de contenido
Tecnología y ConfianzaPilas tecnológicas, encabezados de seguridad (calificación A-F), señales de confianza (26 señales en 5 categorías), acceso por asistente de IA

La Visibilidad en IA responde a quién recomienda la IA: qué marcas mencionan y recomiendan ChatGPT, Claude, Gemini, Perplexity y los resúmenes de Google AI cuando tus compradores preguntan, y si estás en el núcleo. Las Fuentes de IA son su complemento: las páginas que Perplexity y los resúmenes de Google AI recuperan para llegar a esas respuestas, y si te mencionan.

Inicia una prueba gratuita (14 días, sin tarjeta de crédito) | Más información

Herramientas Disponibles

48 herramientas. 40 son de solo lectura; 3 son iniciadores de escaneo asíncrono que crean un registro de escaneo (start_tech_stack_scan, start_trust_signals_scan, start_agent_adoption_scan); 5 escriben en el tablero de Tickets Estratégicos del proyecto (create_ticket, update_ticket, move_ticket, delete_ticket, add_ticket_comment) y necesitan una clave API de read_write.

Proyectos y Competidores

HerramientaDescripción
list_projectsLista todos los proyectos con estado, cantidad de competidores y última marca de tiempo monitoreada
get_projectObtén detalles del proyecto con frescura de monitoreo por dimensión
list_competitorsLista todos los competidores monitoreados (incluye tu propio dominio para comparar)
get_competitorObtén detalles del competidor, incluidas las URL de páginas monitoreadas

Visibilidad en IA

HerramientaDescripción
get_ai_visibility_dashboardEl mapa del mercado: qué empresas recomiendan los modelos de IA en tu categoría y si eres una de ellas, con desgloses por modelo; opcionalmente, las respuestas crudas de los modelos
get_ai_visibility_historyHistorial paginado de verificaciones de Visibilidad en IA
get_ai_visibility_check_detailDetalle completo de una verificación y, opcionalmente, lo que dijo cada modelo; filtrable por competidor, modelo o pregunta; una lectura de respuestas viene sin el resumen a menos que lo solicites (includeSummary)
get_ai_visibility_trendCómo se ha movido el mercado que los modelos de IA utilizan en un período: la lectura de cada empresa ahora y al inicio, y la diferencia; legible por modelo de IA

Fuentes de IA

HerramientaDescripción
get_ai_sources_dashboardLas páginas que Perplexity y los resúmenes de Google AI leen cuando responden las preguntas de compra del proyecto, por motor: qué empresas mencionó cada uno, qué páginas recuperó y las páginas que mencionan a otras empresas y no a ti
get_ai_sources_historyHistorial paginado de verificaciones de Fuentes de IA
get_ai_sources_check_detailDetalle completo de una verificación de Fuentes de IA y, opcionalmente, cada respuesta y página recuperada; filtrable por motor o pregunta; una lectura de respuestas viene sin el resumen a menos que lo solicites (includeSummary)

Posicionamiento

HerramientaDescripción
get_positioning_dashboardMensajes más recientes de la página de inicio, propuestas de valor, llamados a la acción, análisis del público objetivo
get_positioning_historyHistorial paginado de ejecuciones de monitoreo
get_positioning_run_detailDatos completos de una ejecución de posicionamiento específica

Inteligencia de Precios

HerramientaDescripción
get_pricing_dashboardPlanes de precios más recientes, opciones de facturación, estadísticas de mercado, análisis de brechas
get_pricing_historyHistorial paginado de ejecuciones de monitoreo
get_pricing_run_detailDatos completos de una ejecución de precios específica

Inteligencia de Contenido

HerramientaDescripción
get_content_dashboardAnálisis más reciente del mapa del sitio, categorización de contenido, URL estratégicas, análisis de brechas
get_content_historyHistorial paginado de ejecuciones de monitoreo
get_content_run_detailDatos completos de una ejecución de contenido específica
get_content_changelogCambios de URL detectados a lo largo del tiempo (agregadas, eliminadas); filtrable por competidor y categoría

Perfil de Tecnología y Confianza

HerramientaDescripción
get_tech_trust_dashboardEncabezados de seguridad más recientes, señales de confianza, pilas tecnológicas, DNS y acceso por asistente de IA
get_tech_trust_historyHistorial paginado de ejecuciones de monitoreo
get_tech_trust_run_detailDatos completos competidor por competidor de una ejecución específica

Informe Estratégico

HerramientaDescripción
get_briefingEstado actual del Briefing Estratégico del proyecto — qué cambió, qué significa y qué hizo la edición en el tablero: los tickets que abrió, los tickets ya existentes en los que comentó y los que emparejó en lugar de abrir un segundo. Por defecto usa el resumen de hub; pasa sections para abrir cualquiera de las 14 secciones de deep-<dimension>
get_briefing_historyEdiciones pasadas del briefing, de más reciente a más antigua — fecha de publicación, estado y veredicto principal por edición
get_briefing_editionUna edición pasada del briefing completa, por ID de ejecución

Tickets Estratégicos

El tablero del proyecto — el trabajo que el equipo ha decidido hacer, con un responsable, una columna y un hilo. Los mismos tickets que el equipo ve en la aplicación, en cinco columnas fijas: triage, todo, in_progress, done, dismissed. Cada movimiento en un Briefing Estratégico aterriza aquí — como un ticket nuevo en triage, primero los más importantes, o en el ticket ya existente para ese trabajo — y una edición posterior comenta en los tickets ya existentes cuando midió algo sobre ellos. Toda herramienta que acepta un ID de ticket también acepta el número del ticket tal como lo escribe una persona, #14. Una clave de read lista y lee tickets; las herramientas que escriben necesitan una clave de read_write. Las herramientas de tickets requieren una suscripción activa (402 subscription_required en caso contrario).

HerramientaDescripción
list_ticketsLos Tickets Estratégicos de un proyecto, de una página a la vez — en orden de tablero, o por prioridad, fecha de vencimiento o actividad reciente; filtrables por columna, responsable, etiqueta, impacto, esfuerzo, fecha de vencimiento y la edición que los abrió. Cada página incluye el total y el recuento por columna
get_ticketUn ticket completo — descripción, etiquetas, responsable, fecha de vencimiento, esfuerzo, impacto y la longitud de su hilo
create_ticketAbre un ticket en el tablero de un proyecto. Requiere una clave de API de lectura/escritura
update_ticketCambia el título, la descripción, las etiquetas, el responsable, la fecha de vencimiento, el esfuerzo o el impacto de un ticket. Requiere una clave de API de lectura/escritura
move_ticketMueve un ticket a otra columna, o lo reordena — al principio o al final, o entre dos tickets nombrados; la respuesta indica dónde quedó. Requiere una clave de API de lectura/escritura
delete_ticketElimina un ticket y su hilo. Requiere una clave de API de lectura/escritura
list_ticket_commentsEl hilo de comentarios de un ticket, de más antiguo a más reciente — cada entrada indica si la escribió una persona, una clave de API o un Briefing Estratégico
add_ticket_commentAñade un comentario en Markdown al hilo de un ticket. Requiere una clave de API de lectura/escritura
list_ticket_labelsLas etiquetas de tickets de un proyecto — cada una con un nombre y un color
list_ticket_assigneesA quién se puede asignar un ticket — los miembros actuales de la organización, por nombre e ID

Alertas y Programaciones

HerramientaDescripción
list_alertsAlertas de cambios competitivos — filtrables por dimensión, severidad y competidor
list_schedulesProgramaciones de monitoreo para las 6 dimensiones monitoreadas, con estado e intervalos

Herramientas Gratuitas (sin configuración de proyecto)

Ejecútalas contra cualquier dominio público — no se necesita projectId. Las herramientas de sincronización devuelven resultados inmediatamente; los escaneos asíncronos devuelven un scanId que debes consultar cada 5–10 segundos.

HerramientaDescripción
check_sitemapAnálisis de sitemap en vivo — descubre URLs, las categoriza por sección e informa profundidad, frescura y recuentos por categoría
check_ai_crawlersVerificación en vivo de qué asistentes de IA (ChatGPT, Claude, Perplexity, Microsoft Copilot, Google AI Overviews, Gemini Apps) pueden acceder a las páginas de un sitio, leyendo su robots.txt
start_tech_stack_scanInicia detección asíncrona de stack tecnológico (117 reglas: tecnología / crecimiento / engagement). Devuelve scanId
get_tech_stack_scanConsulta un escaneo de stack tecnológico por scanId — devuelve las tecnologías detectadas con puntuaciones de confianza cuando esté completo
start_trust_signals_scanInicia análisis asíncrono de señales de confianza (34 señales en preparación empresarial, validación, prueba social, autoridad, riesgo). Devuelve scanId
get_trust_signals_scanConsulta un escaneo de señales de confianza por scanId — devuelve veredictos por señal y veredicto de nivel cuando esté completo
start_agent_adoption_scanInicia verificación asíncrona de adopción por agentes (25 verificaciones: descubribilidad, acceso, legibilidad, endpoints de agentes). Devuelve scanId
get_agent_adoption_scanConsulta una verificación de adopción por agentes por scanId — devuelve resultados completos cuando termine
fetch_urlObtén cualquier URL con renderizado de JS y manejo de protección contra bots. Devuelve cuerpo, encabezados, cleanStats. El cleanHtml opcional elimina ruido para ahorrar costos de tokens de LLM. 60 req/min por clave de API

Todas las herramientas paginadas aceptan los parámetros page y limit. Consulta pagination.hasMore en la respuesta para obtener más páginas.

Los paneles de Visibilidad de IA y Fuentes de IA, los detalles de verificación, el historial de Visibilidad de IA y el panel de Tecnología y Confianza responden en una vista compacta por defecto: el mapa de mercado, la lista de páginas y la lista de marcas vienen de una página a la vez, con tu propia fila — y, en el mapa de mercado, la de cada competidor rastreado — siempre en la página y un objeto *Page (offset, limit, total, hasMore) que indica cuántas filas hay. Pasa view=full para obtener todas las filas en una sola respuesta. Cada una de estas respuestas comienza con readingGuide, las reglas de lectura para sus campos.

Las respuestas se transmiten sin cambios desde la API de CompetLab, y las instrucciones del servidor le dicen a tu agente cómo leerlas — sobre todo, null significa que CompetLab no midió un valor, nunca cero o "no".

Ejemplos de Prompts

Una vez conectado, prueba a preguntarle a tu agente de IA:

  • "¿Qué empresas recomiendan los modelos de IA en mi categoría — y soy una de ellas?"
  • "¿Qué páginas leen Perplexity y Google AI Overviews para las preguntas de mis compradores que mencionan a mis competidores pero no a mí?"
  • "¿Qué cambió en las páginas de precios de mis competidores esta semana?"
  • "Muéstrame el briefing estratégico — ¿qué debería arreglar primero?"
  • "¿Qué tickets abrió el último briefing y en qué punto están en nuestro tablero?"
  • "¿Cómo ha evolucionado el mapa de mercado de IA en los últimos 3 meses?"
  • "Compara las estrategias de contenido de todos mis competidores rastreados"
  • "¿Qué alertas críticas se dispararon en los últimos 7 días?"
  • "¿Qué competidores tienen mejores encabezados de seguridad que nosotros?"
  • "Ejecuta un escaneo de stack tecnológico en stripe.com — ¿qué están usando?"
  • "¿Qué asistentes de IA pueden acceder a openai.com, según su robots.txt?"
  • "Obtén g2.com/some-listing con cleanHtml y resume la página"

Consulta examples/prompts.md para más prompts organizados por caso de uso.

Autenticación

Cómo obtener una clave de API

  1. Regístrate en app.competlab.com/register (prueba gratuita de 14 días, sin tarjeta de crédito)
  2. Ve a Configuración de la Organización > Claves de API
  3. Crea una nueva clave — comienza con cl_live_

Dos métodos de autenticación

MétodoCuándo usarloEjemplo
Encabezado CL-API-KeyClaude Code, Cursor, VS Code, Windsurf, ClineCL-API-Key: cl_live_...
Parámetro de consulta api_keyClaude Desktop, Claude Web, clientes sin soporte de encabezados personalizados?api_key=cl_live_...

Una clave de API cubre toda tu organización. La mayoría de las herramientas son de solo lectura; las tres herramientas de start_*_scan crean registros de escaneo bajo tu cuenta (sin ediciones a datos existentes), y las cinco herramientas de escritura de Tickets Estratégicos cambian el tablero del proyecto — necesitan una clave de read_write, y una clave de read es rechazada en ellas. La herramienta fetch_url tiene un límite de 60 req/min por clave de API (más estricto que el límite predeterminado de 1000/min para otras herramientas gratuitas).

Precios

El acceso a MCP está incluido con cada suscripción de CompetLab ($99/mes). La prueba gratuita incluye acceso completo a MCP.

Solución de Problemas

ProblemaSolución
Conexión rechazada / tiempo de esperaVerifica que la URL sea exactamente https://mcp.competlab.com/mcp sin barra final
Error de api_key_missingAsegúrate de pasar la clave como encabezado CL-API-Key (remoto) o como variable de entorno COMPETLAB_API_KEY (stdio)
Error de api_key_invalidLas claves deben comenzar con cl_live_ y tener exactamente 40 caracteres
Transporte no soportadoUsa el servidor HTTP remoto, o cambia al servidor stdio local

Enlaces

Soporte

Licencia

MIT (cubre la documentación y configuraciones en este repositorio) — consulta LICENSE

El servidor MCP de CompetLab y la plataforma son software comercial. Consulta competlab.com/terms-and-conditions.


Construido por el equipo de CompetLab. Inteligencia competitiva para la era de la IA.

Share on X Share on LinkedIn