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
Servidor MCP de CompetLab
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 Remoto | Servidor Local | |
|---|---|---|
| Transporte | HTTP Streamable | stdio |
| Configuración | Sin instalación: solo agrega la URL | npm install && npm run build |
| Ideal para | La mayoría de los usuarios: Claude Code, Cursor, VS Code, Windsurf, Cline | Claude 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ón | Qué rastrea |
|---|---|
| Visibilidad en IA | Qué 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 IA | Las páginas que Perplexity y los resúmenes de Google AI leen cuando responden las preguntas de tus compradores, y si apareces en ellas |
| Posicionamiento | Mensajes de la página de inicio, propuestas de valor, llamados a la acción, público objetivo, diferenciadores |
| Precios | Planes, modelos de facturación, niveles gratuitos, estadísticas de precios de mercado, análisis de brechas |
| Contenido | Análisis del mapa del sitio, categorización de contenido (12 categorías), registro de cambios de URL, brechas de contenido |
| Tecnología y Confianza | Pilas 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
| Herramienta | Descripción |
|---|---|
list_projects | Lista todos los proyectos con estado, cantidad de competidores y última marca de tiempo monitoreada |
get_project | Obtén detalles del proyecto con frescura de monitoreo por dimensión |
list_competitors | Lista todos los competidores monitoreados (incluye tu propio dominio para comparar) |
get_competitor | Obtén detalles del competidor, incluidas las URL de páginas monitoreadas |
Visibilidad en IA
| Herramienta | Descripción |
|---|---|
get_ai_visibility_dashboard | El 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_history | Historial paginado de verificaciones de Visibilidad en IA |
get_ai_visibility_check_detail | Detalle 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_trend | Có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
| Herramienta | Descripción |
|---|---|
get_ai_sources_dashboard | Las 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_history | Historial paginado de verificaciones de Fuentes de IA |
get_ai_sources_check_detail | Detalle 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
| Herramienta | Descripción |
|---|---|
get_positioning_dashboard | Mensajes 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_history | Historial paginado de ejecuciones de monitoreo |
get_positioning_run_detail | Datos completos de una ejecución de posicionamiento específica |
Inteligencia de Precios
| Herramienta | Descripción |
|---|---|
get_pricing_dashboard | Planes de precios más recientes, opciones de facturación, estadísticas de mercado, análisis de brechas |
get_pricing_history | Historial paginado de ejecuciones de monitoreo |
get_pricing_run_detail | Datos completos de una ejecución de precios específica |
Inteligencia de Contenido
| Herramienta | Descripción |
|---|---|
get_content_dashboard | Análisis más reciente del mapa del sitio, categorización de contenido, URL estratégicas, análisis de brechas |
get_content_history | Historial paginado de ejecuciones de monitoreo |
get_content_run_detail | Datos completos de una ejecución de contenido específica |
get_content_changelog | Cambios de URL detectados a lo largo del tiempo (agregadas, eliminadas); filtrable por competidor y categoría |
Perfil de Tecnología y Confianza
| Herramienta | Descripción |
|---|---|
get_tech_trust_dashboard | Encabezados de seguridad más recientes, señales de confianza, pilas tecnológicas, DNS y acceso por asistente de IA |
get_tech_trust_history | Historial paginado de ejecuciones de monitoreo |
get_tech_trust_run_detail | Datos completos competidor por competidor de una ejecución específica |
Informe Estratégico
| Herramienta | Descripción |
|---|---|
get_briefing | Estado 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_history | Ediciones pasadas del briefing, de más reciente a más antigua — fecha de publicación, estado y veredicto principal por edición |
get_briefing_edition | Una 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).
| Herramienta | Descripción |
|---|---|
list_tickets | Los 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_ticket | Un ticket completo — descripción, etiquetas, responsable, fecha de vencimiento, esfuerzo, impacto y la longitud de su hilo |
create_ticket | Abre un ticket en el tablero de un proyecto. Requiere una clave de API de lectura/escritura |
update_ticket | Cambia 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_ticket | Mueve 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_ticket | Elimina un ticket y su hilo. Requiere una clave de API de lectura/escritura |
list_ticket_comments | El 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_comment | Añade un comentario en Markdown al hilo de un ticket. Requiere una clave de API de lectura/escritura |
list_ticket_labels | Las etiquetas de tickets de un proyecto — cada una con un nombre y un color |
list_ticket_assignees | A quién se puede asignar un ticket — los miembros actuales de la organización, por nombre e ID |
Alertas y Programaciones
| Herramienta | Descripción |
|---|---|
list_alerts | Alertas de cambios competitivos — filtrables por dimensión, severidad y competidor |
list_schedules | Programaciones 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.
| Herramienta | Descripción |
|---|---|
check_sitemap | Análisis de sitemap en vivo — descubre URLs, las categoriza por sección e informa profundidad, frescura y recuentos por categoría |
check_ai_crawlers | Verificació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_scan | Inicia detección asíncrona de stack tecnológico (117 reglas: tecnología / crecimiento / engagement). Devuelve scanId |
get_tech_stack_scan | Consulta un escaneo de stack tecnológico por scanId — devuelve las tecnologías detectadas con puntuaciones de confianza cuando esté completo |
start_trust_signals_scan | Inicia 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_scan | Consulta un escaneo de señales de confianza por scanId — devuelve veredictos por señal y veredicto de nivel cuando esté completo |
start_agent_adoption_scan | Inicia verificación asíncrona de adopción por agentes (25 verificaciones: descubribilidad, acceso, legibilidad, endpoints de agentes). Devuelve scanId |
get_agent_adoption_scan | Consulta una verificación de adopción por agentes por scanId — devuelve resultados completos cuando termine |
fetch_url | Obté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
- Regístrate en app.competlab.com/register (prueba gratuita de 14 días, sin tarjeta de crédito)
- Ve a Configuración de la Organización > Claves de API
- Crea una nueva clave — comienza con
cl_live_
Dos métodos de autenticación
| Método | Cuándo usarlo | Ejemplo |
|---|---|---|
Encabezado CL-API-Key | Claude Code, Cursor, VS Code, Windsurf, Cline | CL-API-Key: cl_live_... |
Parámetro de consulta api_key | Claude 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
| Problema | Solución |
|---|---|
| Conexión rechazada / tiempo de espera | Verifica que la URL sea exactamente https://mcp.competlab.com/mcp sin barra final |
Error de api_key_missing | Asegúrate de pasar la clave como encabezado CL-API-Key (remoto) o como variable de entorno COMPETLAB_API_KEY (stdio) |
Error de api_key_invalid | Las claves deben comenzar con cl_live_ y tener exactamente 40 caracteres |
| Transporte no soportado | Usa el servidor HTTP remoto, o cambia al servidor stdio local |
Enlaces
- Documentación del Servidor MCP
- Referencia de la API REST
- SDK de TypeScript (
npm install @competlab/sdk) - Política de Privacidad
- Iniciar Prueba Gratuita
Soporte
- Informes de errores: GitHub Issues
- Correo electrónico: support@competlab.com
- Documentación: competlab.com/developers
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.