CompetLab

Plataforma de inteligência competitiva com 24 ferramentas — monitore preços, conteúdo, posicionamento, stacks tecnológicos dos concorrentes e como ChatGPT, Claude e Gemini ranqueiam sua marca.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP CompetLab

Inteligência competitiva para agentes de IA — veja para onde a IA envia seus compradores e o que fazer a respeito.

Mais compradores B2B estão perguntando à IA antes de recorrer ao Google. O CompetLab monitora concorrentes em 6 dimensões — incluindo Visibilidade em IA, que rastreia quais marcas o ChatGPT, Claude, Gemini, Perplexity e os Resumos de IA do Google recomendam, e Fontes de IA, as páginas que o Perplexity e os Resumos de IA do Google leem ao responder às perguntas dos seus compradores. Este servidor MCP dá ao seu agente de IA acesso a tudo isso: painéis, dados históricos, alertas, o Briefing Estratégico e o quadro de Tickets Estratégicos do projeto.

Clientes Suportados

Funciona com qualquer cliente compatível com MCP:

Início Rápido

Duas formas de conectar — escolha a que se adapta à sua configuração:

	Servidor Remoto	Servidor Local
Transporte	HTTP Streamable	stdio
Configuração	Zero instalação — basta adicionar a URL	`npm install && npm run build`
Melhor para	A maioria dos usuários — Claude Code, Cursor, VS Code, Windsurf, Cline	Claude Desktop, Glama, ou executar o processo você mesmo

Obtenha sua chave de API: app.competlab.com > Configurações da Organização > Chaves de API

Opção 1: Servidor Remoto (recomendado)

URL do servidor: https://mcp.competlab.com/mcp Autenticação: chave de API via cabeçalho CL-API-Key (ou 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

Adicione ao .cursor/mcp.json:

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

VS Code

Adicione ao .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: O VS Code usa "servers" (não "mcpServers") e suporta prompts de entrada seguros via ${input:id}.

Windsurf

Adicione ao ~/.codeium/windsurf/mcp_config.json:

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

Nota: O Windsurf usa "serverUrl" (não "url").

Cline

Adicione ao cline_mcp_settings.json (ou configure via UI do Cline > Instalado > Configurações Avançadas de MCP):

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

Claude Desktop / Claude Web

O Claude Desktop e o Claude Web suportam apenas autenticação baseada em URL (sem cabeçalhos personalizados). Use o parâmetro de consulta api_key:

Vá para Configurações > MCP e adicione o servidor com esta URL:

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

Opção 2: Servidor Local (stdio)

Execute o servidor localmente via stdin/stdout. Útil para Claude Desktop, Glama ou ambientes que preferem 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

Adicione à configuração do seu 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

O servidor lê JSON-RPC do stdin e escreve respostas no stdout.

Consulte examples/ para arquivos de configuração prontos para copiar e colar para cada cliente.

O que é o CompetLab?

Inteligência competitiva para a era da IA: 14 dimensões — 6 monitoradas continuamente, mais 8 dimensões de ponta pesquisadas para o Briefing Estratégico mensal. As seis dimensões monitoradas:

Dimensão	O que rastreia
Visibilidade em IA	Quais empresas o ChatGPT, Claude, Gemini, Perplexity e os Resumos de IA do Google recomendam na sua categoria, com que frequência cada uma é citada e onde você está
Fontes de IA	As páginas que o Perplexity e os Resumos de IA do Google leem ao responder às perguntas dos seus compradores, e se você está nelas
Posicionamento	Mensagens da página inicial, propostas de valor, CTAs, público-alvo, diferenciais
Preços	Planos, modelos de cobrança, níveis gratuitos, estatísticas de preços de mercado, análise de lacunas
Conteúdo	Análise de sitemap, categorização de conteúdo (12 categorias), registro de alterações de URL, lacunas de conteúdo
Tecnologia e Confiança	Pilhas de tecnologia, cabeçalhos de segurança (nota A-F), sinais de confiança (26 sinais em 5 categorias), acesso de IA por assistente

A Visibilidade em IA responde quem a IA recomenda — quais marcas o ChatGPT, Claude, Gemini, Perplexity e os Resumos de IA do Google citam e recomendam quando seus compradores perguntam, e se você está no núcleo. As Fontes de IA são sua companheira: as páginas que o Perplexity e os Resumos de IA do Google recuperam no caminho para essas respostas, e se elas citam você.

Iniciar teste gratuito (14 dias, sem cartão de crédito) | Saiba mais

Ferramentas Disponíveis

48 ferramentas. 40 são somente leitura; 3 são iniciadores de varredura assíncrona que criam um registro de varredura (start_tech_stack_scan, start_trust_signals_scan, start_agent_adoption_scan); 5 gravam no quadro de Tickets Estratégicos do projeto (create_ticket, update_ticket, move_ticket, delete_ticket, add_ticket_comment) e precisam de uma chave de API read_write.

Projetos e Concorrentes

Ferramenta	Descrição
`list_projects`	Lista todos os projetos com status, número de concorrentes e último timestamp monitorado
`get_project`	Obtém detalhes do projeto com frescor de monitoramento por dimensão
`list_competitors`	Lista todos os concorrentes monitorados (inclui seu próprio domínio para comparação)
`get_competitor`	Obtém detalhes do concorrente, incluindo URLs de páginas monitoradas

Visibilidade em IA

Ferramenta	Descrição
`get_ai_visibility_dashboard`	O mapa do mercado — quais empresas os modelos de IA recomendam na sua categoria, e se você é uma delas — com detalhamentos por modelo; opcionalmente, as respostas brutas dos modelos
`get_ai_visibility_history`	Histórico paginado de verificações de Visibilidade em IA
`get_ai_visibility_check_detail`	Detalhe completo de uma verificação e, opcionalmente, o que cada modelo realmente disse — filtrável por concorrente, modelo ou prompt; uma leitura de respostas vem sem o resumo, a menos que você o solicite (`includeSummary`)
`get_ai_visibility_trend`	Como o mercado que os modelos de IA usam mudou ao longo de um período — a leitura de cada empresa agora e no início, e a diferença; legível por modelo de IA

Fontes de IA

Ferramenta	Descrição
`get_ai_sources_dashboard`	As páginas que o Perplexity e os Resumos de IA do Google leem ao responder às perguntas de compra do projeto, por mecanismo — quais empresas cada um citou, quais páginas recuperou e as páginas que citam outras empresas e não você
`get_ai_sources_history`	Histórico paginado de verificações de Fontes de IA
`get_ai_sources_check_detail`	Detalhe completo de uma verificação de Fontes de IA e, opcionalmente, todas as respostas e páginas recuperadas — filtrável por mecanismo ou pergunta; uma leitura de respostas vem sem o resumo, a menos que você o solicite (`includeSummary`)

Posicionamento

Ferramenta	Descrição
`get_positioning_dashboard`	Mensagens mais recentes da página inicial, propostas de valor, CTAs, análise de público-alvo
`get_positioning_history`	Histórico paginado de execuções de monitoramento
`get_positioning_run_detail`	Dados completos de uma execução específica de posicionamento

Inteligência de Preços

Ferramenta	Descrição
`get_pricing_dashboard`	Planos de preços mais recentes, opções de cobrança, estatísticas de mercado, análise de lacunas
`get_pricing_history`	Histórico paginado de execuções de monitoramento
`get_pricing_run_detail`	Dados completos de uma execução específica de preços

Inteligência de Conteúdo

Ferramenta	Descrição
`get_content_dashboard`	Análise de sitemap mais recente, categorização de conteúdo, URLs estratégicas, análise de lacunas
`get_content_history`	Histórico paginado de execuções de monitoramento
`get_content_run_detail`	Dados completos de uma execução específica de conteúdo
`get_content_changelog`	Alterações de URL detectadas ao longo do tempo (adicionadas, removidas) — filtrável por concorrente e categoria

Perfil de Tecnologia e Confiança

Ferramenta	Descrição
`get_tech_trust_dashboard`	Cabeçalhos de segurança mais recentes, sinais de confiança, pilhas de tecnologia, DNS e acesso de IA por assistente
`get_tech_trust_history`	Histórico paginado de execuções de monitoramento
`get_tech_trust_run_detail`	Dados completos concorrente por concorrente de uma execução específica

Briefing Estratégico

Ferramenta	Descrição
`get_briefing`	Estado atual do Briefing Estratégico do projeto — o que mudou, o que significa e o que a edição fez no quadro: os tickets que abriu, os tickets já existentes em que comentou e os que correspondeu em vez de abrir um segundo. Padrão para o resumo `hub`; passe `sections` para abrir qualquer uma das 14 seções de `deep-<dimension>`
`get_briefing_history`	Edições anteriores do briefing, das mais recentes para as mais antigas — data de publicação, status e veredito principal por edição
`get_briefing_edition`	Uma edição anterior do briefing completa, por ID de execução

Tickets Estratégicos

O quadro do projeto — o trabalho que a equipe decidiu fazer, com um responsável, uma coluna e um tópico. Os mesmos tickets que a equipe vê no aplicativo, em cinco colunas fixas: triage, todo, in_progress, done, dismissed. Cada movimento em um Briefing Estratégico chega aqui — como um novo ticket em triage, mais importante primeiro, ou no ticket já existente para aquele trabalho — e uma edição posterior comenta em tickets já existentes quando mediu algo sobre eles. Toda ferramenta que aceita um ID de ticket também aceita o número do ticket como uma pessoa o escreve, #14. Uma chave read lista e lê tickets; as ferramentas que escrevem precisam de uma chave read_write. As ferramentas de ticket precisam de uma assinatura ativa (402 subscription_required caso contrário).

Ferramenta	Descrição
`list_tickets`	Os Tickets Estratégicos de um projeto, uma página por vez — na ordem do quadro, ou por prioridade, data de vencimento ou atividade recente; filtráveis por coluna, responsável, etiqueta, impacto, esforço, data de vencimento e a edição que os abriu. Cada página traz o total e a contagem por coluna
`get_ticket`	Um ticket completo — descrição, etiquetas, responsável, data de vencimento, esforço, impacto e o tamanho do tópico
`create_ticket`	Abre um ticket no quadro de um projeto. Precisa de uma chave de API read_write
`update_ticket`	Altera o título, a descrição, as etiquetas, o responsável, a data de vencimento, o esforço ou o impacto de um ticket. Precisa de uma chave de API read_write
`move_ticket`	Move um ticket para outra coluna ou o reordena — para o topo ou o fundo, ou entre dois tickets nomeados; a resposta informa onde ele foi parar. Precisa de uma chave de API read_write
`delete_ticket`	Exclui um ticket e seu tópico. Precisa de uma chave de API read_write
`list_ticket_comments`	O tópico de comentários de um ticket, do mais antigo para o mais recente — cada entrada informa se foi escrita por uma pessoa, uma chave de API ou um Briefing Estratégico
`add_ticket_comment`	Adiciona um comentário em Markdown ao tópico de um ticket. Precisa de uma chave de API read_write
`list_ticket_labels`	As etiquetas de tickets de um projeto — cada uma com um nome e uma cor
`list_ticket_assignees`	A quem um ticket pode ser atribuído — os membros atuais da organização, por nome e ID

Alertas e Agendamentos

Ferramenta	Descrição
`list_alerts`	Alertas de mudança competitiva — filtráveis por dimensão, gravidade e concorrente
`list_schedules`	Agendamentos de monitoramento para todas as 6 dimensões monitoradas, com status e intervalos

Ferramentas Gratuitas (sem configuração de projeto necessária)

Execute-as em qualquer domínio público — sem necessidade de projectId. As ferramentas de sincronização retornam imediatamente; as varreduras assíncronas retornam um scanId que você consulta a cada 5–10 segundos.

Ferramenta	Descrição
`check_sitemap`	Análise de sitemap ao vivo — descobre URLs, categoriza-as por seção e relata profundidade, atualização e contagens por categoria
`check_ai_crawlers`	Verificação ao vivo de quais assistentes de IA (ChatGPT, Claude, Perplexity, Microsoft Copilot, Google AI Overviews, Gemini Apps) conseguem acessar as páginas de um site, ler seu robots.txt
`start_tech_stack_scan`	Inicia detecção assíncrona de stack tecnológica (117 regras: tecnologia / crescimento / engajamento). Retorna `scanId`
`get_tech_stack_scan`	Consulta uma varredura de stack tecnológica por `scanId` — retorna tecnologias detectadas com pontuações de confiança quando concluída
`start_trust_signals_scan`	Inicia análise assíncrona de sinais de confiança (34 sinais em prontidão empresarial, validação, prova social, autoridade, risco). Retorna `scanId`
`get_trust_signals_scan`	Consulta uma varredura de sinais de confiança por `scanId` — retorna vereditos por sinal e veredito por nível quando concluída
`start_agent_adoption_scan`	Inicia Verificação de Adoção de Agentes assíncrona (25 verificações: descobribilidade, acesso, legibilidade, endpoints de agentes). Retorna `scanId`
`get_agent_adoption_scan`	Consulta uma Verificação de Adoção de Agentes por `scanId` — retorna resultados completos quando concluída
`fetch_url`	Busca qualquer URL com renderização de JS e tratamento de proteção contra bots. Retorna corpo, cabeçalhos, cleanStats. `cleanHtml` opcional remove ruído para economia de custo de tokens de LLM. 60 req/min por chave de API

Todas as ferramentas paginadas aceitam os parâmetros page e limit. Verifique pagination.hasMore na resposta para buscar mais páginas.

Os painéis de Visibilidade de IA e Fontes de IA, os detalhes de verificação, o histórico de Visibilidade de IA e o painel de Tech & Trust respondem em uma visualização compacta por padrão: o mapa de mercado, a lista de páginas e a lista de marcas vêm uma página por vez, com sua própria linha — e, no mapa de mercado, a de cada concorrente rastreado — sempre na página e um objeto *Page (offset, limit, total, hasMore) informando quantas linhas existem. Passe view=full para todas as linhas em uma única resposta. Cada uma dessas respostas abre com readingGuide, as regras de leitura para seus campos.

As respostas passam diretamente da API da CompetLab sem alterações, e as instruções do servidor dizem ao seu agente como lê-las — acima de tudo, null significa que a CompetLab não mediu um valor, nunca zero ou "não".

Exemplos de Prompts

Depois de conectado, tente perguntar ao seu agente de IA:

"Quais empresas os modelos de IA recomendam na minha categoria — e eu sou uma delas?"
"Quais páginas o Perplexity e o Google AI Overviews leem para as perguntas dos meus compradores que mencionam meus concorrentes, mas não a mim?"
"O que mudou nas páginas de preços dos meus concorrentes esta semana?"
"Mostre-me o briefing estratégico — o que devo corrigir primeiro?"
"Quais tickets o briefing mais recente abriu e onde eles estão no nosso quadro?"
"Como o mapa de mercado de IA mudou nos últimos 3 meses?"
"Compare as estratégias de conteúdo em todos os meus concorrentes rastreados"
"Quais alertas críticos foram disparados nos últimos 7 dias?"
"Quais concorrentes têm melhores cabeçalhos de segurança do que nós?"
"Execute uma varredura de stack tecnológica em stripe.com — o que eles estão usando?"
"Quais assistentes de IA conseguem acessar openai.com, de acordo com o robots.txt?"
"Busque g2.com/some-listing com cleanHtml e resuma a página"

Veja examples/prompts.md para mais prompts organizados por caso de uso.

Autenticação

Obtendo uma chave de API

Cadastre-se em app.competlab.com/register (teste gratuito de 14 dias, sem cartão de crédito)
Vá para Configurações da Organização > Chaves de API
Crie uma nova chave — ela começa com cl_live_

Dois métodos de autenticação

Método	Quando usar	Exemplo
Cabeçalho `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 sem suporte a cabeçalhos personalizados	`?api_key=cl_live_...`

Uma chave de API cobre toda a sua organização. A maioria das ferramentas é somente leitura; as três ferramentas start_*_scan criam registros de varredura na sua conta (sem edições em dados existentes), e as cinco ferramentas de escrita de Tickets Estratégicos alteram o quadro do projeto — elas precisam de uma chave read_write, e uma chave read é recusada nelas. A ferramenta fetch_url tem limite de 60 req/min por chave de API (mais restrito que o padrão de 1000/min para outras ferramentas gratuitas).

Preços

O acesso ao MCP está incluído em toda assinatura da CompetLab ($99/mês). O teste gratuito inclui acesso completo ao MCP.

Solução de Problemas

Problema	Correção
Conexão recusada / tempo esgotado	Verifique se a URL é exatamente `https://mcp.competlab.com/mcp` sem barra final
Erro `api_key_missing`	Certifique-se de passar a chave como cabeçalho `CL-API-Key` (remoto) ou variável de ambiente `COMPETLAB_API_KEY` (stdio)
Erro `api_key_invalid`	As chaves devem começar com `cl_live_` e ter exatamente 40 caracteres
Transporte não suportado	Use o servidor HTTP remoto ou mude para o servidor stdio local

Suporte

Relatórios de bugs: GitHub Issues
E-mail: support@competlab.com
Documentação: competlab.com/developers

Licença

MIT (cobre documentação e configurações neste repositório) — veja LICENSE

O servidor MCP e a plataforma da CompetLab são software comercial. Veja competlab.com/terms-and-conditions.

Construído pela equipe da CompetLab. Inteligência competitiva para a era da IA.

CompetLab

Documentação

Servidor MCP CompetLab

Clientes Suportados

Início Rápido

Opção 1: Servidor Remoto (recomendado)

Claude Code

Cursor

VS Code

Windsurf

Cline

Claude Desktop / Claude Web

Opção 2: Servidor Local (stdio)

Claude Code

Claude Desktop

stdio genérico

O que é o CompetLab?

Ferramentas Disponíveis

Projetos e Concorrentes

Visibilidade em IA

Fontes de IA

Posicionamento

Inteligência de Preços

Inteligência de Conteúdo

Perfil de Tecnologia e Confiança

Briefing Estratégico

Tickets Estratégicos

Alertas e Agendamentos

Ferramentas Gratuitas (sem configuração de projeto necessária)

Exemplos de Prompts

Autenticação

Obtendo uma chave de API

Dois métodos de autenticação

Preços

Solução de Problemas

Links

Suporte

Licença