Watchr.ai

Conecte agentes de IA a inteligência competitiva em tempo real, lançamentos de produtos, atualizações de preços e insights de mercado.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP Watchr

Traga inteligência competitiva e monitoramento de marcas para o seu assistente de IA. Pergunte ao Claude, Cursor ou qualquer cliente compatível com MCP o que seus concorrentes fizeram esta semana. As respostas vêm direto do seu espaço de trabalho Watchr.

Watchr é uma plataforma de inteligência competitiva e monitoramento de marcas. Ela observa os sites, anúncios, posts em redes sociais, notícias e outras fontes dos seus concorrentes e, em seguida, qualifica cada sinal de acordo com um prompt que você define, para que o que você veja seja movimento relevante, não ruído.

Este repositório hospeda o servidor oficial Model Context Protocol (MCP) para Watchr. Ele expõe seus grupos de monitoramento, marcas rastreadas, insights validados e relatórios enviados para qualquer cliente compatível com MCP. Somente leitura.

O servidor é hospedado pela Watchr. Sem instalação local, sem Docker. Basta apontar seu cliente para https://mcp.watchr.ai/mcp e autenticar. Existem dois caminhos, dependendo do seu cliente:

OAuth com um clique para Claude (Desktop / Code), ChatGPT, Cursor e qualquer outro cliente que suporte Dynamic Client Registration. O navegador abre, você aprova, pronto.
Chave de API pessoal (gerada no seu espaço de trabalho Watchr) para frameworks de agentes e integrações personalizadas, onde você incorpora o MCP na sua própria stack de automação.

Sumário

O que você pode fazer com ele
Demonstração
Ferramentas disponíveis
Contrato de resposta de insights
Começando com Watchr
Autenticação
- Opção A. OAuth com um clique
- Opção B. Chave de API pessoal
Configuração
- Clientes OAuth
- Clientes com chave de API
Melhorando seus resultados
Suporte

O que você pode fazer com ele

Depois de conectado, você pode perguntar ao seu assistente de IA coisas como:

"O que nossos concorrentes lançaram esta semana?"
"Rascunhe uma mensagem para o Slack resumindo os 5 principais insights competitivos deste mês."
"Compare mudanças de posicionamento entre nossas marcas rastreadas nos últimos 30 dias."
"Monte um briefing competitivo de uma página sobre a HubSpot do último mês, deixe visual."
"Atualize automaticamente meus battle cards no Notion e as páginas de resumo dos concorrentes com os insights do Watchr desta semana."

O servidor MCP fornece os dados; seu assistente cuida do raciocínio, da redação e da integração com o resto do seu fluxo de trabalho.

Demonstração

Uma conversa curta com o Claude puxando os sinais mais recentes da HubSpot através do Watchr:

Chat with Claude using Watchr MCP

Os mesmos dados, um prompt de acompanhamento depois. O Claude gera um briefing competitivo projetado diretamente a partir dos insights validados do Watchr:

Designed competitive briefing artifact generated from Watchr data

Este é o ciclo principal. O Watchr coleta e qualifica. Seu cliente de IA raciocina e gera saídas. O servidor MCP é a ponte.

Ferramentas disponíveis

O servidor expõe seis ferramentas somente leitura:

Ferramenta	Finalidade
`list_monitoring_groups`	Lista todos os grupos de monitoramento (listas de observação) aos quais você tem acesso. Cada grupo reúne uma ou mais marcas rastreadas e um prompt de qualificação personalizado que define o que conta como relevante.
`list_brands`	Lista as marcas concorrentes rastreadas dentro de um grupo de monitoramento. Use para resolver nomes de marcas antes de pesquisar.
`search_insights`	Pesquisa insights validados com filtros (marca, intervalo de datas, tipo de fonte, texto livre). Retorna uma lista compacta projetada para decidir quais insights abrir.
`get_insight`	Busca o corpo completo de um único insight por ID: URL da fonte, conteúdo original, capturas de tela, justificativa de qualificação, datas e itens relacionados quando disponíveis.
`list_reports`	Lista relatórios que foram enviados de um grupo de monitoramento.
`get_report`	Busca o corpo completo de um único relatório: narrativa, insights incluídos, destinatários, data de envio.

Todos os endpoints são paginados e filtráveis. O servidor é somente leitura. Ele não pode criar, editar ou excluir nada no seu espaço de trabalho Watchr.

Contrato de resposta de insights

search_insights retorna um payload de descoberta compacto. Cada item inclui um id, um título, um resumo factual, metadados de fonte e marca, e um effective_date. O date_type que o acompanha indica se essa data efetiva é a data de publicação da fonte (published) ou a data de detecção do Watchr (detected). Mudanças em sites, portanto, permanecem datáveis com segurança, mesmo quando não têm data de publicação.

A resposta de pesquisa omite intencionalmente o description original, o qualification_analysis, datas brutas e related_items. Isso mantém as páginas de resultados pequenas o suficiente para que um cliente de IA possa classificar e pré-selecionar sem gastar sua janela de contexto com texto de fonte que talvez nunca use.

Quando o título ou resumo de um item não for claro o suficiente, chame get_insight com o id retornado como insight_id antes de responder. get_insight fornece a descrição da fonte, o raciocínio de qualificação, as datas publicada e detectada, e quaisquer insights validados relacionados. Os consumidores não devem inferir detalhes ausentes apenas do resumo compacto.

Quando disponível, competitive_signal_id identifica insights que o Watchr anexou ao mesmo movimento competitivo e pode ser usado como uma dica de deduplicação.

Começando com Watchr

Você precisa de um espaço de trabalho Watchr configurado antes que o servidor MCP tenha algo interessante para retornar. O caminho completo:

Crie uma conta em watchr.ai/signup. Um plano gratuito está disponível.
Finalize suas configurações em watchr.ai/app/settings:
- Adicione as marcas e concorrentes que deseja rastrear
- Especifique o mercado que está monitorando (usado para qualificar relevância)
- Assine os newsletters e feeds de imprensa que deseja incluir
- Adicione as páginas que deseja que o Watchr monitore quanto a mudanças (preços, changelog, carreiras, etc.)
- Adicione perfis de redes sociais para raspar (LinkedIn, Facebook, Instagram)
Aguarde seu primeiro relatório. O Watchr coleta, qualifica e monta o primeiro briefing automaticamente.
Conecte o servidor MCP (veja Autenticação e Configuração) e comece a consultar seus insights de qualquer cliente de IA.

Autenticação

O endpoint do servidor é sempre https://mcp.watchr.ai/mcp. Há duas maneiras de autenticar nele. Escolha a que seu cliente suporta.

Opção A. OAuth com um clique

OAuth 2.1 padrão com Dynamic Client Registration (RFC 7591) e PKCE. Seu cliente se auto-registra, abre uma janela do navegador, você autoriza o acesso do Watchr e os tokens são armazenados de forma transparente pelo cliente. Sem copiar/colar, sem rotação manual.

Clientes com suporte OAuth confirmado de fábrica:

Claude Desktop
Claude Code
ChatGPT (Custom Connectors em Plus / Pro / Team / Enterprise)
Cursor (versões recentes)

Se seu cliente está nesta lista, vá direto para Clientes OAuth. Não é necessária geração de chave.

Opção B. Chave de API pessoal

Para frameworks de agentes, integrações personalizadas, scripts, Windsurf, extensões do VS Code ou qualquer cliente que não suporte OAuth, o Watchr emite chaves de API de longa duração prefixadas com wat_mcp_.

Para gerar uma chave:

Entre em watchr.ai
Vá para Integrações → MCP no seu espaço de trabalho
Clique em Criar chave de API
Dê um nome descritivo (ex.: "Meu agente LangGraph", "Windsurf, notebook do trabalho"), opcionalmente defina uma data de expiração
Copie a chave imediatamente. O Watchr só exibe a chave completa uma vez. O painel armazena um prefixo e um hash, então uma chave perdida não pode ser recuperada (revogue e regenere).

Watchr API key generation interface

Passe a chave como um token Bearer em cada requisição:

Authorization: Bearer wat_mcp_<your-key>

A maioria dos clientes MCP permite declarar isso por meio de um campo headers na configuração. Exemplos em Clientes com chave de API.

Algumas notas sobre segurança:

Trate a chave como uma senha. Somente leitura não significa baixo risco: ela pode ver toda a sua inteligência competitiva.
Uma chave por dispositivo ou integração, nomeada claramente. Revogue e re-emita em Integrações → MCP se um notebook for perdido.
Defina uma data de expiração em chaves para CI ou ambientes compartilhados.
As chaves herdam o acesso da sua conta. Elas cobrem todos os grupos de monitoramento ativos na conta.

Ainda não tem uma conta Watchr? Crie uma gratuitamente.

Configuração

Clientes OAuth

Para todos os clientes abaixo, a URL do servidor é https://mcp.watchr.ai/mcp e a autenticação é acionada automaticamente na primeira conexão.

Claude Desktop

Edite claude_desktop_config.json (Configurações → Desenvolvedor → Editar Config):

{
  "mcpServers": {
    "watchr": { "url": "https://mcp.watchr.ai/mcp" }
  }
}

Reinicie o Claude Desktop. O Watchr aparece no painel de conectores. Clique nele para concluir o OAuth.

Claude Code

claude mcp add --transport http watchr https://mcp.watchr.ai/mcp

Depois execute /mcp dentro do Claude Code e clique em Autenticar ao lado de Watchr.

ChatGPT

Configurações → Conectores → Adicionar conector personalizado:

URL do servidor MCP: https://mcp.watchr.ai/mcp
Autenticação: OAuth

O ChatGPT aciona o fluxo OAuth no primeiro uso.

Cursor

Configurações → MCP → Adicionar novo servidor MCP:

{
  "watchr": { "url": "https://mcp.watchr.ai/mcp" }
}

Clientes com chave de API

Primeiro gere uma chave de API, depois passe-a como um token Bearer na configuração do cliente.

Windsurf

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

{
  "mcpServers": {
    "watchr": {
      "serverUrl": "https://mcp.watchr.ai/mcp",
      "headers": { "Authorization": "Bearer wat_mcp_<your-key>" }
    }
  }
}

VS Code

Adicione em .vscode/mcp.json (ou configurações do usuário):

{
  "servers": {
    "watchr": {
      "type": "http",
      "url": "https://mcp.watchr.ai/mcp",
      "headers": { "Authorization": "Bearer wat_mcp_<your-key>" }
    }
  }
}

Cursor (sem OAuth)

Mesma estrutura JSON da versão OAuth com um bloco headers adicionado:

{
  "watchr": {
    "url": "https://mcp.watchr.ai/mcp",
    "headers": { "Authorization": "Bearer wat_mcp_<your-key>" }
  }
}

Frameworks de agentes personalizados

LangGraph, CrewAI, Mastra, n8n, agentes Python ou TypeScript personalizados, etc. Conecte-se a https://mcp.watchr.ai/mcp via HTTP streamable e anexe o cabeçalho Authorization: Bearer wat_mcp_<your-key> a cada requisição. Qualquer SDK compatível com MCP funciona.

Melhorando seus resultados

Se seu assistente disser que "não há insights relevantes" ou retornar resultados fracos, os dados estão a montante no seu espaço de trabalho Watchr. Deixe o Watchr mais inteligente e o MCP fica mais inteligente:

Adicione páginas monitoradas (preços de concorrentes, changelog, carreiras, páginas de produto)
Complete os perfis sociais adicionando handles do LinkedIn, Facebook e Instagram para cada marca rastreada
Refine o prompt de qualificação no nível do grupo de monitoramento. Ele decide o que conta como "relevante". Aperte (temas mais específicos que você se importa) ou amplie (capture mais) com base no que está passando.
Adicione mais fontes de notícias e imprensa. Quanto mais fontes, maior a densidade de sinal.

Tudo é configurável em watchr.ai/app/settings.

Suporte

Relatórios de bugs e solicitações de recursos: abra uma issue neste repositório
Perguntas gerais e feedback: contact@watchr.ai
Status e disponibilidade: o endpoint MCP compartilha o status com a plataforma principal do Watchr

Construído pela equipe Watchr. Licença MIT.